Attribut HTML universel : enterkeyhint

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis novembre 2021.

L'attribut universel enterkeyhint est un attribut énuméré définissant le libellé d'action (ou l'icône) à présenter pour la touche entrée sur le clavier virtuel.

Exemple interactif

<input enterkeyhint="go" />

<p contenteditable enterkeyhint="go">https://exemple.org</p>

Les contrôles de formulaires (tels que les éléments <textarea> ou <input>) ou les éléments utilisant l'attribut contenteditable peuvent définir un attribut inputmode pour contrôler le type de clavier virtuel utilisé. Pour améliorer l'expérience de l'utilisateur·ice, la touche entrée peut être personnalisée en fournissant un attribut enterkeyhint indiquant comment la touche doit être libellée (ou quelle icône doit être affichée). La touche entrée représente généralement l'action suivante à effectuer : envoyer un texte, insérer une nouvelle ligne ou lancer une recherche.

Si aucun attribut enterkeyhint n'est fourni, l'agent utilisateur peut utiliser des informations contextuelles issues des attributs inputmode, type ou pattern pour afficher une étiquette (ou une icône) adaptée pour la touche entrée.

Valeurs

L'attribut enterkeyhint est un attribut énuméré et n'accepte que les valeurs suivantes :

Valeur	Description	Exemple d'étiquette (dépend de l'agent utilisateur et de la langue)
`enterkeyhint="enter"`	Insère généralement une nouvelle ligne.	`Return`, `↵`
`enterkeyhint="done"`	Indique généralement qu'il n'y a plus rien à saisir et que l'éditeur de méthode de saisie (IME) sera fermé.	`Done`, `✅`
`enterkeyhint="go"`	Indique généralement d'amener l'utilisateur·ice vers la cible du texte saisi.	`Go`, `🡢`
`enterkeyhint="next"`	Indique généralement de passer au champ suivant acceptant du texte.	`Next`, `⇥`
`enterkeyhint="previous"`	Indique généralement de revenir au champ précédent acceptant du texte.	`Return`, `⇤`
`enterkeyhint="search"`	Indique généralement d'afficher les résultats de la recherche du texte saisi.	`Search`, `🔍`
`enterkeyhint="send"`	Indique généralement d'envoyer le texte à sa destination.	`Send`