From ab4e8129d5c94ff96e6c85d0d2b66a04a052b4e5 Mon Sep 17 00:00:00 2001
From: HelenHuang <LinHuang@pollex.com.tw>
Date: 星期四, 09 六月 2022 15:26:15 +0800
Subject: [PATCH] TODO#139888 嚴選配對 - 文案修改
---
PAMapp/node_modules/node-html-parser/node_modules/css-select/README.md | 70 +++++++++++++++++++---------------
1 files changed, 39 insertions(+), 31 deletions(-)
diff --git a/PAMapp/node_modules/node-html-parser/node_modules/css-select/README.md b/PAMapp/node_modules/node-html-parser/node_modules/css-select/README.md
index 63b9c2b..287441a 100644
--- a/PAMapp/node_modules/node-html-parser/node_modules/css-select/README.md
+++ b/PAMapp/node_modules/node-html-parser/node_modules/css-select/README.md
@@ -1,31 +1,36 @@
# css-select [](https://npmjs.org/package/css-select) [](http://travis-ci.com/fb55/css-select) [](https://npmjs.org/package/css-select) [](https://coveralls.io/r/fb55/css-select)
-a CSS selector compiler/engine
+A CSS selector compiler and engine
## What?
-css-select turns CSS selectors into functions that tests if elements match them.
-When searching for elements, testing is executed "from the top", similar to how
-browsers execute CSS selectors.
+As a **compiler**, css-select turns CSS selectors into functions that tests if
+elements match them.
+
+As an **engine**, css-select looks through a DOM tree, searching for elements.
+Elements are tested "from the top", similar to how browsers execute CSS
+selectors.
In its default configuration, css-select queries the DOM structure of the
[`domhandler`](https://github.com/fb55/domhandler) module (also known as
-htmlparser2 DOM). It uses [`domutils`](https://github.com/fb55/domutils) as its
-default adapter over the DOM structure. See Options below for details on
-querying alternative DOM structures.
+htmlparser2 DOM). To query alternative DOM structures, see [`Options`](#options)
+below.
**Features:**
-- Full implementation of CSS3 selectors
-- Partial implementation of jQuery/Sizzle extensions
-- Very high test coverage
-- Pretty good performance
+- �� Full implementation of CSS3 selectors, as well as most CSS4 selectors
+- �� Partial implementation of jQuery/Sizzle extensions (see
+ [cheerio-select](https://github.com/cheeriojs/cheerio-select) for the
+ remaining selectors)
+- ��� High test coverage, including the full test suites from Sizzle, Qwery and
+ NWMatcher.
+- �� Reliably great performance
## Why?
-The traditional approach of executing CSS selectors, named left-to-right
-execution, is to execute every component of the selector in order, from left to
-right _(duh)_. The execution of the selector `a b` for example will first query
+Most CSS engines written in JavaScript execute selectors left-to-right. That
+means thet execute every component of the selector in order, from left to right
+_(duh)_. As an example: For the selector `a b`, these engines will first query
for `a` elements, then search these for `b` elements. (That's the approach of
eg. [`Sizzle`](https://github.com/jquery/sizzle),
[`nwmatcher`](https://github.com/dperini/nwmatcher/) and
@@ -50,10 +55,9 @@
_Wait, what?_
-Okay, so let's suppose we want to compile the selector `a b` again, for
-right-to-left execution. We start by _parsing_ the selector, which means we turn
-the selector into an array of the building-blocks of the selector, so we can
-distinguish them easily. That's what the
+Okay, so let's suppose we want to compile the selector `a b`, for right-to-left
+execution. We start by _parsing_ the selector. This turns the selector into an
+array of the building blocks. That's what the
[`css-what`](https://github.com/fb55/css-what) module is for, if you want to
have a look.
@@ -67,23 +71,26 @@
];
```
-Actually, this array is wrapped in another array, but that's another story
-(involving commas in selectors).
+(Actually, this array is wrapped in another array, but that's another story,
+involving commas in selectors.)
Now that we know the meaning of every part of the selector, we can compile it.
-That's where it becomes interesting.
+That is where things become interesting.
The basic idea is to turn every part of the selector into a function, which
takes an element as its only argument. The function checks whether a passed
element matches its part of the selector: If it does, the element is passed to
-the next turned-into-a-function part of the selector, which does the same. If an
-element is accepted by all parts of the selector, it _matches_ the selector and
-double rainbow ALL THE WAY.
+the next function representing the next part of the selector. That function does
+the same. If an element is accepted by all parts of the selector, it _matches_
+the selector and double rainbow ALL THE WAY.
As said before, we want to do right-to-left execution with all the big O
-improvements nonsense, so elements are passed from the rightmost part of the
+improvements. That means elements are passed from the rightmost part of the
selector (`b` in our example) to the leftmost (~~which would be `c`~~ of course
`a`).
+
+For traversals, such as the _descendant_ operating the space between `a` and
+`b`, we walk up the DOM tree, starting from the element passed as argument.
_//TODO: More in-depth description. Implementation details. Build a spaceship._
@@ -93,10 +100,9 @@
const CSSselect = require("css-select");
```
-**Note:** css-select throws errors when invalid selectors are passed to it,
-contrary to the behavior in browsers, which swallow them. This is done to aid
-with writing css selectors, but can be unexpected when processing arbitrary
-strings.
+**Note:** css-select throws errors when invalid selectors are passed to it.This
+is done to aid with writing css selectors, but can be unexpected when processing
+arbitrary strings.
#### `CSSselect.selectAll(query, elems, options)`
@@ -178,8 +184,10 @@
- `^=`
- `$=`
- `!=`
- - Also, `i` can be added after the comparison to make the comparison
- case-insensitive (eg. `[attr=foo i]`)
+ - `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).
- Pseudos:
- [`:not`](https://developer.mozilla.org/en-US/docs/Web/CSS/:not)
- [`:contains`](https://api.jquery.com/contains-selector)
--
Gitblit v1.8.0