Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes