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 event
  • keypress event
  • keyup event
  • - + +
  • The event target concept
  • +
  • The topmost event target concept
  • +

    The 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.

  • @@ -72506,26 +72511,63 @@ 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.

    - -

    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.

    + is inert, then:

    + + + +

    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.

    @@ -72548,7 +72590,27 @@ END:VCARD data-x="top-layer-add">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 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.

    Tracking user activation