"escape inertness" mentioned but never explained how to

[mangelozzi]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inert

What specific section or headline is this issue about?

The intro

What information was incorrect, unhelpful, or incomplete?

With the inert attribute, all of the element's flat tree descendants (such as modal <dialog>s) that don't otherwise escape inertness are ignored.

What did you expect to see?

An explanation of how to "escape inertness". Neither this page, nor any of the "See Also" explain how to "escape inertness". If one wish to make everything inert except a certain elements and it's children, I imagine you would apply inert to the document then escape it somehow...

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

Thanks, these docs are very helpful!

MDN metadata

Page report details

• Folder: en-us/web/html/global_attributes/inert
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inert
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/html/global_attributes/inert/index.md
• Last commit: 2f8e24c
• Document last modified: 2024-05-15T03:47:41.000Z

[Josh-Cena]

Relevant spec:

A Document document is blocked by a modal dialog subject if subject is the topmost dialog element in document's top layer. While document is so blocked, every node that is connected to document, with the exception of the subject element and its flat tree descendants, must become inert.

subject can additionally become inert via the inert attribute, but only if specified on subject itself (i.e., subject escapes inertness of ancestors); subject's flat tree descendants can become inert in a similar fashion.

The inert attribute is a boolean attribute that indicates, by its presence, that the element and all its flat tree descendants which don't otherwise escape inertness (such as modal dialogs) are to be made inert by the user agent.