CKTIS / CSS
:dir() — pseudoklasse voor tekstrichting
De pseudoklasse :dir() selecteert elementen op basis van de tekstrichting die volgens HTML-regels is vastgesteld, niet op basis van de CSS-eigenschap direction. Ze onderscheidt ltr van rtl en houdt rekening met overerving en dir="auto".
Versie: 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() komt overeen met een element op basis van de semantische tekstrichting. :dir(ltr) staat voor een richting van links naar rechts, en :dir(rtl) voor een richting van rechts naar links. In HTML volgt de tekstrichting de documentregels, waaronder het dir-attribuut, overerving en automatische richtingsdetectie.
De selector [dir="rtl"] controleert alleen het attribuut op het element zelf. :dir(rtl) kan daarentegen ook overeenkomen met een afstammeling zonder dat attribuut. Met dir="auto" komt het element, afhankelijk van de vastgestelde tekstrichting, overeen met :dir(ltr) of :dir(rtl); :dir(auto) selecteert zulke elementen niet.
Het argument moet één identifier zijn, geen tekenreeks of lijst. Witruimte eromheen is toegestaan. In HTML wordt bij het vergelijken van het argument met de trefwoorden ltr en rtl geen onderscheid gemaakt tussen ASCII-hoofdletters en -kleine letters. Daardoor selecteert :dir(RTL) dezelfde elementen als :dir(rtl). Identifiers die bij deze vergelijking met geen van beide trefwoorden overeenkomen, zijn syntactisch geldig, maar selecteren geen elementen. Een lege :dir() is ongeldig.
De CSS-eigenschap direction heeft geen invloed op de overeenkomst. Het voorbeeld maakt onderscheid tussen overerving, dir="auto" en styling: styled komt nog steeds overeen met :dir(ltr), ondanks direction: rtl.
Voorbeelden
<!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>Resultaat
inherited: rtl automatic: rtl styled: ltr explicit rtl: 0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.