CKTIS / HTML
termo ou valor HTML: lang
O atributo `lang` declara o idioma natural de um elemento e do seu conteúdo para que navegadores e tecnologias de apoio escolham pronúncia e regras tipográficas adequadas.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<article lang="fr">…</article>Um valor lang não vazio tem de ser uma etiqueta linguística BCP 47 válida, como fr ou pt-PT; o valor vazio só é permitido para um idioma explicitamente desconhecido. A ausência herda o idioma de um antepassado.
Num documento HTML, lang="" declara o idioma desconhecido; a serialização XML usa xml:lang e, quando ambos os atributos aparecem, os valores têm de coincidir sem distinguir maiúsculas e minúsculas ASCII. Define o idioma predefinido na raiz e substitui-o apenas em passagens noutro idioma.
O idioma influencia, entre outros aspetos, a pronúncia do leitor de ecrã, ortografia, hifenização e aspas. O seletor :lang() considera o idioma herdado, enquanto [lang] encontra apenas elementos com atributo próprio.
No exemplo, x.lang devolve "" porque o parágrafo não tem atributo próprio; closest("[lang]") encontra o fr herdado e document.documentElement.lang mostra a ausência na raiz. Distingue reflexão e idioma efetivo.
Exemplos
<!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=
O exemplo executado verifica que a propriedade IDL reflete apenas o atributo próprio, embora o conteúdo herde o idioma do antepassado mais próximo.