Element: ariaHidden-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
Die ariaHidden-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-hidden-Attributs wider, das angibt, ob das Element für eine Zugänglichkeits-API sichtbar ist.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Element ist vor der Zugänglichkeits-API verborgen.
"false"-
Das Element ist der Zugänglichkeits-API zugänglich, als ob es gerendert wäre.
"undefined"-
Der versteckte Status des Elements wird vom Benutzeragenten bestimmt, basierend darauf, ob es gerendert wird oder nicht.
Beispiele
In diesem Beispiel wird das aria-hidden-Attribut des Elements mit der ID hidden auf "true" gesetzt. Mit ariaHidden aktualisieren wir den Wert auf "false".
<div id="hidden" aria-hidden="true">Some things are better left unsaid.</div>
let el = document.getElementById("hidden");
console.log(el.ariaHidden); // true
el.ariaHidden = "false";
console.log(el.ariaHidden); // false
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariahidden |