HTML-Attribut: dirname

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

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

rtl

Der von Benutzer eingegebene Text ist in einer Schrift-Richtung von rechts nach links.

ltr

Der von Benutzer eingegebene Text ist in einer Schrift-Richtung von links nach rechts.

Wenn keine Textdirektionalität angegeben ist, verwendet der Benutzeragent die Direktionalität des übergeordneten Elements, das das Formular enthält, und falls dies nicht angegeben ist, die Standarddirektionalität des Benutzeragents.

In diesem Beispiel ermöglicht das dir="auto"-Attribut auf dem textarea-Element, dass die Textdirektionalität 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 absendet, beinhaltet der Benutzeragent zwei Felder, eines namens comment mit dem Wert "سيب" und eines namens comment-direction mit dem Wert "rtl". Der URL-kodierte Ü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 Textdirektionalität 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 absendet, beinhaltet 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, sodass sie die explizite Direktionalität ihres übergeordneten Elements erben, welches 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-kodierte Ü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>