Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

termine o valore HTML: inert

L’attributo `inert` disabilita l’interazione utente con un intero sottoalbero, inclusi focus e attivazione, lasciando nodi e stato applicativo nel DOM.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<section inert><button>Unavailable</button></section>

inert è un attributo booleano, quindi la presenza abilita lo stato; inert="false" significa ancora inert attivo. Lo stato copre i discendenti dell’albero piatto, che non possono ricevere focus o clic utente e sono omessi dalle tecnologie assistive.

Il contenuto inerte percepibile non deve sembrare operativo: nascondilo o oscuralo visivamente in modo appropriato affinché lo stato inattivo sia inequivocabile. Un modale aperto con showModal() sfugge all’inerzia degli antenati salvo che abbia esso stesso inert, e rende inerte il resto; per un solo controllo può essere corretto il disabled nativo.

L’inerzia non rimuove contenuto, ferma script o crea un confine di sicurezza; i valori del modulo restano e il codice può modificare il DOM. Nel ripristinare l’interazione, rimuovi l’attributo dopo aver sincronizzato stato visibile e destinazione del focus.

L’esempio chiama focus() su un pulsante nel sottoalbero inerte, ma document.activeElement resta sul pulsante precedente; la proprietà inert vale true e il nodo interno rimane nel DOM.

Esempi

<!doctype html><meta charset="utf-8"><button id="before">Before</button><section id="x" inert><button id="inside">Inside</button></section><output id="result"></output><script>before.focus();inside.focus();result.textContent=`inert=${x.inert}; active=${document.activeElement.id}; inDom=${document.body.contains(inside)}`;</script>

Risultato

inert=true; active=before; inDom=true

L’esempio eseguito verifica il rifiuto del focus programmatico senza rimuovere il discendente dal documento.

Fonti