::placeholder
=============

Le pseudo-élément **`::placeholder`** représente le texte de substitution (en-US) 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 :

* Toutes les propriétés liées aux polices de caractères : `font`, `font-kerning`, `font-style`, `font-variant`, `font-variant-numeric`, `font-variant-position`, `font-variant-east-asian`, `font-variant-caps`, `font-variant-alternates`, `font-variant-ligatures`, `font-synthesis`, `font-feature-settings`, `font-language-override`, `font-weight`, `font-size`, `font-size-adjust`, `font-stretch` et `font-family`
* La propriété `color`
* Toutes les propriétés liées à l'arrière-plan : `background-color`, `background-clip`, `background-image`, `background-origin`, `background-position`, `background-repeat`, `background-size`, `background-attachment` et `background-blend-mode`
* `word-spacing`, `letter-spacing`, `text-decoration`, `text-transform` et `line-height`
* `text-shadow`, `text-decoration`, `text-decoration-color`, `text-decoration-line`, `text-decoration-style` et `vertical-align`.

**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 itemExemples
--------

### 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 :

* WebAIM : vérificateur de contraste
* Explications des recommendation WCAG 1.4
* Understanding Success Criterion 1.4.3 | W3C Understanding WCAG 2.0

#### 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" />
```


* *Placeholders in Form Fields Are Harmful* — Nielsen Norman Group (en anglais)
### 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.

* Greg Whitworth — Comment utiliser `-ms-high-contrast` (en anglais)
* `@media/-ms-high-contrast`
### 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>`.

* Fournir des indications simples dans un formulaire
* *Placeholders in Form Fields Are Harmful* — Nielsen Norman Group (en anglais)
Spécifications
--------------

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

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `:placeholder-shown` qui permet de mettre en forme un élément qui possède un *placeholder* actif
* Les formulaires HTML (en-US)
* `<input>`
* `<textarea>`
* Les équivalents **non-standards** :
    + `::-webkit-input-placeholder`
    + `::placeholder`
    + `:-ms-input-placeholder`