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

CKTIS / CSS

:dir() — pseudoclasse de direcionalidade

A pseudoclasse :dir() seleciona elementos segundo a direcionalidade definida pelas regras HTML, e não pela propriedade CSS direction. Distingue ltr de rtl e tem em conta a herança e dir="auto".

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

:dir(ltr)
:dir(rtl)

:dir() corresponde a um elemento segundo a sua direcionalidade semântica. :dir(ltr) indica uma direção da esquerda para a direita, enquanto :dir(rtl) indica uma direção da direita para a esquerda. Em HTML, a direcionalidade segue as regras do documento, incluindo o atributo dir, a herança e a deteção automática da direção.

O seletor [dir="rtl"] verifica apenas o atributo do próprio elemento. Em contrapartida, :dir(rtl) também pode corresponder a um descendente sem esse atributo. Com dir="auto", o elemento corresponde a :dir(ltr) ou a :dir(rtl), consoante a direcionalidade determinada; :dir(auto) não seleciona esses elementos.

O argumento tem de ser um único identificador, não uma cadeia de caracteres nem uma lista. São permitidos espaços em branco à sua volta. Em HTML, a comparação do argumento com as palavras-chave ltr e rtl não distingue maiúsculas de minúsculas ASCII. Assim, :dir(RTL) seleciona os mesmos elementos que :dir(rtl). Os identificadores que não correspondem a nenhuma das duas palavras-chave nessa comparação são sintaticamente válidos, mas não selecionam qualquer elemento. :dir() vazio é inválido.

A propriedade CSS direction não afeta a correspondência. O exemplo distingue herança, dir="auto" e estilo: styled continua a corresponder a :dir(ltr), apesar de direction: rtl.

Exemplos

<!doctype html>
<html lang="en" dir="ltr">
<meta charset="utf-8">
<title>:dir() example</title>
<style>
  .sample:dir(ltr) { border-left: 4px solid blue; }
  .sample:dir(rtl) { border-right: 4px solid green; }
</style>
<div dir="rtl">
  <p id="inherited" class="sample">Hello</p>
</div>
<p id="automatic" class="sample" dir="auto">שלום</p>
<p id="styled" class="sample" dir="ltr" style="direction: rtl">Hello</p>
<pre id="result"></pre>
<script>
  const lines = Array.from(document.querySelectorAll('.sample'), element =>
    `${element.id}: ${element.matches(':dir(rtl)') ? 'rtl' : 'ltr'}`
  );
  lines.push(`explicit rtl: ${document.querySelectorAll('.sample[dir="rtl"]').length}`);
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Resultado

inherited: rtl
automatic: rtl
styled: ltr
explicit rtl: 0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes