dirname HTML-атрибут

Атрибут 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

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

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

Примеры

Направление текста в элементе textarea

В этом примере атрибут 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

Направление текста в элементе input

В этом примере атрибут 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

Спецификации

Совместимость с браузерами

html.elements.textarea.dirname

html.elements.input.dirname

См. также

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