diff --git a/source b/source index c127ef318d6..42db70e37d2 100644 --- a/source +++ b/source @@ -3053,7 +3053,10 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
keydown
eventkeypress
eventkeyup
eventThe following features are defined in Touch Events:
@@ -55125,6 +55128,8 @@ MIT Room 32-G524 apply">does not apply to this element, throw an "InvalidStateError
" DOMException
.
+ If this element is inert
, return.
Set the selection range with start, end, and direction.
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.
If an event would be fired as a result of user input, such that the + inert element would be the topmost event + target, an alternative event target must be found as + follows:
+Let originalElement be the topmost event + target for the event.
Let candidate be the same element.
Let ineligible be an empty list.
While candidate is inert, or candidate is not an an + ancestor of originalElement in the flat tree:
+Add candidate to ineligible.
Set candidate to the element which would be the topmost event target if all the elements in + ineligible were excluded from consideration, or null if no such element + exists.
If candidate is not null, let candidate be the new event target.
Otherwise, do not fire the event.
The user agent may ignore the node for the purposes of text search user interfaces + (commonly known as "find in page"); and
The user agent may prevent the user from selecting text in that node.
User agents may allow the user to override the restrictions on search and text selection, + however.
+ +Consider a page that consists of just a single inert
+ button
positioned in the middle of a body
. If a user clicks on the
+ button, the click
event would cause no event listeners on
+ button
to be run, and the event would instead be targeted at the body
+ element.
When a node is inert, it generally cannot be focused. Inert nodes that are commands will also get disabled.
+User agents should show the default cursor when a user indicates an element in an inert subtree + using a pointing device.
+ +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
Document
, must be marked as inert.
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.
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.