HTML-Attribut: dirname

Das dirname-Attribut kann bei jedem <textarea>-Element oder bei jedem <input>-Element mit hidden, text, search, tel, url, email, password, submit, reset oder button Typ verwendet werden.

Das Format der übermittelten Daten ist {dirname_value}={direction}, wobei {dirname_value} der Wert des dirname-Attributs und {direction} die Leserichtung des Textes ist. Zum Beispiel, wenn der Benutzer "Hello" in ein Element mit den Attributen name="comment" und dirname="comment-direction" eingibt, sind die URL-codierten Formulardaten für GET-Anfragen comment=Hello&comment-direction=ltr. Die Leserichtung ist eine der folgenden:

rtl

Der vom Benutzer eingegebene Text hat eine rechts-nach-links Schriftrichtung.

ltr

Der vom Benutzer eingegebene Text hat eine links-nach-rechts Schriftrichtung.

Wenn keine Textausrichtung angegeben wird, verwendet der Benutzeragent die Leserichtung des übergeordneten Elements, das das Formular enthält, und wenn diese nicht angegeben ist, die Standardleserichtung des Benutzeragenten.

In diesem Beispiel ermöglicht das dir="auto"-Attribut auf dem textarea-Element, dass die Leserichtung automatisch basierend auf dem vom Benutzer eingegebenen Text bestimmt wird:

<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>

Wenn der Benutzer das Formular abschickt, inkludiert der Benutzeragent zwei Felder, eines namens comment mit dem Wert "سيب", und eines namens comment-direction mit dem Wert "rtl". Der URL-codierte Übermittlungskörper sieht folgendermaßen aus:

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

In diesem Beispiel ermöglicht das dir="auto"-Attribut auf dem input-Element, dass die Leserichtung automatisch basierend auf dem vom Benutzer eingegebenen Text bestimmt wird:

<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>

Wenn der Benutzer das Formular abschickt, inkludiert der Benutzeragent zwei Felder, eines namens comment-input mit dem Wert "Hello", und eines namens comment-direction mit dem Wert "ltr":

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

Die folgenden <input> und <textarea>-Elemente haben kein dir-Attribut, daher erben sie die explizite Leserichtung ihres übergeordneten Elements, das rtl ist:

<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>

Der URL-codierte Übermittlungskörper sieht folgendermaßen aus:

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

• dir-Attribut
• <input>
• <textarea>