diff --git a/source b/source index 1df0a0cc4b4..06a1ef7b01e 100644 --- a/source +++ b/source @@ -3866,6 +3866,8 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
  • type selector
  • attribute selector
  • pseudo-class
  • +
  • :focus-visible
  • The following features are defined in CSS Values and Units: ElementInternals { boolean reportValidity(); readonly attribute NodeList labels; + + // Focus management + attribute DOMString focusBehavior; }; dictionary ValidityStateFlags { @@ -68145,6 +68150,19 @@ dictionary ValidityStateFlags { internals's target element is associated with.

    +
    internals . focusBehavior + [ = value ]
    +
    +

    Returns the focus behavior of the + internals's target element. Possible values + are "default", "focusable", and "simple-control". If an unknown value was set, + this returns "focusable".

    + +

    Can be set, to change the focus behavior to the new + value.

    +

    Each ElementInternals has a target element, @@ -68352,6 +68370,60 @@ dictionary ValidityStateFlags { submission value.

    +
    + +

    Each autonomous custom element has focus + behavior string, initially "default". It also + can be "focusable" or "simple-control". These values have the following + impacts:

    + +
    +
    "default"
    +
    +

    The element is not focusable by default. The element's focus-related behavior + is same as elements like div, which are not focusable by default.

    + +

    There are ways for authors to make an element with "default" focus + behavior focusable, e.g., adding a tabindex or contenteditable content attribute.

    +
    + +
    "focusable"
    +

    The element is focusable by default. The element's focus-related behavior is + same as general focusable elements such as editing + hosts.

    + +
    "simple-control"
    +
    +

    The element is focusable by default. The element's focus-related behavior is + same as simple controls like button elements.

    + +

    Behavior differences between "focusable" and "simple-control" depend on the user agent. They + might affect sequential focusability, click focusability, or the :focus-visible pseudo-class.

    +
    +
    + + +

    The focusBehavior IDL + attribute, on getting, must return the focus behavior of + this ElementInternals's target element. On + setting, if the new string is one of "default", + "focusable", or "simple-control", then set the focus behavior of this ElementInternals's target element to the given value. Otherwise, set it to "focusable".

    + +

    Setting focusBehavior to + an unknown value does not throw because new values might be added in the future, and user agents + without support for the new value have to work somehow with documents using the new keyword.

    Common idioms without dedicated elements

    @@ -73466,8 +73538,13 @@ END:VCARD Elements that meet all the following criteria: +

    For focusable areas that are + autonomous custom elements, user agents should + consider the element's focus behavior in determining + whether the element is click focusable or sequentially focusable.

    +

    Elements which are not focusable are not focusable areas, and thus not sequentially focusable and not click focusable.

    @@ -73864,7 +73946,7 @@ END:VCARD
    -
    If the value is null
    +
    If the value is null
    @@ -73911,6 +73993,10 @@ END:VCARD
  • Editing hosts
  • Browsing context containers
  • + +
  • Autonomous custom elements whose focus behavior is not "default".