diff --git a/source b/source index 1433c4edf06..059cadfab44 100644 --- a/source +++ b/source @@ -74071,25 +74071,25 @@ END:VCARD
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.
- -For example, consider a page that consists of just a single inert
- paragraph positioned in the middle of a body
. If a user moves their pointing device
- from the body
over to the inert paragraph and clicks on the paragraph,
- no mouseover
event would be fired, and the mousemove
and click
events would
- be fired on the body
element rather than the paragraph.
When a node is inert, it generally cannot be focused. Inert nodes that are inert:
+ +It behaves as if the pointer-events CSS property were set to the value none.
It generally cannot be focused. Inert nodes that are commands will also get disabled.
+Selecting text in that node may be prevented by the user agent.
The user agent may ignore the node for the purposes of text search user interfaces + (commonly known as "find in page").
User agents may allow the user to override the restrictions on search, text selection, + however.
+ +By default, an element is not inert.
While a browsing context container is marked as inert, its
nested browsing context's active document, and all nodes in that
@@ -74113,7 +74113,27 @@ END:VCARD
data-x="top-layer-add">adding the dialog
element to its node
document's top layer.
inert
attributeThe inert
attribute is a boolean attribute that
+ indicates, by its presence, that the element and all its shadow-including descendants is to be
+ made inert.
While an element has an inert
attribute, the user
+ agent must mark that element and all its flat tree descendants as
+ inert. The topmost dialog
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.