CKTIS / HTML
término o valor HTML: lang
El atributo `lang` declara el idioma natural de un elemento y su contenido para que navegadores y tecnologías de asistencia elijan pronunciación y reglas tipográficas adecuadas.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<article lang="fr">…</article>Un valor lang no vacío debe ser una etiqueta lingüística BCP 47 válida como fr o pt-PT; el valor vacío solo está permitido para un idioma explícitamente desconocido. La ausencia hereda el idioma del antecesor.
En un documento HTML, lang="" declara el idioma desconocido; la serialización XML usa xml:lang y, si aparecen ambos atributos, sus valores deben coincidir sin distinguir mayúsculas ASCII. Establezca el idioma predeterminado en la raíz y sustitúyalo solo en pasajes de otro idioma.
El idioma influye, entre otras cosas, en la pronunciación del lector de pantalla, ortografía, división de palabras y comillas. El selector :lang() considera el idioma heredado, mientras [lang] solo encuentra elementos con atributo propio.
En el ejemplo, x.lang devuelve "" porque el párrafo no tiene atributo propio; closest("[lang]") encuentra el fr heredado y document.documentElement.lang muestra la ausencia en la raíz. Distingue reflexión e idioma efectivo.
Ejemplos
<!doctype html><meta charset="utf-8"><article id="a" lang="fr"><p id="x">Bonjour</p></article><output id="result"></output><script>result.textContent=`own=${x.lang}; inheritedFrom=${x.closest("[lang]").lang}; document=${document.documentElement.lang}`;</script>Resultado
own=; inheritedFrom=fr; document=
El ejemplo ejecutado verifica que la propiedad IDL solo refleja el atributo propio aunque el contenido herede el idioma del antecesor más próximo.