Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

dirname: przesyłanie kierunku tekstu

Wyślij dodatkowe pole kierunku bez zmiany nazwy pola tekstowego.

Wersja: HTML Living Standard

Składnia

<input name="comment" dirname="comment.dir" dir="auto">

Na obsługiwanych kontrolkach tekstowych dirname podaje niepustą nazwę dodatkowej pozycji formularza zawierającej kierunek. Przesyłana wartość to ltr lub rtl. Atrybut nie zmienia nazwy pola tekstu, nie wybiera katalogu ani nie tłumaczy wartości. Użyj odrębnej nazwy pola pomocniczego, aby uniknąć kolizji na serwerze.

Kierunek wynika z reguł kierunkowości, w tym jawnego ustawienia albo automatycznego wykrywania. Sam atrybut go nie ustawia. Wyłączona lub inaczej pominięta kontrolka nie zaczyna magicznie przesyłać przydatnego tekstu. Traktuj tekst i kierunek jako dane klienta wymagające sprawdzenia na serwerze.

Przykład ustawia tekst arabski, a potem łaciński w polu z automatycznym kierunkiem. FormData zawiera najpierw kierunek od prawej do lewej, potem od lewej do prawej. Sprawdza to prawdziwą serializację formularza, nie zgadywanie kierunku z nazwy atrybutu.

Przykłady

<!doctype html><meta charset="utf-8">
<form id="form"><label>Comment <input id="comment" name="comment" dirname="comment.dir" dir="auto"></label></form><output id="result"></output>
<script>
const form = document.querySelector('#form'), field = document.querySelector('#comment');
field.value = 'مرحبا'; const first = new FormData(form).get('comment.dir');
field.value = 'Hello'; const second = new FormData(form).get('comment.dir');
document.querySelector('#result').textContent = 'Arabic=' + first + '; Latin=' + second;
</script>

Wynik

Arabic=rtl; Latin=ltr

Pole tekstowe zachowuje osobną nazwę; sprawdzana jest wyłącznie dodatkowa wartość kierunku.

Źródła