string

aria-placeholder

Fournit un texte d'indication court pour guider la saisie dans un widget de texte personnalisé, affiché en l'absence de valeur.

Description

aria-placeholder est l’équivalent ARIA de l’attribut HTML placeholder. Il s’utilise sur des widgets textbox ou searchbox personnalisés (non-natifs) pour indiquer aux technologies d’assistance le texte indicatif attendu.

Syntaxe

<div role="textbox"
     contenteditable="true"
     aria-placeholder="Entrez votre recherche…"
     aria-label="Recherche">
</div>

Exemples

Éditeur riche avec placeholder :

<div role="textbox"
     contenteditable="true"
     aria-multiline="true"
     aria-placeholder="Rédigez votre commentaire…"
     aria-label="Commentaire">
</div>

Notes

Préférer placeholder HTML : pour les éléments <input> et <textarea> natifs, utiliser directement l’attribut HTML placeholder.

Pas un libellé : le placeholder est un texte d’indication temporaire, pas un libellé permanent. Toujours fournir un aria-label ou aria-labelledby en complément.

Accessibilité du placeholder natif : les placeholders HTML ont souvent un contraste insuffisant. Veiller à respecter le ratio de contraste 4.5:1 pour le texte du placeholder.

Support navigateurs