E:drop
| an E element that can possibly receive a drop
@@ -2019,9 +2026,9 @@ The Activation Pseudo-class: '':active''
The Input Focus Pseudo-class: '':focus''
- The :focus pseudo-class applies while an element
- has the focus (accepts keyboard or mouse events, or other forms of
- input).
+ The :focus pseudo-class applies
+ while an element has the focus
+ (accepts keyboard or mouse events, or other forms of input).
There may be document language or implementation specific limits on
which elements can acquire '':focus''.
@@ -2031,6 +2038,68 @@ The Input Focus Pseudo-class: '':focus''
the same ways must apply to elements matching '':focus'' as well,
except that the parent of an element that matches '':focus'' must not match '':focus''.
+
+The Input Focus-Ring Pseudo-class: '':focus-ring''
+
+ The :focus-ring pseudo-class applies
+ while an element matches the '':focus'' pseudo-class,
+ and the UA determines via heuristics
+ that the focus should be specially indicated on the element
+ (typically via a "focus ring").
+
+
+ For example, UAs typically display focus indicators on text elements
+ whenever they're focused,
+ to draw attention to the fact that keyboard input will affect their contents.
+
+ On the other hand, they typically only display focus indicators on buttons
+ when they were focused by a keyboard interaction
+ (such as tabbing thru the document),
+ because it's not always immediately obvious where the focus will move
+ after such an interaction,
+ but not when they were focused by more "obvious" interactions,
+ like clicking on the button with a mouse pointer.
+
+
+
+ Page authors should follow these guidelines
+ when deciding whether to use '':focus'' or '':focus-ring''
+ to style the focused state of an element:
+
+ * If the element has "native" focus indicator behavior
+ (such as text fields or buttons),
+ use '':focus-ring''.
+ * Otherwise, if the element is emulating a text input,
+ or something else that is intended to receive keyboard interaction,
+ use '':focus''.
+ * Otherwise,
+ use '':focus-ring''.
+
+
+ When UAs choose to specially indicate focus on an element,
+ or whether they specially indicate focus at all,
+ is UA-dependent.
+ Different UAs,
+ the same UA on different operating systems,
+ or the same UA on the same OS,
+ but with different user settings,
+ can make different choices as to when an element matches '':focus-ring''.
+
+
+ The following guidelines are suggested heuristics
+ for choosing when to apply '':focus-ring''
+ to elements without "native" focus ring behavior:
+
+ * If the element received focus via a keyboard interaction,
+ including indirectly,
+ such as triggering a dialog
+ by pressing a button using the keyboard,
+ apply '':focus-ring''.
+ * If a keyboard event occurs while an element is focused,
+ even if the element wasn't focused by a keyboard interaction,
+ apply '':focus-ring''.
+
+
The Generalized Input Focus Pseudo-class: '':focus-within''
|