CKTIS / HTML
dirname: inviare la direzione del testo
Aggiungi un campo di direzione senza rinominare il campo testuale.
Versione: HTML Living Standard
Sintassi
<input name="comment" dirname="comment.dir" dir="auto">Sui controlli testuali supportati, dirname dà un nome non vuoto a una voce aggiuntiva del modulo contenente la direzione. Il valore trasmesso è ltr o rtl. Non rinomina il testo, sceglie cartelle o traduce valori. Usa un nome distinto per evitare collisioni nell’elaborazione server.
La direzione deriva dalle regole di direzionalità, inclusa un’impostazione esplicita o automatica. L’attributo non la imposta da solo. Un controllo disabilitato o omesso non fornisce magicamente testo utile. Considera testo e direzione dati del client da validare sul server.
L’esempio assegna prima testo arabo e poi latino a un campo con direzione automatica. FormData contiene prima destra-sinistra, poi sinistra-destra. Si verifica la serializzazione reale, non una direzione indovinata dal testo dell’attributo.
Esempi
<!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>Risultato
Arabic=rtl; Latin=ltr
Il campo testuale mantiene il proprio nome; si esamina soltanto la direzione aggiuntiva.