Element : propriété ariaPlaceholder
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2023.
La propriété ariaPlaceholder de l'interface Element reflète la valeur de l'attribut aria-placeholder, qui définit un court indice destiné à aider l'utilisateur·ice lors de la saisie de données lorsque le contrôle n'a pas de valeur.
Note :
Ici, il est possible d'utiliser un élément HTML <input> avec type="text" ou un <textarea>, car ils ont une sémantique intégrée et ne nécessitent pas d'attributs ARIA.
Valeur
Une chaîne de caractères.
Exemples
Dans cet exemple, l'attribut aria-placeholder de l'élément avec un ID de boiteSaisieTexte a été défini sur une chaîne de caractères. En utilisant ariaPlaceholder, nous mettons à jour la chaîne de caractères avec une autre valeur.
<div id="etiquetteBoiteTexte">Entrez votre code postal à cinq chiffres</div>
<div
role="textbox"
id="boiteSaisieTexte"
contenteditable="true"
aria-placeholder="Code postal à cinq chiffres"
aria-labelledby="etiquetteBoiteTexte"></div>
let el = document.getElementById("boiteSaisieTexte");
console.log(el.ariaPlaceholder); // "Code postal à cinq chiffres"
el.ariaPlaceholder = "12345";
console.log(el.ariaPlaceholder); // "12345"
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaplaceholder |