diff --git a/source/_posts/xpath.md b/source/_posts/xpath.md index 80fce2b..7f5e74a 100644 --- a/source/_posts/xpath.md +++ b/source/_posts/xpath.md @@ -3,25 +3,25 @@ title: XPath date: 2020-12-19 22:15:43 background: bg-[#77aeeb] tags: - - document - - expression - - select + - document + - expression + - select categories: - - Toolkit + - Toolkit intro: | - This is an [XPath](https://en.wikipedia.org/wiki/XPath) selectors cheat sheet, which lists commonly used XPath positioning methods and CSS selectors + This is an [XPath](https://en.wikipedia.org/wiki/XPath) selectors cheat sheet, which lists commonly used XPath positioning methods and CSS selectors plugins: - - copyCode + - copyCode --- -XPath Selectors {.cols-6} --------- +## XPath Selectors {.cols-6} ### Getting started {.col-span-2} - [Xpath test bed](http://www.whitebeam.org/library/guide/TechNotes/xpathtestbed.rhtm) _(whitebeam.org)_ Test in Firefox or Chrome console: + ```console $x('/html/body') $x('//h1') @@ -29,39 +29,37 @@ $x('//h1')[0].innerText $x('//a[text()="XPath"]')[0].click() ``` - - -### Descendant selectors {.col-span-2} +### Descendant selectors {.col-span-2} | Xpath | CSS | -|--------------|--------------| +| ------------ | ------------ | | `//h1` | h1 | | `//div//p` | div p | | `//ul/li` | ul > li | | `//ul/li/a` | ul > li > a | -| `//div/*` | div > * | +| `//div/*` | div > \* | | `/` | :root | | `/html/body` | :root > body | + {.show-header} - -### Order selectors {.col-span-2} +### Order selectors {.col-span-2} | Xpath | CSS | -|---------------------|----------------------| +| ------------------- | -------------------- | | `//ul/li[1]` | ul > li:first-child | | `//ul/li[2]` | ul > li:nth-child(2) | | `//ul/li[last()]` | ul > li:last-child | | `//li[@id="id"][1]` | li#id:first-child | | `//a[1]` | a:first-child | | `//a[last()]` | a:last-child | -{.show-header} +{.show-header} ### Attribute selectors {.col-span-3 .row-span-2} | Xpath | CSS | -|---------------------------------|----------------------| +| ------------------------------- | -------------------- | | `//*[@id="id"]` | #id | | `//*[@class="class"]` | .class | | `//input[@type="submit"]` | input[type="submit"] | @@ -71,31 +69,34 @@ $x('//a[text()="XPath"]')[0].click() | `//a[ends-with(@href, '.pdf')]` | a[href$='pdf'] | | `//a[contains(@href, '://')]` | a[href*='`:`//'] | | `//a[contains(@rel, 'help')]` | a[rel~='help'] | + {.show-header} +### Siblings {.col-span-3} -### Siblings {.col-span-3} | Xpath | CSS | -|--------------------------------------|----------| +| ------------------------------------ | -------- | | `//h1/following-sibling::ul` | h1 ~ ul | | `//h1/following-sibling::ul[1]` | h1 + ul | | `//h1/following-sibling::[@id="id"]` | h1 ~ #id | + {.show-header} - ### jQuery {.col-span-3} + | Xpath | CSS | -|----------------------------------|----------------------------| +| -------------------------------- | -------------------------- | | `//ul/li/..` | $('ul > li').parent() | | `//li/ancestor-or-self::section` | $('li').closest('section') | | `//a/@href` | $('a').attr('href') | | `//span/text()` | $('span').text() | + {.show-header} +### Misc selectors {.col-span-3} -### Misc selectors {.col-span-3} | Xpath | CSS | -|-----------------------------------|---------------------------| +| --------------------------------- | ------------------------- | --------------------- | | `//h1[not(@id)]` | h1:not([id]) | | `//button[text()="Submit"]` | Text match | | `//button[contains(text(),"Go")]` | Text contains (substring) | @@ -103,46 +104,43 @@ $x('//a[text()="XPath"]')[0].click() | `//ul[*]` | Has children | | `//ul[li]` | Has children (specific) | | `//a[@name or @href]` | Or logic | -| `//a | //div` | Union (joins results) | +| `//a | //div` | Union (joins results) | + {.show-header} - - -XPath Expressions ------------ +## XPath Expressions ### Steps and axes {.secondary} +
| - | - | - | - | -|------|------|------|-----------------| +| ---- | ---- | ---- | --------------- | | `//` | `ul` | `/` | `a[@id='link']` | | Axis | Step | Axis | Step | -{.left-text} +{.left-text} ### Prefixes | Prefix | Example | Means | -|--------|-----------------------|----------| +| ------ | --------------------- | -------- | | `//` | `//hr[@class='edge']` | Anywhere | | `/` | `/html/body/div` | Root | | `./` | `./div/p` | Relative | -{.show-header} +{.show-header} ### Axes | Axis | Example | Means | -|------|---------------------|------------| +| ---- | ------------------- | ---------- | | `/` | `//ul/li/a` | Child | | `//` | `//[@id="list"]//a` | Descendant | + {.show-header} - - -XPath Predicates ----------- +## XPath Predicates ### Predicates @@ -169,7 +167,6 @@ Restricts a nodeset only if some condition is true. They can be chained. //div[(x and y) or not(z)] ``` - ### Using nodes ```bash @@ -214,8 +211,7 @@ Order is significant, these two are different. This returns `
` if it has an `

` descendant with `id='hi'`. -XPath Functions {.cols-2} ---------- +## XPath Functions {.cols-2} ### Node functions @@ -232,7 +228,6 @@ count() # //table[count(tr)=1] position() # //ol/li[position()=2] ``` - ### String functions ```bash @@ -251,7 +246,6 @@ normalize-space() string-length() ``` - ### Boolean functions ```bash @@ -266,8 +260,7 @@ number() boolean() ``` -XPath Axes {.cols-2} ----- +## XPath Axes {.cols-2} ### Using axes @@ -278,14 +271,18 @@ XPath Axes {.cols-2} //ul/descendant-or-self::li # ul li //ul/ancestor-or-self::li # $('ul').closest('li') ``` ----- + +--- + | | | | | -|------|------|------------|------| +| ---- | ---- | ---------- | ---- | | `//` | `ul` | `/child::` | `li` | | Axis | Step | Axis | Step | + {.left-text} -Steps of an expression are separated by `/`, usually used to pick child nodes. That's not always true: you can specify a different "axis" with `::`. +Steps of an expression are separated by `/`, usually used to pick child nodes. That's not always true: you can specify a +different "axis" with `::`. ### Child axis @@ -299,7 +296,7 @@ Steps of an expression are separated by `/`, usually used to pick child nodes. T ```bash # both the same -# this works because `child::li` is truthy +# this works because `child::li` is truthy //ul[li] //ul[child::li] ``` @@ -328,24 +325,22 @@ Steps of an expression are separated by `/`, usually used to pick child nodes. T ### Other axes {.row-span-2} -| Axis | Abbrev | Notes | -|--------------------|--------|-------| -| `ancestor` | | | -| `ancestor-or-self` | | | - +| Axis | Abbrev | Notes | +| -------------------- | ------ | ------------------------------------------------ | +| `ancestor` | | | +| `ancestor-or-self` | | | | `attribute` | `@` | `@href` is short for `attribute::href` | | `child` | | `div` is short for `child::div` | | `descendant` | | | | `descendant-or-self` | `//` | `//` is short for `/descendant-or-self::node()/` | | `namespace` | | | - | `self` | `.` | `.` is short for `self::node()` | | `parent` | `..` | `..` is short for `parent::node()` | - | `following` | | | | `following-sibling` | | | | `preceding` | | | | `preceding-sibling` | | | + {.headers} There are other axes you can use. @@ -358,8 +353,7 @@ There are other axes you can use. Use `|` to join two expressions. -XPath More examples {.cols-2} -------------- +## XPath More examples {.cols-2} ### Examples @@ -377,14 +371,14 @@ count(//*) # count all elements ```bash //section[h1[@id='section-name']] ``` + Finds a `
` that directly contains `h1#section-name` ```bash //section[//h1[@id='section-name']] ``` -Finds a `
` that contains `h1#section-name`. -(Same as above, but uses descendant-or-self instead of child) +Finds a `
` that contains `h1#section-name`. (Same as above, but uses descendant-or-self instead of child) ### Closest @@ -402,11 +396,7 @@ Works like jQuery's `$().closest('.box')`. Finds `` and check its attributes -Also see --------- -* [Devhints](https://devhints.io/xpath) _(devhints.io)_ -* [Xpath test bed](http://www.whitebeam.org/library/guide/TechNotes/xpathtestbed.rhtm) _(whitebeam.org)_ - - - +## Also see +- [Devhints](https://devhints.io/xpath) _(devhints.io)_ +- [Xpath test bed](http://www.whitebeam.org/library/guide/TechNotes/xpathtestbed.rhtm) _(whitebeam.org)_