HTML dirname Attribute


The dirname attribute on an input element submits the element‘s text direction, left-to-right or right-to-left, together with the input value. Elements that accept this attribute include <input>, and <textarea>.

Example

#

A dirname attribute on an <input> element.
Submitting this form will send the text input value and its direction.




<form action="/tutorial/action.html">
  <label for="firstname">First name</label><br />
  <input type="text" id="firstname" 
         name="firstname" dirname="firstname.dir">
  <br /><br />

  <input type="submit" value="Submit">
</form>

For additional details see our HTML input dirname Reference.


Using dirname

The dirname attribute submits the text direction together with the value of the input element.

The name of this attribute must be the input field name followed by .dir.

This attribute helps in identifying the correct direction for an input value.

Here is a list of the languages that are written from right-to-left (rtl):

  • Arabic
  • Aramaic
  • Azeri
  • Dhivehi/Maldivian
  • Hebrew
  • Kurdish (Sorani)
  • Persian/Farsi
  • Urdu

Syntax

<tagname name="input-name" dirname="input-name.dir" >

Values

#

Value Description
input-name.dir Submits the text direction of the input value.
Possible values are ltr (left-to-right) or rtl (right-to-left).

Elements that accept dirname

The following input elements accept the dirname attribute.

Elements Description
<input> Specifies an input field -- see example above
<textarea> Specifies a multi-line text field.

<textarea> with dirname

A <textarea> tag with a dirname attribute.



<form action="/tutorial/action.html">
  <label for="message">Message:</label><br />
  <textarea id="message" name="message" 
            dirname="message.dir" cols="50"></textarea><br/>

  <input type="submit" value="Submit">
</form>

For additional details see our HTML textarea dirname Reference.


Browser support

Here is when dirname support started for each browser:

Chrome
1.0 Sep 2008
Firefox
Not Supported
IE/Edge
79.0 Jan 2020
Opera
1.0 Jan 2006
Safari
1.0 Jan 2003

You may also like



Guides