详解JSOUP的Select选择器语法

时间：2022-10-31 11:11:32

本文参考：JSOUP中文文档

问题

你想使用类似于CSS或jQuery的语法来查找和操作元素。

方法

可以使用Element.select(String selector) 和 Elements.select(String selector) 方法实现：

//从本地加载html文件
File input = new File("/tmp/input.html");
Document doc = Jsoup.parse(input, "UTF-8", "http://example.com/");//编码以及HTML页面URL前戳

Elements links = doc.select("a[href]"); //带有href属性的a元素
Elements pngs = doc.select("img[src$=.png]"); //扩展名为.png的图片

Element masthead = doc.select("div.masthead").first(); //class等于masthead的div标签

Elements resultLinks = doc.select("h3.r > a"); //在h3元素之后的a元素

说明

jsoup elements对象支持类似于CSS (或jquery)的选择器语法，来实现非常强大和灵活的查找功能。.

这个select 方法在Document, Element,或Elements对象中都可以使用。且是上下文相关的，因此可实现指定元素的过滤，或者链式选择访问。

Select方法将返回一个Elements集合，并提供一组方法来抽取和处理结果。

Selector选择器概述

  • tagname: 通过标签查找元素，比如：a
  • ns|tag: 通过标签在命名空间查找元素，比如：可以用 fb|name 语法来查找 <fb:name> 元素
  • #id: 通过ID查找元素，比如：#logo
  • .class: 通过class名称查找元素，比如：.masthead
  • [attribute]: 利用属性查找元素，比如：[href]
  • [^attr]: 利用属性名前缀来查找元素，比如：可以用[^data-] 来查找带有HTML5 Dataset属性的元素
  • [attr=value]: 利用属性值来查找元素，比如：[width=500]
  • [attr^=value], [attr$=value], [attr*=value]: 利用匹配属性值开头、结尾或包含属性值来查找元素，比如：[href*=/path/]
  • [attr~=regex]: 利用属性值匹配正则表达式来查找元素，比如： img[src~=(?i)\.(png|jpe?g)]
  • *: 这个符号将匹配所有元素

Selector选择器组合使用

  • el#id: 元素+ID，比如： div#logo
  • el.class: 元素+class，比如： div.masthead
  • el[attr]: 元素+class，比如： a[href]
  • 任意组合，比如：a[href].highlight
  • ancestor child: 查找某个元素下子元素，比如：可以用.body p 查找在”body”元素下的所有 p元素
  • parent > child: 查找某个父元素下的直接子元素，比如：可以用div.content > p 查找 p 元素，也可以用body > * 查找body标签下所有直接子元素
  • siblingA + siblingB: 查找在A元素之前第一个同级元素B，比如：div.head + div
  • siblingA ~ siblingX: 查找A元素之前的同级X元素，比如：h1 ~ p
  • el, el, el:多个选择器组合，查找匹配任一选择器的唯一元素，例如：div.masthead, div.logo

伪选择器selectors

  • :lt(n): 查找哪些元素的同级索引值（它的位置在DOM树中是相对于它的父节点）小于n，比如：td:lt(3) 表示小于三列的元素
  • :gt(n):查找哪些元素的同级索引值大于n``，比如： div p:gt(2)表示哪些div中有包含2个以上的p元素
  • :eq(n): 查找哪些元素的同级索引值与n相等，比如：form input:eq(1)表示包含一个input标签的Form元素
  • :has(seletor): 查找匹配选择器包含元素的元素，比如：div:has(p)表示哪些div包含了p元素
  • :not(selector): 查找与选择器不匹配的元素，比如： div:not(.logo) 表示不包含 class=logo 元素的所有 div 列表
  • :contains(text): 查找包含给定文本的元素，搜索不区分大不写，比如： p:contains(jsoup)
  • :containsOwn(text): 查找直接包含给定文本的元素
  • :matches(regex): 查找哪些元素的文本匹配指定的正则表达式，比如：div:matches((?i)login)
  • :matchesOwn(regex): 查找自身包含文本匹配指定正则表达式的元素
  • 注意：上述伪选择器索引是从0开始的，也就是说第一个元素索引值为0，第二个元素index为1等

可以查看Selector API参考来了解更详细的内容

如何选择多个class值的元素

示例：<ul class="ul-ss-3 jb-xx-ks">

方法:

Elements select = document.select(".ul-ss-3").select(".jb-xx-bw");

或者

Elements select = document.getElementsByClass("ul-ss-3 jb-xx-bw");

Selector API文档

官方API原文：Selector (jsoup Java HTML Parser 1.11.3 API)

