@webref/css 6.1.0 → 6.2.0

package/selectors.json

@@ -16,7 +16,7 @@
     },
     {
       "name": ":not()",
-      "prose": "The negation pseudo-class, :not(), is a functional pseudo-class taking a selector list as an argument. It represents an element that is not represented by its argument."
+      "prose": "The negation pseudo-class, :not(), is a functional pseudo-class taking a <complex-real-selector-list> as an argument. It represents an element that is not represented by its argument."
     },
     {
       "name": ":where()",
@@ -24,7 +24,7 @@
     },
     {
       "name": ":has()",
-      "prose": "The relational pseudo-class, :has(), is a functional pseudo-class taking a <forgiving-relative-selector-list> as an argument. It represents an element if any of the relative selectors would match at least one element when anchored against this element."
+      "prose": "The relational pseudo-class, :has(), is a functional pseudo-class taking a <relative-selector-list> as an argument. It represents an element if any of the relative selectors would match at least one element when anchored against this element."
     },
     {
       "name": ":defined",
@@ -68,23 +68,23 @@
     },
     {
       "name": ":hover",
-      "prose": "The :hover pseudo-class applies while the user designates an element with a pointing device, but does not necessarily activate it. For example, a visual user agent could apply this pseudo-class when the cursor (mouse pointer) hovers over a box generated by the element. Interactive user agents that cannot detect hovering due to hardware limitations (e.g., a pen device that does not detect hovering) are still conforming; the selector will simply never match in such a UA."
+      "prose": "The :hover pseudo-class applies while the user designates an element (or pseudo-element) with a pointing device, but does not necessarily activate it. For example, a visual user agent could apply this pseudo-class when the cursor (mouse pointer) hovers over a box generated by the element. Interactive user agents that cannot detect hovering due to hardware limitations (e.g., a pen device that does not detect hovering) are still conforming; the selector will simply never match in such a UA."
     },
     {
       "name": ":active",
-      "prose": "The :active pseudo-class applies while an element is being activated by the user. For example, between the times the user presses the mouse button and releases it. On systems with more than one mouse button, :active applies only to the primary or primary activation button (typically the \"left\" mouse button), and any aliases thereof."
+      "prose": "The :active pseudo-class applies while an element is being “activated” by the user, as defined by the host language; for example, while a hyperlink is being triggered."
     },
     {
       "name": ":focus",
-      "prose": "The :focus pseudo-class applies while an element has the focus (accepts keyboard or mouse events, or other forms of input)."
+      "prose": "The :focus pseudo-class applies while an element (or pseudo-element) has the focus (accepts keyboard or other forms of input)."
     },
     {
       "name": ":focus-visible",
-      "prose": "While the :focus pseudo-class always matches the currently-focused element, UAs only sometimes visibly indicate focus (such as by drawing a “focus ring”), instead using a variety of heuristics to visibly indicate the focus only when it would be most helpful to the user. The :focus-visible pseudo-class matches a focused element in these situations only, allowing authors to change the appearance of the focus indicator without changing when a focus indicator appears."
+      "prose": "While the :focus pseudo-class always matches the currently-focused element, UAs only sometimes visibly indicate focus (such as by drawing a “focus ring”), instead using a variety of heuristics to visibly indicate the focus only when it would be most helpful to the user. The :focus-visible pseudo-class matches a focused element (or pseudo-element) in these situations only, allowing authors to change the appearance of the focus indicator without changing when a focus indicator appears."
     },
     {
       "name": ":focus-within",
-      "prose": "The :focus-within pseudo-class applies to any element for which the :focus pseudo class applies as well as to an element whose descendant in the flat tree (including non-element nodes, such as text nodes) matches the conditions for matching :focus."
+      "prose": "The :focus-within pseudo-class applies to any element (or pseudo-element) for which the :focus pseudo class applies, as well as to an element (or pseudo-element) whose descendant in the flat tree (including non-element nodes, such as text nodes) matches the conditions for matching :focus."
     },
     {
       "name": ":current",
@@ -232,11 +232,11 @@
     },
     {
       "name": ":nth-child()",
-      "prose": "The :nth-child(An+B [of S]? ) pseudo-class notation represents elements that are among An+Bth elements from the list composed of their inclusive siblings that match the selector list S, which is a <complex-selector-list> parsed as a forgiving selector list. If S is omitted, it defaults to *|*."
+      "value": ":nth-child(An+B [of S]? )"
     },
     {
       "name": ":nth-last-child()",
-      "prose": "The :nth-last-child(An+B [of S]? ) pseudo-class notation represents elements that are among An+Bth elements from the list composed of their inclusive siblings that match the selector list S, counting backwards from the end. S is <complex-selector-list> parsed as a forgiving selector list. If S is omitted, it defaults to *|*."
+      "value": ":nth-last-child(An+B [of S]? )"
     },
     {
       "name": ":first-child",
@@ -252,11 +252,11 @@
     },
     {
       "name": ":nth-of-type()",
-      "prose": "The :nth-of-type(An+B) pseudo-class notation represents the same elements that would be matched by :nth-child(|An+B| of S), where S is a type selector and namespace prefix matching the element in question. For example, when considering whether an HTML img element matches this pseudo-class, the S in question is html|img (assuming an appropriate html namespace is declared)."
+      "value": ":nth-of-type(An+B)"
     },
     {
       "name": ":nth-last-of-type()",
-      "prose": "The :nth-last-of-type(An+B) pseudo-class notation represents the same elements that would be matched by :nth-last-child(|An+B| of S), where S is a type selector and namespace prefix matching the element in question. For example, when considering whether an HTML img element matches this pseudo-class, the S in question is html|img (assuming an appropriate html namespace is declared)."
+      "value": ":nth-last-of-type(An+B)"
     },
     {
       "name": ":first-of-type",
@@ -288,11 +288,11 @@
     },
     {
       "name": ":nth-col()",
-      "prose": "The :nth-col(An+B) pseudo-class notation represents a cell element belonging to a column that has An+B-1 columns before it, for any positive integer or zero value of n. Column membership is determined based on the semantics of the document language only: whether and how the elements are presented is not considered. If a cell element belongs to more than one column, it is represented by a selector indicating any of those columns."
+      "value": ":nth-col(An+B)"
     },
     {
       "name": ":nth-last-col()",
-      "prose": "The :nth-last-col(An+B) pseudo-class notation represents a cell element belonging to a column that has An+B-1 columns after it, for any positive integer or zero value of n. Column membership is determined based on the semantics of the document language only: whether and how the elements are presented is not considered. If a cell element belongs to more than one column, it is represented by a selector indicating any of those columns."
+      "value": ":nth-last-col(An+B)"
     }
   ],
   "values": [
@@ -306,6 +306,11 @@
       "type": "type",
       "value": "<complex-selector>#"
     },
+    {
+      "name": "<complex-real-selector-list>",
+      "type": "type",
+      "value": "<complex-real-selector>#"
+    },
     {
       "name": "<compound-selector-list>",
       "type": "type",
@@ -321,9 +326,24 @@
       "type": "type",
       "value": "<relative-selector>#"
     },
+    {
+      "name": "<relative-real-selector-list>",
+      "type": "type",
+      "value": "<relative-real-selector>#"
+    },
     {
       "name": "<complex-selector>",
       "type": "type",
+      "value": "<complex-selector-unit> [ <combinator>? <complex-selector-unit> ]*"
+    },
+    {
+      "name": "<complex-selector-unit>",
+      "type": "type",
+      "value": "[ <compound-selector>? <pseudo-compound-selector>* ]!"
+    },
+    {
+      "name": "<complex-real-selector>",
+      "type": "type",
       "value": "<compound-selector> [ <combinator>? <compound-selector> ]*"
     },
     {
@@ -331,10 +351,20 @@
       "type": "type",
       "value": "<combinator>? <complex-selector>"
     },
+    {
+      "name": "<relative-real-selector>",
+      "type": "type",
+      "value": "<combinator>? <complex-real-selector>"
+    },
     {
       "name": "<compound-selector>",
       "type": "type",
-      "value": "[ <type-selector>? <subclass-selector>* [ <pseudo-element-selector> <pseudo-class-selector>* ]* ]!"
+      "value": "[ <type-selector>? <subclass-selector>* ]!"
+    },
+    {
+      "name": "<pseudo-compound-selector>",
+      "type": "type",
+      "value": "<pseudo-element-selector> <pseudo-class-selector>*"
     },
     {
       "name": "<simple-selector>",
@@ -347,9 +377,9 @@
       "value": "'>' | '+' | '~' | [ '|' '|' ]"
     },
     {
-      "name": "<type-selector>",
+      "name": "<wq-name>",
       "type": "type",
-      "value": "<wq-name> | <ns-prefix>? '*'"
+      "value": "<ns-prefix>? <ident-token>"
     },
     {
       "name": "<ns-prefix>",
@@ -357,9 +387,9 @@
       "value": "[ <ident-token> | '*' ]? '|'"
     },
     {
-      "name": "<wq-name>",
+      "name": "<type-selector>",
       "type": "type",
-      "value": "<ns-prefix>? <ident-token>"
+      "value": "<wq-name> | <ns-prefix>? '*'"
     },
     {
       "name": "<subclass-selector>",
@@ -410,11 +440,6 @@
       "name": "<forgiving-selector-list>",
       "prose": "The <forgiving-selector-list> production instead parses each selector in the list individually, simply ignoring ones that fail to parse, so the remaining selectors can still be used.",
       "type": "type"
-    },
-    {
-      "name": "<forgiving-relative-selector-list>",
-      "prose": "<forgiving-relative-selector-list> is identical to <forgiving-selector-list>, except it parses its components as <relative-selector> rather than <complex-selector>.",
-      "type": "type"
     }
   ]
 }