CKTIS / HTML
término o valor HTML: inert
El atributo `inert` desactiva la interacción del usuario con todo un subárbol, incluidos foco y activación, mientras conserva sus nodos y estado en el DOM.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<section inert><button>Unavailable</button></section>inert es un atributo booleano: su presencia activa el estado y inert="false" sigue significando inert activo. Abarca descendientes del árbol plano, que no pueden recibir foco ni clics del usuario y se omiten para las tecnologías de asistencia.
El contenido inerte perceptible no debe parecer operativo: ocúltelo u oscúrelo visualmente de forma apropiada para que el estado inactivo sea inequívoco. Un modal abierto con showModal() escapa de la inercia de sus antecesores salvo que él mismo tenga inert, y vuelve inerte el resto; para un solo control puede corresponder el disabled nativo.
La inercia no elimina contenido, detiene scripts ni crea una barrera de seguridad; los valores del formulario permanecen y el código puede cambiar el DOM. Al restaurar la interacción, quite el atributo después de sincronizar el estado visible y el destino del foco.
El ejemplo llama a focus() sobre un botón del subárbol inerte, pero document.activeElement permanece en el botón anterior; la propiedad inert vale true y el nodo interno sigue en el DOM.
Ejemplos
<!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
El ejemplo ejecutado verifica el rechazo del foco programático sin eliminar el descendiente del documento.