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.