Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

conceito HTML: language-and-direction

O idioma do conteúdo e a direção base do texto são propriedades semânticas herdadas distintas, usadas para pronúncia, hifenização, escolha de glifos e algoritmo bidirecional Unicode.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

language metadata + Unicode bidirectional base direction

O atributo lang tem de conter uma etiqueta BCP 47 válida ou o valor vazio quando o idioma é desconhecido, e é herdado. Se a sintaxe XML também fornecer xml:lang, os valores têm de coincidir sem distinguir caixa ASCII; o seletor :lang() considera o idioma herdado.

O atributo dir tem os estados ltr, rtl e auto. Os dois primeiros definem explicitamente a direção base, enquanto auto a deriva do primeiro caráter forte segundo as regras do elemento; algarismos e pontuação neutra não a decidem.

O elemento bdi isola do ambiente um fragmento de direção desconhecida, enquanto bdo substitui o algoritmo e exige dir explícito. A direção CSS não substitui metadados semânticos e nomes ou títulos dinâmicos devem ser isolados para não reordenarem a pontuação vizinha.

O exemplo testa o idioma herdado com :lang(ar), a direção herdada e dois parágrafos com dir="auto". Um primeiro caráter latino forte produz esquerda-direita e um árabe forte direita-esquerda.

Exemplos

<!doctype html>
<meta charset="utf-8">
<div lang="ar" dir="rtl"><span id="child">مرحبا</span></div>
<p id="latin" dir="auto">42 English العربية</p>
<p id="arabic" dir="auto">42 العربية English</p>
<output id="result"></output>
<script>
const child = document.querySelector("#child");
const latin = document.querySelector("#latin");
const arabic = document.querySelector("#arabic");
result.textContent = `inheritsLang=${child.matches(":lang(ar)")}; inheritedDir=${getComputedStyle(child).direction}; autoLatin=${getComputedStyle(latin).direction}; autoArabic=${getComputedStyle(arabic).direction}`;
</script>

Resultado

inheritsLang=true; inheritedDir=rtl; autoLatin=ltr; autoArabic=rtl

O exemplo executado confirma herança e deteção do primeiro caráter forte; não testa a pronúncia de um leitor de ecrã específico nem cada regra do algoritmo bidirecional Unicode.

Fontes