::placeholder

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Le pseudo-élément ::placeholder représente le texte de substitution pour un élément <input> ou <textarea>. Cela permet aux développeurs web de personnaliser l'apparence de ce texte.

css
::placeholder {
  color: blue;
  font-size: 1.5em;
}

Seul un sous-ensemble des propriétés CSS peut être utilisé avec un sélecteur respectant ce pseudo-élément :

Note : Par défaut, dans la plupart des navigateurs, le texte de substitution est écrit en gris clair.

Syntaxe

Error: could not find syntax for this item

Exemples

CSS

css
input::placeholder {
  color: red;
}

HTML

html
<input type="email" placeholder="toto@exemple.com" />

Résultat

Accessibilité

Contraste

Taux de contraste

Le texte de substitution est généralement représenté avec une couleur plus claire afin d'indiquer qu'il s'agit d'un suggestion et que ce contenu n'a pas été saisi par l'utilisateur ou par le site même.

Il est important de vérifier que le contraste entre la couleur de ce texte et celle de l'arrière-plan est suffisament élevé afin que les personnes avec des conditions de vision faibles puissent les lire.

La valeur du contraste est déterminée en comparant la luminosité de la couleur du texte de substitution et celle de l'arrière-plan. Afin de respecter les recommandations d'accessibilité : Web Content Accessibility Guidelines (WCAG), un ratio de 4.5:1 est nécessaire pour le contenu textuel normal et un ratio de 3:1 est nécessaire pour les textes plus grands ou en gras. Le seuil entre ces deux tailles est défini de la façon suivante :

  • Si le texte est en gras : 18.66px ou plus grand
  • Sinon 24px ou plus grand

Autres ressources :

Utilisabilité

Les textes de substitution avec un contraste suffisamment élevé peuvent être pris pour des textes saisis par l'utilisateur. De plus, les textes de substituion disparaissent lorsqu'une personne saisit du contenu dans l'élément <input>. Pour ces deux raisons, les textes de subsitution peuvent gêner la complétion du formulaire, notamment pour les personnes souffrant de troubles cognitifs.

Une autre méthode consiste à fournir cette information en l'incluant à proximité du champ mais en dehors et d'utiliser l'attribut aria-describedby afin de relier l'élément <input> à l'indication associée.

Avec cette méthode, le contenu indicatif est disponible à tout moment (même lorsqu'une information a été saisie par l'utilisateur) et le champ est vide lorsque la page est chargée. La plupart des lecteurs d'écran utiliseront aria-describedby afin de lire l'indication lorsque le libellé du champ aura été annoncé. La personne utilisant le lecteur d'écran pourra arrêter les annonces si elle estime que les informations supplémentaires ne sont pas nécessaires.

html
<label for="user-email">Votre adresse mail</label>
<span id="user-email-hint" class="input-hint"
  >Exemple : johndoe@example.com</span
>
<input
  id="user-email"
  aria-describedby="user-email-hint"
  name="email"
  type="email" />

Mode « contraste élevé » de Windows

Lorsque le mode de contraste élevé de Windows est actif, les textes de substitution apparaîtront avec la même mise en forme que les textes saisis par l'utilisateur. Il est alors impossible de distinguer un texte saisi d'un texte indicatif.

Libellés (<<label>>)

Les textes de substitution ne doivent pas remplacer les éléments <label>. Sans libellé associé grâce à for et à id, les outils d'assistance tels que les lecteurs d'écran ne peuvent pas correctement analyser les éléments <input>.

Spécifications

Specification
CSS Pseudo-Elements Module Level 4
# placeholder-pseudo

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi