Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

:dir() — pseudotřída směrovosti

Pseudotřída :dir() vybírá prvky podle směrovosti určené pravidly HTML, nikoli podle vlastnosti CSS direction. Rozlišuje ltr a rtl a zohledňuje dědičnost i dir="auto".

Verze: 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() odpovídá prvku podle jeho sémantické směrovosti. :dir(ltr) označuje směr zleva doprava, zatímco :dir(rtl) označuje směr zprava doleva. V HTML se směrovost řídí pravidly dokumentu, včetně atributu dir, dědičnosti a automatického určení směru.

Selektor [dir="rtl"] kontroluje pouze atribut na samotném prvku. Naproti tomu :dir(rtl) může odpovídat také potomkovi, který tento atribut nemá. Při dir="auto" prvek podle určené směrovosti odpovídá :dir(ltr) nebo :dir(rtl); :dir(auto) takové prvky nevybírá.

Argument musí být jediný identifikátor, nikoli řetězec nebo seznam. Bílé znaky kolem něj jsou povolené. V HTML se při porovnávání argumentu s klíčovými slovy ltr a rtl nerozlišují velká a malá písmena ASCII, takže :dir(RTL) vybírá stejné prvky jako :dir(rtl). Identifikátory, které se při tomto porovnání neshodují ani s jedním z těchto klíčových slov, jsou syntakticky platné, ale nevybírají žádné prvky. Prázdné :dir() je neplatné.

Vlastnost CSS direction nemá na shodu vliv. Příklad rozlišuje dědičnost, dir="auto" a stylování: styled stále odpovídá :dir(ltr), přestože má direction: rtl.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje