Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources