XPath 入门教程 XPath 备忘单

这是一个XPath选择器备忘单，其中列出了常用的 XPath 定位方法和 CSS 选择器

XPath 选择器

入门

• Xpath 测试台(whitebeam.org)

在 Firefox 或 Chrome 控制台中测试：

$x('/html/body')
$x('//h1')
$x('//h1')[0].innerText
$x('//a[text()="XPath"]')[0].click()

后代选择器

下标选择器

属性选择器

相邻兄弟选择

jQuery

杂项选择器

XPath 表达式

步骤（Step）和轴（Axis）

前缀

轴

XPath 谓语

谓语

//div[true()]
//div[@class="head"]
//div[@class="head"][@id="top"]

仅当某些条件为真时才限制节点集。它们可以被链接起来。

运算符

# Comparison
//a[@id = "xyz"]
//a[@id != "xyz"]
//a[@price > 25]

# Logic (and/or)
//div[@id="head" and position()=2]
//div[(x and y) or not(z)]

使用节点

# Use them inside functions
//ul[count(li) > 2]
//ul[count(li[@class='hide']) > 0]

# Returns `<ul>` that has a `<li>` child
//ul[li]

您可以在谓词中使用节点。

索引

//a[1]                # first <a>
//a[last()]           # last <a>
//ol/li[2]            # second <li>
//ol/li[position()=2] # same as above
//ol/li[position()>1] #:not(:first-child)

使用[]带数字或last()或position()。

链式顺序

a[1][@href='/']
a[@href='/'][1]

顺序很重要，这两者是不同的。

嵌套谓语

//section[.//h1[@id='hi']]

<section>如果它有一个<h1>后代，则返回id='hi'。

XPath 函数

节点函数

name()            # //[starts-with(name(), 'h')]
text()            # //button[text()="Submit"]
                  # //button/text()
lang(str)
namespace-uri()

count()           # //table[count(tr)=1]
position()        # //ol/li[position()=2]

字符串函数

contains()        # font[contains(@class,"head")]
starts-with()     # font[starts-with(@class,"head")]
ends-with()       # font[ends-with(@class,"head")]

concat(x,y)
substring(str, start, len)
substring-before("01/02", "/")  #=> 01
substring-after("01/02", "/")   #=> 02
translate()
normalize-space()
string-length()

布尔函数

not(expr)         # button[not(starts-with(text(),"Submit"))]

类型转换

string()
number()
boolean()

XPath 轴

使用轴

//ul/li                       # ul > li
//ul/child::li                # ul > li (same)
//ul/following-sibling::li    # ul ~ li
//ul/descendant-or-self::li   # ul li
//ul/ancestor-or-self::li     # $('ul').closest('li')

表达式的步骤由 分隔/，通常用于选择子节点。这并不总是正确的：您可以使用::.

子轴

# both the same
//ul/li/a
//child::ul/child::li/child::a

child::是默认轴。这使//a/b/c工作。

# both the same
# this works because `child::li` is truthy
//ul[li]
//ul[child::li]

# both the same
//ul[count(li) > 2]
//ul[count(child::li) > 2]

后代或自我轴

# both the same
//div//h4
//div/descendant-or-self::h4

//是descendant-or-self::轴的缩写。

# both the same
//ul//[last()]
//ul/descendant-or-self::[last()]

其他轴

您还可以使用其他轴。

Union（|）运算符

//a | //span

使用|连接两个表达式。

XPath 更多例子

例子

//*                 # all elements
count(//*)          # count all elements
(//h1)[1]/text()    # text of the first h1 heading
//li[span]          # find a <li> with an <span> inside it
                    # ...expands to //li[child::span]
//ul/li/..          # use .. to select a parent

获取父级

//section[h1[@id='section-name']]

找到一个<section>直接包含的h1#section-name

//section[//h1[@id='section-name']]

查找<section>包含h1#section-name. （同上，但使用后代或自我而不是孩子）

最近的

./ancestor-or-self::[@class="box"]

像 jQuery 的$().closest('.box').

属性

//item[@price > 2*@discount]

查找<item>并检查其属性

另见

• Devhints (devhints.io)
• Xpath 测试台(whitebeam.org)