Element : propriété ariaExpanded
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é ariaExpanded de l'interface Element reflète la valeur de l'attribut aria-expanded, qui indique si un élément de regroupement possédé ou contrôlé par cet élément est développé ou réduit.
Valeur
Une chaîne de caractères avec l'une des valeurs suivantes :
"true"-
L'élément de regroupement possédé ou contrôlé par cet élément est développé.
"false"-
L'élément de regroupement possédé ou contrôlé par cet élément est réduit.
"undefined"-
L'élément ne possède pas ou ne contrôle pas un élément de regroupement extensible.
Exemples
Dans cet exemple, l'attribut aria-expanded sur l'élément avec un ID de animal est défini sur "false". En utilisant ariaExpanded, nous mettons à jour la valeur à "true".
<div class="boite-combinee-animal">
<label for="animal">Animal</label>
<input
id="animal"
type="text"
role="combobox"
aria-autocomplete="inline"
aria-controls="liste-boite-animaux"
aria-expanded="false"
aria-haspopup="listbox" />
<ul id="liste-boite-animaux" role="listbox" aria-label="Animaux">
<li id="animal-chat" role="option">Chat</li>
<li id="animal-chien" role="option">Chien</li>
</ul>
</div>
let el = document.getElementById("animal");
console.log(el.ariaExpanded); // false
el.ariaExpanded = "true";
console.log(el.ariaExpanded); // true
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaexpanded |