diff --git a/source b/source index 56f8f352ac5..61b573ca298 100644 --- a/source +++ b/source @@ -75069,41 +75069,62 @@ END:VCARD

Inert subtrees

-

This section does not define or create any content attribute - named "inert". This section merely defines an abstract concept of - inertness.

+

See also inert for an explanation of the + attribute of the same name.

A node (in particular elements and text nodes) can be marked as inert. When a node - is inert, then the user agent must act as if the node was absent for the purposes of - targeting user interaction events, may ignore the node for the purposes of - find-in-page, and may prevent the user from selecting text in that node. User agents - should allow the user to override the restrictions on search and text selection, however.

+ is inert:

+ + -

When a node is inert, it generally cannot be focused. Inert nodes that are commands will also get disabled.

+

Inert nodes generally cannot be focused. Inert nodes that are commands will also get disabled.

+ +

User agents may allow the user to override the restrictions on search, text selection, + however.

+ +

By default, an element is not inert.

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 shadow-including - descendants, must be marked inert. (The elements excepted by this paragraph - can additionally be marked inert through other means; being part of a modal dialog - does not "protect" a node from being marked inert.)

+ subject element and its flat tree descendants, must be marked + inert. (The elements excepted by this paragraph can additionally be marked + inert through other means; being part of a modal dialog does not "protect" a node + from being marked inert.)

The dialog element's showModal() method causes this mechanism to trigger, by adding the dialog element to its node + data-x="dom-dialog-showModal">showModal() method causes this mechanism to trigger, by + adding the dialog element to its node document's top layer.

+

The inert attribute

+ +

The inert attribute is a boolean attribute that + indicates, by its presence, that the element and all its flat tree descendants are + to be made inert by the user agent.

+ +

By default, there is no persistent visual indication of a subtree being inert. + Authors are encouraged to clearly mark what parts of their document are active and which are + inert, to avoid user confusion. In particular, it is worth remembering that not all users can see + all parts of a page at once; for example, users of screen readers, users on small devices or + with magnifiers, and even users just using particularly small windows might not be able to see + the active part of a page and might get frustrated if inert sections are not obviously inert. For + individual controls, the disabled attribute is probably + more appropriate.

+

The inert IDL attribute must reflect + the content attribute of the same name.

Tracking user activation