Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

aria-hidden — escludere contenuti accessibili ridondanti

`aria-hidden` può rimuovere contenuti ridondanti dall’albero di accessibilità senza nasconderli sullo schermo.

Versione: WAI-ARIA 1.2

Sintassi

<span aria-hidden="true">★</span>

La stringa true esclude un elemento e il suo sottoalbero dalla presentazione alle tecnologie assistive. Un false su un discendente non annulla lo stato nascosto di un antenato. Non sostituisce CSS e non protegge dati riservati.

Non applicarlo a elementi che possono ricevere il focus né ai loro antenati. Mantieni significato e funzionalità equivalenti per chi usa un lettore di schermo. I contenuti già nascosti con HTML o CSS normalmente non richiedono una dichiarazione aggiuntiva.

L’esempio esclude una stella decorativa e il suo figlio dal nome del pulsante Save. La decorazione resta visibile; neppure la dichiarazione esplicita contraria del figlio la ripristina nell’albero. Il test controlla dimensioni sullo schermo e nome del pulsante senza eliminare contenuti dal DOM.

Esempi

<!doctype html><meta charset="utf-8">
<button id="save"><span id="star" aria-hidden="true">★<span aria-hidden="false">!</span></span> Save</button>
<output id="result"></output>
<script>
document.querySelector('#result').textContent = 'decorativeVisible=' + (document.querySelector('#star').getBoundingClientRect().width > 0);
</script>

Risultato

decorativeVisible=true

Verificate la decorazione visibile e, insieme, l’assenza dei suoi caratteri dal nome accessibile del pulsante.

Fonti