跳到主要内容

🔦 语法速查表


✅️ 定位语法

📌 基本用法

写法精确匹配模糊匹配匹配开头匹配结尾说明
@属性名@属性名=@属性名:@属性名^@属性名$按某个属性查找
@!属性名@!属性名=@!属性名:@!属性名^@!属性名$查找属性不符合指定条件的元素
texttext=text:或不写text^text$按某个文本查找
@text()@text()=@text():text()^text()$text@@@配合使用时改为text(),常用于多条件匹配
tagtag=tag:查找某个类型的元素
@tag()@tag()=@tag():组合使用时查找某个类型的元素
xpathxpath=xpath:用 xpath 方式查找元素
csscss=css:用 css selector 方式查找元素

📌 组合用法

写法说明
@@属性1@@属性2匹配属性同时符合多个条件的元素
@@属性1@!属性2多属性匹配与否定匹配同时使用
`@属性1@
tag:xx@属性名tag与属性匹配共同使用
tag:xx@@属性1@@属性2tag与多属性匹配共同使用
`tag:xx@属性1@
tab:@@text()=文本@@属性tab与文本和属性匹配共同使用

📌 简化写法

原写法简化写法精确匹配模糊匹配匹配开头匹配结尾备注
@id###=#:#^#$简化写法只能单独使用
@class...=.:.^.$简化写法只能单独使用
tagtt:t=只能用在句首
@tag()@t()@t():@t()=可作为属性组合使用
texttxtx=tx:或不写tx^tx$无标签时使用模糊匹配文本
@text()@tx()@tx()=@tx():@tx()^@tx()$可作为属性组合使用
xpathxx:x=只能单独使用
csscc:c=只能单独使用

✅️ 相对定位

方法说明
parent()查找当前元素某一级父元素
child()查找当前元素的一个直接子节点
children()查找当前元素全部符合条件的直接子节点
next()查找当前元素之后第一个符合条件的兄弟节点
nexts()查找当前元素之后所有符合条件的兄弟节点
prev()查找当前元素之前第一个符合条件的兄弟节点
prevs()查找当前元素之前所有符合条件的兄弟节点
after()查找文档中当前元素之后第一个符合条件的节点
afters()查找文档中当前元素之后所有符合条件的节点
before()查找文档中当前元素之前第一个符合条件的节点
befores()查找文档中当前元素之前所有符合条件的节点

✅️ iframe 和 shadow root

方法简化写法说明备注
get_frame()在页面中查找一个<iframe>元素只有页面对象有此方法
shadow_rootsr获取当前元素内的 shadow root 对象只有元素对象有此属性

✅️ 特殊字符对照表

要匹配的文本中如包含特殊字符(如'&nbsp;''&gt;'),需将特殊字符转为十六进制,对照表如下:

特殊符号命名实体编码特殊符号命名实体编码特殊符号命名实体编码
Α&Alpha;\u0391Β&Beta;\u0392Γ&Gamma;\u0393
Δ&Delta;\u0394Ε&Epsilon;\u0395Ζ&Zeta;\u0396
Η&Eta;\u0397Θ&Theta;\u0398Ι&Iota;\u0399
Κ&Kappa;\u039AΛ&Lambda;\u039BΜ&Mu;\u039C
Ν&Nu;\u039DΞ&Xi;\u039EΟ&Omicron;\u039F
Π&Pi;\u03A0Ρ&Rho;\u03A1Σ&Sigma;\u03A3
Τ&Tau;\u03A4Υ&Upsilon;\u03A5Φ&Phi;\u03A6
Χ&Chi;\u03A7Ψ&Psi;\u03A8Ω&Omega;\u03A9
α&alpha;\u03B1β&beta;\u03B2γ&gamma;\u03B3
δ&delta;\u03B4ε&epsilon;\u03B5ζ&zeta;\u03B6
η&eta;\u03B7θ&theta;\u03B8ι&iota;\u03B9
κ&kappa;\u03BAλ&lambda;\u03BBμ&mu;\u03BC
ν&nu;\u03BDξ&xi;\u03BEο&omicron;\u03BF
π&pi;\u03C0ρ&rho;\u03C1ς&sigmaf;\u03C2
σ&sigma;\u03C3τ&tau;\u03C4υ&upsilon;\u03C5
φ&phi;\u03C6χ&chi;\u03C7ψ&psi;\u03C8
ω&omega;\u03C9ϑ&thetasym;\u03D1ϒ&upsih;\u03D2
ϖ&piv;\u03D6&bull;\u2022&hellip;\u2026
&prime;\u2032&Prime;\u2033&oline;\u203E
&frasl;\u2044&weierp;\u2118&image;\u2111
&real;\u211C&trade;\u2122&alefsym;\u2135
&larr;\u2190&uarr;\u2191&rarr;\u2192
&darr;\u2193&harr;\u2194&crarr;\u21B5
&lArr;\u21D0&uArr;\u21D1&rArr;\u21D2
&dArr;\u21D3&hArr;\u21D4&forall;\u2200
&part;\u2202&exist;\u2203&empty;\u2205
&nabla;\u2207&isin;\u2208&notin;\u2209
&ni;\u220B&prod;\u220F&sum;\u2212
&minus;\u2212&lowast;\u2217&radic;\u221A
&prop;\u221D&infin;\u221E&ang;\u2220
&and;\u22A5&or;\u22A6&cap;\u2229
&cup;\u222A&int;\u222B&there4;\u2234
&sim;\u223C&cong;\u2245&asymp;\u2245
&ne;\u2260&equiv;\u2261&le;\u2264
&ge;\u2265&sub;\u2282&sup;\u2283
&nsub;\u2284&sube;\u2286&supe;\u2287
&oplus;\u2295&otimes;\u2297&perp;\u22A5
&sdot;\u22C5&lceil;\u2308&rceil;\u2309
&lfloor;\u230A&rfloor;\u230B&loz;\u25CA
&spades;\u2660&clubs;\u2663&hearts;\u2665
&diams;\u2666 &nbsp;\u00A0¡&iexcl;\u00A1
¢&cent;\u00A2£&pound;\u00A3¤&curren;\u00A4
¥&yen;\u00A5¦&brvbar;\u00A6§&sect;\u00A7
¨&uml;\u00A8©&copy;\u00A9ª&ordf;\u00AA
«&laquo;\u00AB¬&not;\u00AC­&shy;\u00AD
®&reg;\u00AE¯&macr;\u00AF°&deg;\u00B0
±&plusmn;\u00B1²&sup2;\u00B2³&sup3;\u00B3
´&acute;\u00B4µ&micro;\u0012"&quot;\u0022
<&lt;\u003C>&gt;\u003E' \u0027