Атрибут HTML: dirname

Атрибут dirname может быть использован для элемента <textarea> и нескольких типов элементов <input> и описывает направленность текстового содержимого элемента во время отправки формы. Браузер использует значение этого атрибута, чтобы определить, ориентирован ли введённый пользователем текст слева направо или справа налево. При использовании значение направленности текста элемента включается в данные отправки формы вместе со значением атрибута dirname в качестве имени поля.

Атрибут dirname может быть использован для любого элемента <textarea> или любого элемента <input> типа hidden, text, search, tel, url, email, password, submit, reset или button.

Формат отправляемых данных — {dirname_value}={direction}, где {dirname_value} — значение атрибута dirname, а {direction} — направленность текста. Например, если пользователь введёт "Hello" в элементе с атрибутами name="comment" и dirname="comment-direction", данные отправки формы в формате URL для запросов GET будут comment=Hello&comment-direction=ltr. Направленность может быть одной из следующих:

rtl

Введённый пользователем текст имеет направление письма справа налево.

ltr

Введённый пользователем текст имеет направление письма слева направо.

Если направленность текста не указана, пользовательский агент будет использовать направленность родительского элемента, содержащего форму, а если и она не указана, — по умолчанию для пользовательского агента.

В этом примере атрибут dir="auto" в элементе textarea позволяет автоматически определить направленность текста на основе введённого пользователем текста:

<form method="get" action="https://www.example.com/submit">
  <textarea name="comment" dir="auto" dirname="comment-direction">سيب</textarea>
  <button type="submit">Send my greetings</button>
</form>

При отправке формы пользовательский агент включает два поля: одно с именем comment и значением "سيب", и одно с именем comment-direction и значением "rtl". Тело отправки в формате URL выглядит так:

https://www.example.com/submit?comment=%D8%B3%D9%8A%D8%A8&comment-direction=rtl

В этом примере атрибут dir="auto" в элементе input позволяет автоматически определить направленность текста на основе введённого пользователем текста:

<form method="get" action="https://www.example.com/submit">
  <input
    type="text"
    name="comment-input"
    dir="auto"
    dirname="comment-direction"
    value="Hello" />
  <button type="submit">Send my greetings</button>
</form>

При отправке формы пользовательский агент включает два поля: одно с именем comment-input и значением "Hello", и одно с именем comment-direction и значением "ltr":

https://www.example.com/submit?comment-input=Hello&comment-direction=ltr

Следующие элементы <input> и <textarea> не имеют атрибута dir, поэтому они наследуют явную направленность от родительского элемента, которая составляет rtl:

<div dir="rtl">
  <form method="get" action="https://www.example.com/submit">
    <input
      type="text"
      name="user"
      dirname="user-direction"
      value="LTR Username" />
    <textarea name="comment" dirname="comment-direction">LTR Comment</textarea>
    <button type="submit">Post Comment</button>
  </form>
</div>

Тело отправки в формате URL выглядит так:

https://www.example.com/submit?user=LTR+Username&user-direction=rtl&comment=LTR+Comment&comment-direction=rtl

• dir атрибут
• <input>
• <textarea>