Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : propriété ariaAtomic

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é ariaAtomic de l'interface Element reflète la valeur de l'attribut aria-atomic, qui indique si les technologies d'assistance présentent l'ensemble de la région modifiée ou seulement certaines parties, en fonction des notifications de changement définies par l'attribut aria-relevant.

Valeur

Une chaîne de caractères avec l'une des valeurs suivantes :

"false"

Les technologies d'assistance ne présentent que le ou les nœuds modifiés.

"true"

Les technologies d'assistance présentent l'ensemble de la région modifiée dans son ensemble, y compris l'étiquette définie par l'auteur·ice si elle existe.

Exemples

Dans cet exemple, l'attribut aria-atomic sur l'élément avec un ID de "horloge" est défini sur "true". En utilisant ariaAtomic, nous mettons à jour la valeur à "false".

html
<div id="horloge" role="timer" aria-live="polite" aria-atomic="true"></div>
js
let el = document.getElementById("horloge");
console.log(el.ariaAtomic); // true
el.ariaAtomic = "false";
console.log(el.ariaAtomic); // false

Spécifications

Spécification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariaatomic

Compatibilité des navigateurs