Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

:dir() — pseudoclasse di direzionalità

La pseudoclasse :dir() seleziona gli elementi in base alla direzionalità stabilita dalle regole HTML, non dalla proprietà CSS direction. Distingue ltr da rtl e tiene conto dell’ereditarietà e di dir="auto".

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

Sintassi

:dir(ltr)
:dir(rtl)

:dir() corrisponde a un elemento in base alla sua direzionalità semantica. :dir(ltr) indica una direzione da sinistra a destra, mentre :dir(rtl) indica una direzione da destra a sinistra. In HTML, la direzionalità segue le regole del documento, compresi l’attributo dir, l’ereditarietà e il rilevamento automatico della direzione.

Il selettore [dir="rtl"] controlla solo l’attributo dell’elemento stesso. Al contrario, :dir(rtl) può corrispondere anche a un discendente privo di quell’attributo. Con dir="auto", l’elemento corrisponde a :dir(ltr) oppure a :dir(rtl) in base alla direzionalità determinata; :dir(auto) non seleziona questi elementi.

L’argomento deve essere un singolo identificatore, non una stringa né un elenco. Sono consentiti spazi bianchi intorno all’argomento. In HTML, l’argomento viene confrontato con le parole chiave ltr e rtl senza distinguere tra maiuscole e minuscole ASCII. Di conseguenza, :dir(RTL) seleziona gli stessi elementi di :dir(rtl). Gli identificatori che non corrispondono a nessuna delle due parole chiave secondo questo confronto sono sintatticamente validi, ma non selezionano alcun elemento. :dir() vuoto non è valido.

La proprietà CSS direction non influisce sulla corrispondenza. L’esempio distingue ereditarietà, dir="auto" e stile: styled continua a corrispondere a :dir(ltr) nonostante direction: rtl.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti