Etiqueta HTML <html>
La etiqueta <html> define un documento escrito en HTML e incluye todos los elementos básicos de un documento HTML.
La etiqueta <html> es el elemento raíz de un documento HTML — se sitúa en la cima del árbol del documento y envuelve a todos los demás elementos de la página. "Raíz" significa que no tiene elemento padre: cuando el navegador analiza tu página y construye el DOM (Document Object Model, el árbol de nodos que crea en memoria), el elemento <html> es el único nodo del que descienden todos los demás. Como todo vive dentro de él, la etiqueta <html> es también donde se establecen los atributos globales de la página, como el idioma y la dirección del texto.
Lo único que puede aparecer antes de <html> es la declaración <!DOCTYPE>, que indica al navegador qué versión de HTML utiliza el documento y lo pone en modo estándar.
El elemento <html> tiene exactamente dos hijos directos, y deben aparecer en este orden:
- La etiqueta
<head>, que contiene metadatos para el navegador y los motores de búsqueda — las etiquetas<title>,<link>,<script>y similares. Nada dentro de<head>se muestra directamente en la página. - La etiqueta
<body>, que contiene todo lo que el visitante realmente ve: texto, imágenes, enlaces, etc.
Establece siempre el atributo lang en <html>. Le indica al navegador, a los motores de búsqueda y a las tecnologías de asistencia en qué idioma está escrita la página. Esto mejora la indexación, ayuda a los navegadores a elegir las fuentes y la representación correctas para caracteres nacionales, y permite a los lectores de pantalla seleccionar la pronunciación y la voz adecuadas.
Etiqueta HTML <html> con el atributo "lang"
<html lang="en">El atributo lang
El valor de lang es una etiqueta de idioma BCP 47 — un código breve y estandarizado para un idioma humano. La forma más común es una subtiqueta de idioma de dos letras (de la norma ISO 639), seguida opcionalmente de una subtiqueta de región o escritura separada por un guión.
<html lang="en"> <!-- English -->
<html lang="en-US"> <!-- English, United States -->
<html lang="fr"> <!-- French -->
<html lang="de"> <!-- German -->
<html lang="zh-Hans"> <!-- Chinese, Simplified script -->
<html lang="zh-Hant"> <!-- Chinese, Traditional script -->
<html lang="ar"> <!-- Arabic -->Establece lang una vez en <html> para declarar el idioma principal del documento. Si una sección de la página está en un idioma diferente, puedes sobrescribirlo en cualquier elemento interno (por ejemplo, <p lang="fr">).
El atributo dir
El atributo dir establece la dirección del texto base del documento. Es esencial para los idiomas que se leen de derecha a izquierda, como el árabe y el hebreo.
| Valor | Significado |
|---|---|
ltr | De izquierda a derecha (el valor por defecto; usado para inglés, francés, etc.) |
rtl | De derecha a izquierda (usado para árabe, hebreo, persa) |
auto | Dejar que el navegador decida según el contenido |
<html lang="ar" dir="rtl">Establecer dir="rtl" en <html> invierte la alineación predeterminada de la página para que el texto, las barras de desplazamiento y muchas características de diseño se reflejen correctamente en los sistemas de escritura de derecha a izquierda.
Sintaxis
La etiqueta <html> se usa en pares. Todo el contenido de la página se escribe entre la etiqueta de apertura <html> y la etiqueta de cierre </html>.
En HTML5 la etiqueta de cierre </html> es técnicamente opcional — el analizador puede inferir el fin del documento. Sin embargo, siempre debes incluirla. Un </html> explícito mantiene la estructura del documento clara, evita sorpresas cuando la página es procesada por herramientas, y es necesario si la página se sirve como XHTML.
Ejemplo de la etiqueta HTML <html>:
Etiqueta HTML <html>
<!DOCTYPE html>
<html lang="en">
<head>
<title>Title of the document</title>
</head>
<body>
The content of the page
</body>
</html>Edita el ejemplo anterior en el editor y ejecútalo para ver el resultado en tu navegador.
Atributos
| Atributo | Valor | Descripción |
|---|---|---|
| lang | Etiqueta de idioma BCP 47 | Declara el idioma principal del documento (por ejemplo en, fr, zh-Hans). Recomendado en todas las páginas por accesibilidad y SEO. |
| dir | ltr / rtl / auto | Establece la dirección del texto base. Usa rtl para idiomas de derecha a izquierda como el árabe y el hebreo. |
| id | texto | Asigna un identificador único al elemento, usado principalmente como punto de enganche para CSS o scripts. |
| xmlns | https://www.w3.org/1999/xhtml | Espacio de nombres XML para el documento. Solo es necesario para XHTML; se ignora cuando la página se sirve como text/html, por lo que no se necesita en HTML5. |
| manifest | URL | Apuntaba a un manifiesto de caché de aplicación para visualización sin conexión. Obsoleto — eliminado del estándar; usa service workers en su lugar. |
Los atributos lang, dir e id mencionados anteriormente son los más utilizados, y <html> también acepta el conjunto completo de Atributos Globales y Atributos de Evento.