CKTIS / HTML
termin lub wartość HTML: dir
Atrybut `dir` ustala bazowy kierunek tekstu zgodnie z semantyką treści, dzięki czemu algorytm dwukierunkowy poprawnie układa znaki, liczby i interpunkcję.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<p dir="auto">…</p>dir jest atrybutem wyliczeniowym: ltr wybiera kierunek od lewej, rtl od prawej, a auto wyznacza kierunek na podstawie pierwszego silnego znaku tekstu. Kierunek jest dziedziczony, o ile szczególne reguły elementu nie ustanawiają granicy.
Wartość auto nadaje się do treści nieznanego języka, lecz początkowe liczby i znaki neutralne nie rozstrzygają kierunku. Gdy obcy fragment jest wstawiany w otaczające zdanie, element bdi izoluje jego dwukierunkowy wpływ od sąsiedniego tekstu.
Nie używaj wyrównania jako zamiennika kierunku pisma. Semantyczny atrybut HTML wpływa na przetwarzanie tekstu, formularze i kopiowanie, podczas gdy sama właściwość CSS direction opisuje prezentację i powinna być zarezerwowana dla wyjątków stylu.
Przykład ma dir="auto" i zaczyna się silnym znakiem arabskim; getComputedStyle() zgłasza rtl. Wynik pokazuje rozstrzygnięcie algorytmu, a nie jedynie obecność tekstu pisanego od prawej.
Przykłady
<!doctype html><meta charset="utf-8"><p id="x" dir="auto">مرحبا HTML</p><output id="result"></output><script>result.textContent=`attribute=${x.dir}; computed=${getComputedStyle(x).direction}`;</script>Wynik
attribute=auto; computed=rtl
Wykonany przykład potwierdza automatyczne wyznaczenie bazowego kierunku dla treści zaczynającej się od silnego znaku RTL.