Merge ff6c36b into b8e5065

fb55 · web-flow · commit 81af3e85260c · 2022-12-30T12:01:16.000Z
diff --git a/README.md b/README.md
@@ -168,79 +168,129 @@ for an implementation backed by the DOM.
 
 _As defined by CSS 4 and / or jQuery._
 
--   [Selector lists](https://developer.mozilla.org/en-US/docs/Web/CSS/Selector_list)
-    (`,`)
--   [Universal](https://developer.mozilla.org/en-US/docs/Web/CSS/Universal_selectors)
-    (`*`)
 -   [Type](https://developer.mozilla.org/en-US/docs/Web/CSS/Type_selectors)
-    (`<tagname>`)
+    (`<tagname>`): Selects elements by their tag name.
 -   [Descendant](https://developer.mozilla.org/en-US/docs/Web/CSS/Descendant_combinator)
-    (` `)
+    (` `): Selects elements that are descendants of the specified element.
 -   [Child](https://developer.mozilla.org/en-US/docs/Web/CSS/Child_combinator)
-    (`>`)
--   Parent (`<`)
+    (`>`): Selects elements that are direct children of the specified element.
+-   Parent (`<`): Selects elements that are direct parents of the specified
+    element.
 -   [Adjacent sibling](https://developer.mozilla.org/en-US/docs/Web/CSS/Adjacent_sibling_combinator)
-    (`+`)
+    (`+`): Selects elements that are the next sibling of the specified element.
 -   [General sibling](https://developer.mozilla.org/en-US/docs/Web/CSS/General_sibling_combinator)
-    (`~`)
+    (`~`): Selects elements that are siblings of the specified element.
 -   [Attribute](https://developer.mozilla.org/en-US/docs/Web/CSS/Attribute_selectors)
     (`[attr=foo]`), with supported comparisons:
-    -   `[attr]` (existential)
-    -   `=`
-    -   `~=`
-    -   `|=`
-    -   `*=`
-    -   `^=`
-    -   `$=`
-    -   `!=`
+    -   `[attr]` (existential): Selects elements with the specified attribute,
+        whatever its value.
+    -   `=`: Selects elements with the specified attribute and value.
+    -   `~=`: Selects elements with the specified attribute and value, separated
+        by spaces.
+    -   `|=`: Selects elements with the specified attribute and value, separated
+        by hyphens.
+    -   `*=`: Selects elements with the specified attribute and value, anywhere
+        in the attribute value.
+    -   `^=`: Selects elements with the specified attribute and value, beginning
+        at the beginning of the attribute value.
+    -   `$=`: Selects elements with the specified attribute and value, ending at
+        the end of the attribute value.
+    -   `!=`: Selects elements with the specified attribute and value, not equal
+        to the specified value.
     -   `i` and `s` can be added after the comparison to make the comparison
         case-insensitive or case-sensitive (eg. `[attr=foo i]`). If neither is
         supplied, css-select will follow the HTML spec's
         [case-sensitivity rules](https://html.spec.whatwg.org/multipage/semantics-other.html#case-sensitivity-of-selectors).
+-   [Selector lists](https://developer.mozilla.org/en-US/docs/Web/CSS/Selector_list)
+    (`,`): Selects elements that match any of the specified selectors.
+-   [Universal](https://developer.mozilla.org/en-US/docs/Web/CSS/Universal_selectors)
+    (`*`): Selects all elements.
 -   Pseudos:
-    -   [`:not`](https://developer.mozilla.org/en-US/docs/Web/CSS/:not)
-    -   [`:contains`](https://api.jquery.com/contains-selector)
-    -   `:icontains` (case-insensitive version of `:contains`)
-    -   [`:has`](https://developer.mozilla.org/en-US/docs/Web/CSS/:has)
-    -   [`:root`](https://developer.mozilla.org/en-US/docs/Web/CSS/:root)
-    -   [`:empty`](https://developer.mozilla.org/en-US/docs/Web/CSS/:empty)
-    -   [`:parent`](https://api.jquery.com/parent-selector)
-    -   [`:first-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:first-child),
-        [`:last-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:last-child),
-        [`:first-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:first-of-type),
-        [`:last-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:last-of-type)
-    -   [`:only-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:only-of-type),
-        [`:only-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:only-child)
-    -   [`:nth-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-child),
-        [`:nth-last-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-last-child),
-        [`:nth-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-of-type),
-        [`:nth-last-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-last-of-type),
-    -   [`:link`](https://developer.mozilla.org/en-US/docs/Web/CSS/:link),
-        [`:any-link`](https://developer.mozilla.org/en-US/docs/Web/CSS/:any-link)
+    -   [`:not`](https://developer.mozilla.org/en-US/docs/Web/CSS/:not): Selects
+        elements that do not match the specified selector.
+    -   [`:contains`](https://api.jquery.com/contains-selector): Selects
+        elements that contain the specified text.
+    -   `:icontains`: Selects elements that contain the specified text,
+        case-insensitively.
+    -   [`:has`](https://developer.mozilla.org/en-US/docs/Web/CSS/:has): Selects
+        elements that have descendants that match the specified selector.
+    -   [`:root`](https://developer.mozilla.org/en-US/docs/Web/CSS/:root):
+        Selects the root element.
+    -   [`:empty`](https://developer.mozilla.org/en-US/docs/Web/CSS/:empty):
+        Selects elements that have no children.
+    -   [`:first-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:first-child):
+        Selects elements that are the first element child of their parent.
+    -   [`:last-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:last-child):
+        Selects elements that are the last element child of their parent.
+    -   [`:first-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:first-of-type):
+        Selects elements that are the first element of their type.
+    -   [`:last-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:last-of-type):
+        Selects elements that are the last element of their type.
+    -   [`:only-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:only-of-type):
+        Selects elements that are the only element of their type.
+    -   [`:only-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:only-child):
+        Selects elements that are the only element child of their parent.
+    -   [`:nth-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-child):
+        Selects elements that are the nth element child of their parent.
+    -   [`:nth-last-child`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-last-child):
+        Selects elements that are the nth element child of their parent,
+        counting from the last child.
+    -   [`:nth-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-of-type):
+        Selects elements that are the nth element of their type.
+    -   [`:nth-last-of-type`](https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-last-of-type):
+        Selects elements that are the nth element of their type, counting from
+        the last child.
+    -   [`:any-link`](https://developer.mozilla.org/en-US/docs/Web/CSS/:any-link):
+        Selects elements that are links.
+    -   [`:link`](https://developer.mozilla.org/en-US/docs/Web/CSS/:link):
+        Selects elements that are links and have not been visited.
     -   [`:visited`](https://developer.mozilla.org/en-US/docs/Web/CSS/:visited),
         [`:hover`](https://developer.mozilla.org/en-US/docs/Web/CSS/:hover),
         [`:active`](https://developer.mozilla.org/en-US/docs/Web/CSS/:active)
         (these depend on optional `Adapter` methods, so these will only match
         elements if implemented in `Adapter`)
-    -   [`:selected`](https://api.jquery.com/selected-selector),
-        [`:checked`](https://developer.mozilla.org/en-US/docs/Web/CSS/:checked)
-    -   [`:enabled`](https://developer.mozilla.org/en-US/docs/Web/CSS/:enabled),
-        [`:disabled`](https://developer.mozilla.org/en-US/docs/Web/CSS/:disabled)
-    -   [`:required`](https://developer.mozilla.org/en-US/docs/Web/CSS/:required),
-        [`:optional`](https://developer.mozilla.org/en-US/docs/Web/CSS/:optional)
-    -   [`:header`](https://api.jquery.com/header-selector),
-        [`:button`](https://api.jquery.com/button-selector),
-        [`:input`](https://api.jquery.com/input-selector),
-        [`:text`](https://api.jquery.com/text-selector),
-        [`:checkbox`](https://api.jquery.com/checkbox-selector),
-        [`:file`](https://api.jquery.com/file-selector),
-        [`:password`](https://api.jquery.com/password-selector),
-        [`:reset`](https://api.jquery.com/reset-selector),
-        [`:radio`](https://api.jquery.com/radio-selector) etc.
-    -   [`:is`](https://developer.mozilla.org/en-US/docs/Web/CSS/:is), plus its
-        legacy alias `:matches`
-    -   [`:scope`](https://developer.mozilla.org/en-US/docs/Web/CSS/:scope)
-        (uses the context from the passed options)
+    -   [`:checked`](https://developer.mozilla.org/en-US/docs/Web/CSS/:checked):
+        Selects `input` elements that are checked, or `option` elements that are
+        selected.
+    -   [`:disabled`](https://developer.mozilla.org/en-US/docs/Web/CSS/:disabled):
+        Selects input elements that are disabled.
+    -   [`:enabled`](https://developer.mozilla.org/en-US/docs/Web/CSS/:enabled):
+        Selects input elements that are not disabled.
+    -   [`:required`](https://developer.mozilla.org/en-US/docs/Web/CSS/:required):
+        Selects input elements that are required.
+    -   [`:optional`](https://developer.mozilla.org/en-US/docs/Web/CSS/:optional):
+        Selects input elements that are not required.
+    -   jQuery extensions:
+        -   [`:parent`](https://api.jquery.com/parent-selector): Selects
+            elements that have at least one child.
+        -   [`:header`](https://api.jquery.com/header-selector): Selects header
+            elements.
+        -   [`:selected`](https://api.jquery.com/selected-selector): Selects
+            `option` elements that are selected.
+        -   [`:button`](https://api.jquery.com/button-selector): Selects button
+            elements, and `input` elements of type `button`.
+        -   [`:input`](https://api.jquery.com/input-selector): Selects `input`,
+            `textarea`, `select`, and `button` elements.
+        -   [`:text`](https://api.jquery.com/text-selector): Selects `input`
+            elements of type `text`.
+        -   [`:checkbox`](https://api.jquery.com/checkbox-selector): Selects
+            `input` elements of type `checkbox`.
+        -   [`:file`](https://api.jquery.com/file-selector): Selects `input`
+            elements of type `file`.
+        -   [`:password`](https://api.jquery.com/password-selector): Selects
+            `input` elements of type `password`.
+        -   [`:reset`](https://api.jquery.com/reset-selector): Selects `input`
+            elements of type `reset`.
+        -   [`:radio`](https://api.jquery.com/radio-selector): Selects `input`
+            elements of type `radio`.
+    -   [`:is`](https://developer.mozilla.org/en-US/docs/Web/CSS/:is), as well
+        as the aliases
+        [`:where`](https://developer.mozilla.org/en-US/docs/Web/CSS/:where), and
+        the legacy alias `:matches`: Selects elements that match any of the
+        given selectors.
+    -   [`:scope`](https://developer.mozilla.org/en-US/docs/Web/CSS/:scope):
+        Selects elements that are part of the scope of the current selector.
+        This uses the context from the passed options.
 
 ---
 
