CKTIS / HTML
termo ou valor HTML: inert
O atributo `inert` desativa a interação do utilizador com uma subárvore inteira, incluindo foco e ativação, mantendo os nós e estado da aplicação no DOM.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<section inert><button>Unavailable</button></section>inert é um atributo booleano, portanto a presença ativa o estado; inert="false" continua a significar inert ativo. Abrange descendentes da árvore plana, que não podem receber foco ou cliques do utilizador e são omitidos das tecnologias de apoio.
Conteúdo inerte percetível não pode parecer operacional: oculta-o ou obscurece-o visualmente de forma adequada para tornar o estado inativo inequívoco. Um modal aberto com showModal() escapa à inércia dos antepassados, salvo se o próprio diálogo tiver inert, e torna o resto inerte; para um só controlo pode ser adequado o disabled nativo.
A inércia não remove conteúdo, para scripts ou cria uma fronteira de segurança; valores do formulário permanecem e o código pode alterar o DOM. Ao restaurar a interação, remove o atributo depois de sincronizar o estado visível e o destino do foco.
O exemplo chama focus() num botão dentro da subárvore inerte, mas document.activeElement permanece no botão anterior; a propriedade inert vale true e o nó interno continua no DOM.
Exemplos
<!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>Resultado
inert=true; active=before; inDom=true
O exemplo executado verifica a rejeição do foco programático sem remover o descendente do documento.