Attribut global HTMLAttributs globaux

inputmode

Suggère quel clavier à l’écran afficher : avec des chiffres, avec une virgule, téléphonique, pour une adresse e-mail ou aucun.

S’applique à
Champs de texte <input>, <textarea> et éléments avec contenteditable
Sur cette page

Exemple

#
HTML
<style>
  .field { display: grid; gap: 4px; max-width: 300px; margin-bottom: 12px; }
  .field small { color: #a3a3a3; }
</style>

<form>
  <label class="field">Identifiant ou e-mail
    <input type="text" name="login" inputmode="email" autocomplete="username">
    <small>Clavier avec le caractère @, sans vérification du format de l’adresse.</small>
  </label>
  <label class="field">Code reçu par SMS
    <input type="text" name="code" inputmode="numeric" autocomplete="one-time-code">
    <small>Uniquement des chiffres.</small>
  </label>
  <label class="field">Montant du versement en €
    <input type="text" name="amount" inputmode="decimal">
    <small>Chiffres et séparateur décimal, par exemple une virgule.</small>
  </label>
</form>
Aperçu

Vous ne verrez le type de clavier que sur un téléphone ou une tablette. Sur un ordinateur, les trois champs ont le même aspect et le même fonctionnement.

Définition et utilisation

#

L’attribut inputmode indique à un téléphone ou une tablette quel type de clavier à l’écran faire apparaître lorsque l’utilisateur touche le champ. Pour un code reçu par SMS, de simples chiffres suffisent, pour un montant il faut des chiffres avec une virgule, et pour une adresse e-mail un clavier avec le caractère @. Un clavier bien choisi évite les changements de clavier et les fautes de frappe.

Contrairement à l’attribut type du champ <input>, inputmode ne change rien d’autre que le clavier : il ne vérifie pas la validité, n’ajoute ni flèches ni calendrier et n’influence pas ce qui part vers le serveur. C’est pourquoi il convient aux valeurs composées de chiffres mais qui ne sont pas des nombres destinés au calcul, comme les codes PIN, les codes reçus par SMS ou les numéros de carte. Pour elles, choisissez type="text" avec inputmode="numeric", et non type="number".

Les champs type="email", type="tel" et type="url" choisissent eux-mêmes le bon clavier, inputmode sert donc surtout dans les champs de texte ordinaires et dans les éléments avec contenteditable. Sur un ordinateur avec un clavier physique, l’attribut ne change rien.

Syntaxe

#
Syntaxe
<element inputmode="none | text | decimal | numeric | tel | search | email | url">…</element>

Valeurs

#
  • none

    Pas de clavier à l’écran. Seulement lorsque la page a son propre clavier, par exemple un clavier PIN dans une borne.
  • text

    Un clavier de texte ordinaire. Le réglage par défaut.
  • decimal

    Chiffres et séparateur décimal, virgule ou point selon les réglages de langue. Pour les montants et les mesures.
  • numeric

    Uniquement des chiffres. Pour les codes PIN, les codes reçus par SMS et les numéros de carte.
  • tel

    Un clavier téléphonique avec des chiffres et les caractères +, * et #.
  • search

    Un clavier pour la recherche. La touche Entrée se transforme souvent en « Rechercher ».
  • email

    Un clavier avec le caractère @ et le point. Il ne vérifie pas la validité de l’adresse.
  • url

    Un clavier pour les adresses web, généralement avec les touches / et ..

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

#
  • Associez inputmode à autocomplete. Le couple inputmode="numeric" et autocomplete="one-time-code" permet de saisir un code reçu par SMS d’une simple touche sur la suggestion au-dessus du clavier.
  • Le clavier n’est qu’un confort. Si un champ n’accepte que des chiffres, vérifiez-le avec l’attribut pattern ou dans un script, car l’utilisateur peut coller n’importe quel texte.

Entrées associées

#

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