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

CKTIS / HTML

termo ou valor HTML: dir

O atributo `dir` define a direção base semântica para que o algoritmo bidirecional ordene corretamente carateres, números e pontuação.

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

Sintaxe

<p dir="auto">…</p>

dir é enumerado: ltr escolhe esquerda para direita, rtl direita para esquerda e auto deduz a direção do primeiro caráter forte. A direção é herdada, salvo se uma regra própria do elemento estabelecer uma fronteira.

Usa auto para conteúdo de idioma ou direção desconhecida, mas números iniciais e pontuação neutra não decidem o resultado. Numa frase envolvente, o elemento bdi isola do texto adjacente a influência bidirecional de um fragmento desconhecido.

Não uses alinhamento como substituto da direção da escrita. O atributo HTML semântico afeta processamento de texto, controlos e cópia, enquanto a propriedade CSS direction é de apresentação e deve ficar reservada a exceções de estilo.

O exemplo usa dir="auto" e começa com um caráter árabe forte; getComputedStyle() apresenta rtl. O resultado demonstra o algoritmo de direcionalidade, não uma simples deteção de texto da direita para a esquerda.

Exemplos

<!doctype html><meta charset="utf-8"><p id="x" dir="auto">مرحبا HTML</p><output id="result"></output><script>result.textContent=`attribute=${x.dir}; computed=${getComputedStyle(x).direction}`;</script>

Resultado

attribute=auto; computed=rtl

O exemplo executado verifica a resolução automática da direção base para conteúdo iniciado por um caráter RTL forte.

Fontes