jSoup Cookbook-提取数据 7 使用选择器语法查找元素

问题

采用CSS或类似jquery 选择器（selector）语法来处理HTML文档中的数据。

方法

利用方法：Element.select(String selector)和Elements.select(String selector)。

File input = new File("/tmp/input.html");
Document doc = Jsoup.parse(input, "UTF-8", "http://example.com/");
Elements links = doc.select("a[href]"); // a with href
Elements pngs = doc.select("img[src$=.png]"); // img with src ending .png
Element masthead = doc.select("div.masthead").first();
// div with class=masthead
Elements resultLinks = doc.select("h3.r > a"); // direct a after h3

描述

Jsoup的元素支持类似CSS或（jquery）的选择器语法的查找匹配的元素，可实现功能强大且鲁棒性好的查询。

jsoup elements support aCSS(orjquery) like selector syntax to find matching elements, that allows very powerful and robust queries.

Select方法可作用于Document、Element或Elements，且是上下文相关的，因此可实现指定元素的过滤，或者链式选择访问。

The selectmethod is available in aDocument,Element, or inElements. It is contextual, so you can filter by selecting from a specific element, or by chaining select calls.

选择（操作）返回元素列表（Elements），并提供一组方法来提取或处理结果。

Select returns a list of Elements (asElements), which provides a range of methods to extract and manipulate the results.

选择器概要（Selector overview）

• Tagname：通过标签查找元素（例如：a）
• ns|tag：通过标签在命名空间查找元素，例如：fb|name查找元素
• #id：通过ID查找元素，例如#logo
• .class：通过类型名称查找元素，例如.masthead
• [attribute]：带有属性的元素，例如[href]
• [^attr]：带有名称前缀的元素，例如[^data-]查找HTML5带有数据集（dataset）属性的元素
• [attr=value]：带有属性值的元素，例如[width=500]
• [attr^=value]，[attr$=value]，[attr*=value]：包含属性且其值以value开头、结尾或包含value的元素，例如[href*=/path/]
• [attr~=regex]：属性值满足正则表达式的元素，例如img[src~=(?i)\.(png|jpe?g)]
• *：所有元素，例如*

选择器组合方法

• el#id:：带有ID的元素ID，例如div#logo
• el.class：带类型的元素，例如. div.masthead
• el[attr]：包含属性的元素，例如a[href]
• 任意组合：例如a[href].highlight
• ancestor child：继承自某祖（父）元素的子元素，例如.body p查找“body”块下的p元素
• parent > child：直接为父元素后代的子元素，例如: div.content > pf查找p元素，body > * 查找body元素的直系子元素
• siblingA + siblingB：查找由同级元素A前导的同级元素，例如div.head + div
• siblingA ~ siblingX：查找同级元素A前导的同级元素X例如h1 ~ p
• el, el, el：多个选择器组合，查找匹配任一选择器的唯一元素，例如div.masthead, div.logo

伪选择器（Pseudo selectors）

• :lt(n)：查找索引值（即DOM树中相对于其父元素的位置）小于n的同级元素，例如td:lt(3)
• :gt(n)：查找查找索引值大于n的同级元素，例如div p:gt(2)
• :eq(n) ：查找索引值等于n的同级元素，例如form input:eq(1)
• :has(seletor)：查找匹配选择器包含元素的元素，例如div:has(p)
• :not(selector)：查找不匹配选择器的元素，例如div:not(.logo)
• :contains(text)：查找包含给定文本的元素，大小写铭感，例如p:contains(jsoup)
• :containsOwn(text)：查找直接包含给定文本的元素
• :matches(regex)：查找其文本匹配指定的正则表达式的元素，例如div:matches((?i)login)
• :matchesOwn(regex)：查找其自身文本匹配指定的正则表达式的元素
• 注意：上述伪选择器是0-基数的，亦即第一个元素索引值为0，第二个元素index为1等

详见SelectorAPI 参考资料所列全部信息和细节。

【原文】http://jsoup.org/cookbook/extracting-data/selector-syntax