CKTIS / CSS
:dir() — Pseudoklasse für Schreibrichtung
Die Pseudoklasse :dir() wählt Elemente anhand der nach HTML-Regeln bestimmten Schreibrichtung aus, nicht anhand der CSS-Eigenschaft direction. Sie unterscheidet ltr und rtl und berücksichtigt Vererbung sowie dir="auto".
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
:dir(ltr)
:dir(rtl):dir() trifft auf ein Element anhand seiner semantischen Schreibrichtung zu. :dir(ltr) bezeichnet die Schreibrichtung von links nach rechts, :dir(rtl) die von rechts nach links. In HTML ergibt sich die Schreibrichtung aus den Dokumentregeln, darunter dem Attribut dir, der Vererbung und der automatischen Richtungserkennung.
Der Selektor [dir="rtl"] prüft nur das Attribut am Element selbst. Im Gegensatz dazu kann :dir(rtl) auch auf ein Nachfahrenelement ohne dieses Attribut zutreffen. Mit dir="auto" passt das Element je nach ermittelter Schreibrichtung auf :dir(ltr) oder :dir(rtl); :dir(auto) wählt solche Elemente nicht aus.
Das Argument muss ein einzelner Bezeichner sein, kein String und keine Liste. Leerraum darum herum ist zulässig. In HTML wird beim Vergleich des Arguments mit den Schlüsselwörtern ltr und rtl nicht zwischen ASCII-Groß- und -Kleinbuchstaben unterschieden. Daher wählt :dir(RTL) dieselben Elemente aus wie :dir(rtl). Bezeichner, die bei diesem Vergleich mit keinem der beiden Schlüsselwörter übereinstimmen, sind syntaktisch gültig, wählen aber keine Elemente aus. Ein leeres :dir() ist ungültig.
Die CSS-Eigenschaft direction beeinflusst die Übereinstimmung nicht. Das Beispiel unterscheidet Vererbung, dir="auto" und Styling: styled trifft weiterhin auf :dir(ltr) zu, obwohl direction: rtl gesetzt ist.
Beispiele
<!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>Ergebnis
inherited: rtl automatic: rtl styled: ltr explicit rtl: 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.