dirname

Description

L’attribut dirname s’applique aux éléments <input> (types textuels) et <textarea>. Lorsqu’il est présent, le navigateur ajoute automatiquement une entrée supplémentaire dans les données de formulaire envoyées, contenant la direction (ltr ou rtl) du texte saisi. La valeur de dirname devient le nom de ce champ additionnel.

Syntaxe

<input type="text" name="comment" dirname="comment.dir">
<textarea name="message" dirname="message.dir"></textarea>

Exemples

Formulaire multilingue avec envoi de la direction :

<form method="post" action="/submit">
  <label for="texte">Votre message :</label>
  <input type="text" id="texte" name="texte" dirname="texte.dir">
  <button type="submit">Envoyer</button>
</form>

Si l’utilisateur saisit du texte arabe, les données soumises contiendront :

texte=مرحبًا&texte.dir=rtl

Si l’utilisateur saisit du texte en français :

texte=Bonjour&texte.dir=ltr

Notes

Nommage du champ de direction : par convention, la valeur de dirname est formée du nom du champ principal suivi de .dir (ex. comment.dir), mais toute chaîne de caractères valide est acceptée.

Compatibilité avec dir="auto" : dirname est particulièrement utile en combinaison avec dir="auto" sur le champ, afin que le navigateur détecte et transmette la direction réelle du contenu utilisateur.

Éléments concernés : <input> avec les types text, search, tel, url, email et password, ainsi que <textarea>.