Elemento de metadatos HTML <meta>
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
* Some parts of this feature may have varying levels of support.
El elemento <meta> de HTML representa metadatos que no pueden representarse mediante otros elementos relacionados con metadatos, como <base>, <link>, <script>, <style> o <title>.
El elemento <meta> puede proporcionar los siguientes tipos de metadatos:
- Si se establece el atributo
name, el elemento<meta>proporciona metadatos a nivel de documento que se aplican a toda la página. - Si se establece el atributo
http-equiv, el elemento<meta>actúa como una directiva pragma para simular directivas que de otro modo se indicarían mediante un encabezado HTTP. - Si se establece el atributo
charset, el elemento<meta>es una declaración de charset que indica la codificación de caracteres en la que está codificado el documento. - Si se establece el atributo
itemprop, el elemento<meta>proporciona metadatos definidos por el usuario.
Atributos
Este elemento incluye los atributos globales.
Nota:
El atributo name tiene un significado específico para el elemento <meta>.
El atributo itemprop no debe establecerse en un elemento <meta> que incluya un atributo name, http-equiv o charset.
charset-
Este atributo declara la codificación de caracteres del documento. Si el atributo está presente, su valor debe coincidir, sin distinguir mayúsculas de minúsculas (ASCII), con la cadena
"utf-8", ya que UTF-8 es la única codificación válida para los documentos HTML5. Los elementos<meta>que declaran una codificación de caracteres deben ubicarse por completo dentro de los primeros 1024 bytes del documento. content-
Este atributo contiene el valor para el atributo
http-equivoname, según cuál se utilice. http-equiv-
Define una directiva pragma, es decir, instrucciones para que el navegador procese el documento. El nombre del atributo es la abreviatura de
http-equivalent, ya que los valores permitidos son nombres de cabeceras HTTP equivalentes. media-
El atributo
mediadefine a qué medios se debe aplicar el color del tema definido en el atributocontent. Su valor es una consulta de medios que, si el atributo no está presente, toma el valorallde forma predeterminada. Este atributo solo es relevante cuando el atributonamedel elemento tiene el valortheme-color. En cualquier otro caso, no tiene efecto y no debe incluirse. name-
Los atributos
nameycontentpueden usarse juntos para proporcionar metadatos del documento como pares nombre-valor: el atributonameindica el nombre del metadato y el atributocontentindica su valor.
Ejemplos
Establecer una descripción meta
La siguiente etiqueta <meta> proporciona una description como metadato para la página web:
<meta
name="description"
content="La referencia de HTML describe todos los elementos y atributos de HTML, incluidos los atributos globales que se aplican a todos los elementos." />
Establecer una redirección de página
El siguiente ejemplo utiliza http-equiv="refresh" para indicarle al navegador que realice una redirección.
El atributo content="3;url=https://www.mozilla.org" redirigirá la página a https://www.mozilla.org después de 3 segundos:
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />
Resumen técnico
| Categorías de contenido |
Contenido de metadatos. Si está presente el atributo itemprop:
Contenido de flujo,
Contenido de frase.
|
|---|---|
| Contenido permitido | Ninguno; es un elemento vacío. |
| Omisión de etiquetas | Debe tener una etiqueta de apertura y no debe tener etiqueta de cierre. |
| Padres permitidos |
|
| Rol ARIA implícito | Sin rol correspondiente |
| Roles ARIA permitidos | Ningún role permitido |
| Interfaz DOM | HTMLMetaElement |
Especificaciones
| Specification |
|---|
| HTML # the-meta-element |