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.