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.