CKTIS / CSS
:dir() — pseudoklasa kierunkowości
Pseudoklasa :dir() wybiera elementy według kierunkowości ustalonej przez reguły HTML, a nie przez właściwość CSS direction. Rozróżnia kierunki ltr i rtl oraz uwzględnia dziedziczenie i dir="auto".
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
:dir(ltr)
:dir(rtl):dir() dopasowuje element według jego semantycznej kierunkowości. :dir(ltr) oznacza kierunek od lewej do prawej, a :dir(rtl) — od prawej do lewej. W HTML kierunkowość wynika z reguł dokumentu, w tym atrybutu dir, dziedziczenia oraz automatycznego ustalania kierunku.
Selektor [dir="rtl"] sprawdza tylko atrybut na samym elemencie. Natomiast :dir(rtl) może dopasować także potomka bez tego atrybutu. Przy dir="auto" element pasuje do :dir(ltr) albo :dir(rtl) zależnie od ustalonej kierunkowości; :dir(auto) nie wybiera takich elementów.
Argument musi być pojedynczym identyfikatorem, nie napisem ani listą. Białe znaki wokół niego są dozwolone. W HTML przy porównywaniu argumentu ze słowami kluczowymi ltr i rtl nie rozróżnia się wielkich i małych liter ASCII, więc :dir(RTL) dopasowuje te same elementy co :dir(rtl). Identyfikatory, które przy takim porównaniu nie odpowiadają żadnemu z tych słów kluczowych, są poprawne składniowo, lecz niczego nie dopasowują. Puste :dir() jest niepoprawne.
Właściwość CSS direction nie wpływa na dopasowanie. Przykład rozdziela dziedziczenie, dir="auto" i stylowanie: styled nadal pasuje do :dir(ltr), mimo direction: rtl.
Przykłady
<!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>Wynik
inherited: rtl automatic: rtl styled: ltr explicit rtl: 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.