Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLElement : propriété autocapitalize

Limited availability

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La propriété autocapitalize de l'interface HTMLElement représente le comportement de capitalisation de l'élément pour la saisie utilisateur. Elle est disponible sur tous les éléments HTML, mais n'affecte pas tous les éléments, notamment :

autocapitalize n'affecte pas le comportement lors de la saisie au clavier physique. Elle affecte le comportement d'autres mécanismes de saisie comme les claviers virtuels sur appareils mobiles et la saisie vocale. Cela peut aider les utilisateur·ice·s en rendant la saisie plus rapide et plus facile, par exemple en mettant automatiquement la première lettre de chaque phrase en majuscule.

Elle reflète la valeur de l'attribut HTML global autocapitalize.

Valeur

Une chaîne de caractères qui représente le comportement de capitalisation de l'élément pour la saisie utilisateur. Les valeurs valides sont :

none ou off

Aucune capitalisation automatique ne doit être appliquée, toutes les lettres sont en minuscules par défaut.

sentences ou on

La première lettre de chaque phrase doit être en majuscule par défaut ; toutes les autres lettres sont en minuscules.

words

La première lettre de chaque mot doit être en majuscule par défaut ; toutes les autres lettres sont en minuscules.

characters

Toutes les lettres sont en majuscules par défaut.

Exemples

L'exemple suivant montre comment contrôler le comportement de capitalisation pour la saisie utilisateur via un script :

html
<div>
  Comportement actuel de la capitalisation&nbsp;: <span id="ac-label"></span>
</div>
<div id="ac-element" contenteditable="true" autocapitalize="default">
  saisissez ici
</div>
<select id="ac-controller" type="checkbox" checked>
  <option value="default">défaut</option>
  <option value="none">aucun</option>
  <option value="sentences">phrases</option>
  <option value="words">mots</option>
  <option value="characters">caractères</option></select
>Sélectionnez le comportement de capitalisation
js
const label = document.getElementById("ac-label");
const element = document.getElementById("ac-element");
const controller = document.getElementById("ac-controller");

controller.addEventListener("input", (e) => {
  const behavior = e.target.value;
  label.textContent = behavior;
  element.autocapitalize = behavior;
});

Spécifications

Specification
HTML
# dom-autocapitalize-dev

Compatibilité des navigateurs

Voir aussi