Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła