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é ariaLevel

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é ariaLevel de l'interface Element reflète la valeur de l'attribut aria-level, qui définit le niveau hiérarchique d'un élément au sein d'une structure.

Note : Dans la mesure du possible, utilisez un élément HTML <h1> ou un autre niveau de titre correct, car ceux-ci ont une sémantique intégrée et ne nécessitent pas d'attributs ARIA.

Valeur

Une chaîne de caractères contenant un entier.

Exemples

Dans cet exemple, l'attribut aria-level sur l'élément avec un ID de titre-principal est défini sur "1". En utilisant ariaLevel, nous mettons à jour la valeur à "2".

html
<div role="heading" id="titre-principal" aria-level="1">
  Ceci est un titre principal de la page
</div>
js
let el = document.getElementById("titre-principal");
console.log(el.ariaLevel); // "1"
el.ariaLevel = "2";
console.log(el.ariaLevel); // "2"

Spécifications

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

Compatibilité des navigateurs

Voir aussi