Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

termin lub wartość HTML: inert

Atrybut `inert` wyłącza interakcję użytkownika z całym poddrzewem, w tym fokus i aktywację, pozostawiając jego węzły oraz stan aplikacji w DOM.

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

Składnia

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

inert jest atrybutem logicznym, więc sama obecność włącza stan; zapis inert="false" nadal oznacza aktywny inert. Stan obejmuje potomków płaskiego drzewa, które nie mogą być celem fokusu ani zdarzeń kliknięcia użytkownika i są pomijane przez technologie asystujące.

Nie wolno pozostawiać widocznej bezczynnej treści wyglądającej jak aktywna: trzeba ją ukryć albo odpowiednio wizualnie przesłonić, aby stan był jednoznaczny. Modal otwarty przez showModal() wymyka się bezczynności przodków, chyba że sam ma inert, i czyni resztę dokumentu bezczynną; dla jednej kontrolki właściwszy może być natywny disabled.

Bezczynność nie usuwa treści, nie blokuje skryptów i nie jest granicą bezpieczeństwa; wartości formularza mogą nadal istnieć i kod może zmieniać DOM. Przywracając interakcję, usuń atrybut dopiero po zsynchronizowaniu widocznego stanu i miejsca fokusu.

Przykład wywołuje focus() na przycisku wewnątrz bezczynnego poddrzewa, lecz document.activeElement pozostaje na poprzednim przycisku; właściwość inert ma wartość true, a wewnętrzny węzeł nadal jest w DOM.

Przykłady

<!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>

Wynik

inert=true; active=before; inDom=true

Wykonany przykład potwierdza odrzucenie programowej próby fokusu bez usunięcia potomka z dokumentu.

Źródła