The HTMLElement property inert is a boolean value that, when present, makes the browser "ignore" user input events for the element, including focus events and events from assistive technologies. The browser may also ignore page search and text selection in the element. This can be useful when building UIs such as modals where you would want to "trap" the focus inside the modal when it's visible.
HTMLElement.inert
Syntax
isInert = HTMLElement.inert; HTMLElement.inert = true | false;
Value
A Boolean which is true if the element is inert; otherwise, the value is false.
Example
HTML
<div> <label for="button1">Button 1</label> <button id="button1">I am not inert</button> </div> <div inert> <label for="button2">Button 2</label> <button id="button2">I am inert</button> </div>
CSS
[inert] > * { opacity: .5; }
Note: This attribute, by itself, will not cause any visual change to the content as displayed in the browser. In the example above, CSS has been applied so that any direct descendant of an element with the inert attribute is rendered semi-opaque.
Specifications
| Specification |
|---|
| HTML Standard # dom-inert |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
inert |
60
|
79
|
81
|
No
|
47
|
preview
|
No
|
60
|
No
|
44
|
No
|
No
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert
