Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:dir() — pseudo-classe de directionnalité

La pseudo-classe :dir() sélectionne les éléments selon la directionnalité définie par les règles HTML, et non selon la propriété CSS direction. Elle distingue ltr de rtl et tient compte de l’héritage et de dir="auto".

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

Syntaxe

:dir(ltr)
:dir(rtl)

:dir() correspond à un élément selon sa directionnalité sémantique. :dir(ltr) désigne une direction de gauche à droite, tandis que :dir(rtl) désigne une direction de droite à gauche. En HTML, la directionnalité suit les règles du document, notamment l’attribut dir, l’héritage et la détection automatique de la direction.

Le sélecteur [dir="rtl"] vérifie uniquement l’attribut de l’élément lui-même. En revanche, :dir(rtl) peut aussi correspondre à un descendant qui ne possède pas cet attribut. Avec dir="auto", l’élément correspond à :dir(ltr) ou à :dir(rtl), selon la directionnalité déterminée ; :dir(auto) ne sélectionne pas ces éléments.

L’argument doit être un identifiant unique, et non une chaîne de caractères ni une liste. Les espaces qui l’entourent sont autorisés. En HTML, la comparaison de l’argument avec les mots-clés ltr et rtl ne distingue pas les majuscules des minuscules ASCII. Ainsi, :dir(RTL) sélectionne les mêmes éléments que :dir(rtl). Les identifiants qui ne correspondent à aucun de ces mots-clés selon cette comparaison sont syntaxiquement valides, mais ne sélectionnent aucun élément. :dir() sans argument est invalide.

La propriété CSS direction n’a pas d’effet sur la correspondance. L’exemple distingue l’héritage, dir="auto" et le style : styled correspond toujours à :dir(ltr), malgré direction: rtl.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources