Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

enterkeyhint: l’etichetta dell’Invio virtuale

Descrivi l’azione prevista senza confondere l’etichetta con l’implementazione.

Versione: HTML Living Standard

Sintassi

<input type="search" enterkeyhint="search">

Il globale enterkeyhint suggerisce etichetta o icona per Invio sulle tastiere virtuali. I valori sono enter, done, go, next, previous, search e send. Se manca o non è supportato, il browser decide dal contesto. L’aspetto dipende da piattaforma e metodo di input.

Non è un gestore di eventi, un algoritmo di focus o un ordine di invio. Implementa l’azione con il comportamento appropriato del modulo o con codice, mantenendo un controllo accessibile. È distinto dalla disposizione dei caratteri. Una tastiera fisica non deve cambiare la scritta sul tasto.

L’esempio etichetta Invio in un campo di ricerca e gestisce esplicitamente l’invio del modulo. Una pressione reale consegna il valore al gestore senza navigazione. Il test verifica il modulo, non l’icona mostrata da una tastiera mobile.

Esempi

<!doctype html><meta charset="utf-8">
<form id="form"><label>Find <input id="query" type="search" name="q" enterkeyhint="search" value="HTML"></label><button>Search</button></form><output id="result"></output>
<script>
document.querySelector('#form').addEventListener('submit', event => {
  event.preventDefault();
  document.querySelector('#result').textContent = 'submitted=' + new FormData(event.currentTarget).get('q');
});
// Focus the field and press Enter. The form handler implements the action.
</script>

Risultato

submitted=HTML

Il test usa un evento di tasto fisico; non dichiara l’aspetto della tastiera mobile.

Fonti