Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

dirname: enviar a direção do texto

Acrescente um campo de direção sem mudar o nome do campo textual.

Versão: HTML Living Standard

Sintaxe

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

Nos controlos textuais compatíveis, dirname dá um nome não vazio a uma entrada adicional do formulário com a direção. O valor enviado é ltr ou rtl. Não renomeia o texto, escolhe diretórios nem traduz valores. Use um nome complementar distinto para evitar colisões no processamento do servidor.

A direção resulta das regras de direcionalidade, incluindo uma definição explícita ou deteção automática. O atributo não a estabelece. Um controlo desativado ou omitido não passa magicamente a fornecer texto útil. Trate texto e direção como dados do cliente e valide-os no servidor.

O exemplo atribui texto árabe e depois latino a um campo com direção automática. FormData contém primeiro direita para esquerda, depois esquerda para direita. Isto verifica serialização real, não uma direção presumida a partir do atributo.

Exemplos

<!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>

Resultado

Arabic=rtl; Latin=ltr

O campo textual mantém o seu nome próprio; só se inspeciona o valor complementar da direção.

Fontes