enterkeyhint
Change le libellé ou l’icône de la touche Entrée du clavier à l’écran, par exemple en « Rechercher », « Envoyer » ou « Suivant ».
- S’applique à
- Champs de formulaire
<input>et<textarea>et éléments aveccontenteditable
Exemple
#<style>
#chat { list-style: none; margin: 0 0 12px; padding: 0; }
#chat li {
width: fit-content;
margin-bottom: 6px;
padding: 6px 10px;
border-radius: 10px;
background: #1f1f23;
}
</style>
<ul id="chat">
<li>Mentor : Comment avance l’exercice sur la boucle for ?</li>
</ul>
<form onsubmit="
event.preventDefault();
const item = document.createElement('li');
item.textContent = 'Vous : ' + this.elements.message.value;
document.getElementById('chat').append(item);
this.reset();
">
<input name="message" enterkeyhint="send" required
placeholder="Écrivez une réponse et appuyez sur Entrée" aria-label="Message au mentor">
</form>Sur un téléphone, la touche Entrée se transforme en « Envoyer ». L’envoi lui-même est assuré par le formulaire : Entrée dans son unique champ déclenche l’événement submit, et le script ajoute le message au chat. Sur un ordinateur, Entrée fonctionne de la même façon, simplement sans changement d’aspect de la touche.
Définition et utilisation
#L’attribut enterkeyhint détermine l’aspect de la touche Entrée sur le clavier à l’écran d’un téléphone ou d’une tablette. Au lieu d’une flèche générique, la touche peut afficher un libellé ou une icône qui annonce ce qui se passera à l’appui : « Rechercher » dans un moteur de recherche, « Envoyer » dans un chat, « Suivant » dans un formulaire à plusieurs champs.
L’attribut ne change que l’aspect de la touche, pas son fonctionnement. À l’appui, la page reçoit un événement ordinaire de la touche Entrée, c’est donc à vous de prévoir ce qui doit se passer. Dans un formulaire avec un champ sur une seule ligne, Entrée envoie le formulaire sans code supplémentaire, mais passer au champ suivant ou envoyer un message depuis un <textarea> nécessite un script.
Sur un ordinateur avec un clavier physique, vous ne verrez aucune différence. Le libellé ou l’icône exacts sont choisis par le système du téléphone, la même valeur peut donc avoir un aspect légèrement différent sur iPhone et sur Android.
Syntaxe
#<element enterkeyhint="enter | done | go | next | previous | search | send">…</element>Valeurs
#enter
L’Entrée standard, qui insère le plus souvent un saut de ligne.done
Fin de la saisie. Cela signifie généralement que le clavier peut se masquer.go
Aller à la destination, par exemple à l’adresse saisie.next
Passer au champ de formulaire suivant.previous
Revenir au champ de formulaire précédent.search
Rechercher l’expression saisie.send
Envoyer un message, par exemple dans un chat ou un commentaire.
Compatibilité des navigateurs
#Largement disponible · depuis 2021
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Choisissez la valeur en fonction de ce que fera réellement Entrée. Une touche « Envoyer » qui ne fait qu’insérer un saut de ligne induit en erreur.
- Dans un
<textarea>, Entrée ajoute un saut de ligne par défaut. Si elle doit envoyer le message, gérez l’événementkeydownet seulement ensuite définissezenterkeyhint="send".
Entrées associées
#- inputmodeSuggère quel clavier à l’écran afficher : avec des chiffres, avec une virgule, téléphonique, pour une adresse e-mail ou aucun.
- autocapitalizeIndique au clavier à l’écran quand mettre une majuscule : jamais, en début de phrase, en début de mot ou toujours.
- <input>Un champ de formulaire : texte, e-mail, mot de passe, nombre, date, curseur, case à cocher, fichier et bien plus encore.
- <textarea>Un champ de texte multiligne pour des saisies plus longues : messages, avis, descriptions.
- <form>Un formulaire qui collecte des données auprès de l’utilisateur et les envoie à une adresse donnée.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.