日期:2014-05-16  浏览次数:20385 次

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查找<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