Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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 universelenterkeyhintest un attribut à valeur contrainte définissant le libellé d'action (ou l'icône) à présenter pour la touche entrée sur le clavier virtuel.
Dans cet article
Exemple interactif
<input enterkeyhint="go" /><p contenteditable enterkeyhint="go">https://example.org</p>Description
Les [contrôles de formulaires](/fr/docs//Learn_web_development/Extensions/Forms) (tels que les éléments<textarea>ou<input>) ou les éléments utilisant l'attributcontenteditable peuvent spécifier un attributinputmode pour contrôler le type de clavier virtuel qui sera utilisé. Pour améliorer davantage l'expérience du visiteur, la touche à entrer peut être personnalisée spécifiquement en fournissant un attributenterkeyhint indiquant comment la clé de saisie doit être libellée (ou quelle icône doit être affichée). La clé de saisie représente généralement ce que la personne va devoir faire par la suite. Les actions consistent généralement en l'envoi d'un texte, l'insertion d'une nouvelle ligne, le lancement d'une recherche, etc.
Si aucun attributenterkeyhint n'est fourni, l'agent utilisateur pourrait utiliser une information contextuelle à partir des attributsinputmode,type,oupattern pour afficher une clé de saisie (ou une icône) adaptée.
Valeurs
L'attributenterkeyhint est un attribut à valeur contrainte et accepte uniquement les valeurs suivantes :
| Valeur | Description | Libellé de l'exemple (dépend de l'agent utilisateur et de la langue) |
|---|---|---|
enterkeyhint="enter" | Généralement utilisé pour insérer une nouvelle ligne de texte. | ↵ |
enterkeyhint="done" | Signifie généralement qu'il n'y a rien de plus à saisir et que la méthode de saisie de l'éditeur (IME) est fermée. | Done |
enterkeyhint="go" | Généralement utilisé pour envoyer le visiteur à la cible correspondant au texte saisi. | Open |
enterkeyhint="next" | Cela envoie généralement la personne visitant le site vers le prochain champ qui accepte une saisie de texte. | Next |
enterkeyhint="previous" | Cela envoie généralement la personne visitant le site vers le champ précédent acceptant une saisie de texte. | Prev |
enterkeyhint="search" | Cela envoie généralement la personne visitant le site aux résultats de la recherche pour le texte qui a été saisi. | Search |
enterkeyhint="send" | Cela envoie généralement le texte sur une cible donnée. | Send |
Spécifications
| Specification |
|---|
| HTML> # attr-enterkeyhint> |
Compatibilité des navigateurs
Voir aussi
- La propriété
HTMLElement.enterkeyhintreflétant cet attribut - L'attribut universel
inputmode - L'attribut universel
contenteditable - Les attributs
typeetpatternsur les éléments<input>