Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

dirname : transmettre le sens du texte

Envoyez un champ de direction complémentaire sans renommer le champ textuel.

Version : HTML Living Standard

Syntaxe

<input name="comment" dirname="comment.dir" dir="auto">

Sur les contrôles textuels compatibles, dirname nomme une entrée supplémentaire non vide contenant la direction. Sa valeur transmise est ltr ou rtl. Il ne renomme pas le texte, ne choisit pas un dossier et ne traduit rien. Utilisez un nom distinct pour éviter les collisions côté serveur.

La direction résulte des règles de directionnalité, notamment d’un réglage explicite ou automatique. L’attribut ne la définit pas lui-même. Un contrôle désactivé ou omis ne fournit pas miraculeusement du texte utile. Considérez texte et direction comme des données client à valider sur le serveur.

L’exemple place du texte arabe puis latin dans un champ à direction automatique. FormData contient d’abord une direction droite-gauche, puis gauche-droite. Il vérifie la sérialisation réelle, sans deviner la direction à partir du texte de l’attribut.

Exemples

<!doctype html><meta charset="utf-8">
<form id="form"><label>Comment <input id="comment" name="comment" dirname="comment.dir" dir="auto"></label></form><output id="result"></output>
<script>
const form = document.querySelector('#form'), field = document.querySelector('#comment');
field.value = 'مرحبا'; const first = new FormData(form).get('comment.dir');
field.value = 'Hello'; const second = new FormData(form).get('comment.dir');
document.querySelector('#result').textContent = 'Arabic=' + first + '; Latin=' + second;
</script>

Résultat

Arabic=rtl; Latin=ltr

Le champ textuel conserve son nom distinct ; seule la valeur complémentaire de direction est examinée.

Sources