CKTIS / HTML
enterkeyhint : le libellé de la touche Entrée virtuelle
Décrivez l’action souhaitée sans confondre le libellé avec sa réalisation.
Version : HTML Living Standard
Syntaxe
<input type="search" enterkeyhint="search">L’attribut global enterkeyhint propose un libellé ou une icône pour Entrée sur un clavier virtuel. Les valeurs sont enter, done, go, next, previous, search et send. Sans valeur prise en charge, le navigateur choisit selon le contexte. L’apparence dépend de la plateforme et de la méthode de saisie.
Ce n’est ni un gestionnaire d’événement, ni un algorithme de focus, ni un ordre d’envoi. Implémentez l’action avec un formulaire adapté ou du code et gardez une commande accessible. Ce réglage est distinct de la disposition des caractères. Une touche physique n’a pas à changer son inscription.
L’exemple étiquette Entrée dans un champ de recherche et traite explicitement l’envoi du formulaire. Une vraie pression transmet la valeur au gestionnaire sans navigation. Le test vérifie le formulaire, pas l’icône affichée sur un clavier mobile.
Exemples
<!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>Résultat
submitted=HTML
Le test utilise un événement de touche physique ; aucune apparence de clavier mobile n’est revendiquée.