Attribut global HTMLAttributs globaux

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 avec contenteditable
Sur cette page

Exemple

#
HTML
<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>
Aperçu

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

#
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énement keydown et seulement ensuite définissez enterkeyhint="send".

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.