Pattern Matches Example
* 任何元素 *
tag 具有给定标签名的元素 div
`* E` 类型E在任何名称空间中的元素。
`ns E` 类型E在名称空间中的元素。
#id 具有“ID”属性ID的元素 div#wrap, #logo
.class 类名为“class”的元素 div.left, .result
[attr] 属性为“attr”(任何值)的元素 a[href], [title]
[^attrPrefix] 属性名称以“attrPrefix”开头的元素。使用HTML5数据集查找元素 [^data-], div[^data-]
[attr=val] 元素的属性为“attr”，值为“val” img[width=500], a[rel=nofollow]
[attr="val"] 元素的属性为“attr”，值为“val” span[hello="Cleveland"][goodbye="Columbus"], a[rel="nofollow"]
[attr^=valPrefix] 元素的属性为“attr”，值以“valPrefix”开头 a[href^=http:]
[attr$=valSuffix] 元素的属性为“attr”，值以“valfix”结尾 img[src$=.png]
[attr*=valContaining] 元素的属性为“attr”，包含属性值“valcontains” a[href*=/search/]
[attr~=*regex*] 元素具有名为“attr”的属性，值与正则表达式匹配 `img[src~=(?i)\.(png
  以上可以按任何顺序合并。 div.header[title]

关系选择器Combinators

Pattern Matches Example
E F 由E元素衍生而来的F元素 div a, .logo h1
E > F F是E的直接子结点 ol > li
E + F 一个F元素，紧接在E的前面 li + li, div.head + div
E ~ F 在F元素前面加上E h1 ~ p
E, F, G 所有匹配元素E F G a[href], div, h3

Pseudo selectors

Pattern Matches Example
:lt(*n*) 其同胞指数小于n的元素 td:lt(3) 找到每一行的前3个单元格
:gt(*n*) 其同胞指数大于n的元素 td:gt(1) 在跳过前两个单元后查找单元格
:eq(*n*) 其同胞指数等于n的元素 td:eq(0) 找到每一行的第一个单元格
:has(*selector*) 包含至少一个与选择器匹配的元素的元素 div:has(p) 查找包含p元素的div
:not(*selector*) 不匹配选择器的元素。参见Elements.not(String) div:not(.logo) 查找所有没有“logo”类的divs。 div:not(:has(div)) 查找不包含div的div。
:contains(*text*) 包含指定文本的元素。搜索是大小写不敏感的。文本可以出现在找到的元素中，也可以出现在它的任何后代元素中。 p:contains(jsoup) 查找包含“jsoup”文本的p元素。
:matches(*regex*) 其文本与指定正则表达式匹配的元素。文本可以出现在找到的元素中，也可以出现在它的任何后代元素中。 td:matches(\\d+) 查找包含数字的表单元格。 div:matches((?i)login) 找到包含文本的div，不敏感的情况。
:containsOwn(*text*) 直接包含指定文本的元素。搜索是大小写不敏感的。文本必须出现在找到的元素中，而不是它的任何后代元素中。 p:containsOwn(jsoup) 查找具有自己的文本“jsoup”的p元素。
:matchesOwn(*regex*) 元素，其自身的文本与指定的正则表达式匹配。文本必须出现在找到的元素中，而不是它的任何后代元素中。 td:matchesOwn(\\d+) 查找直接包含数字的表单元格。 div:matchesOwn((?i)login) 找到包含文本的div，不敏感的情况。
:containsData(*data*) 包含指定数据的元素。script和style的内容元素,和comment节点(等)被认为是数据节点,而不是文本节点。搜索是大小写不敏感的。数据可能出现在已找到的元素中，也可能出现在其任何子代中。 script:contains(jsoup) 查找包含数据“jsoup”的脚本元素。
  上述可按任何顺序与其他选择器组合 .light:contains(name):eq(0)
:matchText 将文本节点视为元素，因此允许您匹配并选择文本节点。注意，使用此选择器将修改DOM，因此您可能希望在使用之前克隆文档。 p:matchText:firstChild 与输入 <p>One<br />Two</p> 将返回一个 PseudoTextElement 与文本 “One“.

Structural pseudo selectors

Pattern Matches Example
:root 元素是文档的根。在HTML中，这是 html 元素 :root
:nth-child(*a*n+*b*) 在文档树中有*a*n+*b*-1兄妹的元素，对于任何正整数或零值的n，并具有父元素。对于a和b大于零的值，这有效地将元素的子元素划分为元素的组(最后一个组取其余的部分)，并选择每个组的第*b*th元素。例如，这允许选择器处理表中的其他行，并可以用于在一个4周期中替换段落文本的颜色。 a和b的值必须是整数(正数、负数或零)。元素的第一个子元素的索引是1。除此之外, :nth-child() 可以采用奇数和偶数作为参数。 奇数与2n+1的意义相同，偶数与2n的意义相同。 tr:nth-child(2n+1) 查找表中的每一行。 :nth-child(10n-1) 第9，第19，第29，等等，元素。 li:nth-child(5) the 5h li
:nth-last-child(*a*n+*b*) 在文档树中后面有*a*n+*b*-1兄弟元素。否则像:nth-child() tr:nth-last-child(-n+2) 表的最后两行
:nth-of-type(*a*n+*b*) 伪类表示法表示一个元素，该元素具有*a*n+*b*-1个兄弟元素，在文档树前具有相同的扩展元素名，对于任何0或正整数值为n，并且具有父元素 img:nth-of-type(2n+1)
:nth-last-of-type(*a*n+*b*) 伪类表示法表示一个元素，该元素具有*a*n+*b*-1个兄弟元素，在文档树中，对于任何0或正整数值为n的元素，该元素具有一个父元素 img:nth-last-of-type(2n+1)
:first-child 元素是其他元素的第一个子元素。 div > p:first-child
:last-child 其他元素的最后一个子元素。 ol > li:last-child
:first-of-type 在父元素的子元素列表中是其类型的第一个兄弟元素 dl dt:first-of-type
:last-of-type 元素，它是其父元素的子元素列表中类型的最后一个兄弟元素。 tr > td:last-of-type
:only-child 具有父元素且父元素没有其他元素子元素的元素  
:only-of-type 具有父元素的元素，其父元素没有具有相同展开元素名称的其他元素子元素  
:empty 没有孩子的元素。  
标签：

相关文章