HTML-Attribut: dirname

Das dirname-Attribut kann auf jedes <textarea>-Element oder jedes <input>-Element mit den Typen hidden, text, search, tel, url, email, password, submit, reset oder button angewendet werden.

Das Format der übermittelten Daten ist {dirname_value}={direction}, wobei {dirname_value} der Wert des dirname-Attributs und {direction} die Richtung 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-codierten Formularübermittlungsdaten für GET-Anfragen comment=Hello&comment-direction=ltr sein. Die Richtung des Textes ist eine der folgenden:

rtl

Der vom Benutzer eingegebene Text hat eine Schreibrichtung von rechts nach links.

ltr

Der vom Benutzer eingegebene Text hat eine Schreibrichtung von links nach rechts.

Wenn keine Textrichtung angegeben ist, verwendet der Benutzeragent die Richtung des übergeordneten Elements, das das Formular enthält. Falls auch diese nicht definiert ist, wird die Standardrichtung des Benutzeragents verwendet.

In diesem Beispiel erlaubt das Attribut dir="auto" auf dem Textarea-Element, dass die Textrichtung 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 übermittelt, fügt der Benutzeragent zwei Felder hinzu: eines namens comment mit dem Wert "سيب" und eines namens comment-direction mit dem Wert "rtl". Der URL-codierte Übermittlungsinhalt sieht folgendermaßen aus:

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

In diesem Beispiel erlaubt das Attribut dir="auto" auf dem Input-Element, dass die Textrichtung 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 übermittelt, fügt der Benutzeragent zwei Felder hinzu: 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 Textrichtung ihres übergeordneten Elements erben, 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 Übermittlungsinhalt 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>