org.jsoup.select
Class Selector

java.lang.Object
  extended by org.jsoup.select.Selector

public class Selector
extends Object

CSS-like element selector, that finds elements matching a query.

Selector syntax

A selector is a chain of simple selectors, seperated by combinators. Selectors are case insensitive (including against elements, attributes, and attribute values).

The universal selector (*) is implicit when no element selector is supplied (i.e. *.header and .header is equivalent).

PatternMatchesExample
*any element*
Ean element of type Eh1
E#idan Element with attribute ID of "id"div#wrap, #logo
E.classan Element with a class name of "class"div.left, .result
E[attr]an Element with the attribute named "attr"a[href], [title]
E[attr=val]an Element with the attribute named "attr" and value equal to "val"img[width=500], a[rel=nofollow]
E[attr^=val]an Element with the attribute named "attr" and value starting with "val"a[href^=http:]
E[attr$=val]an Element with the attribute named "attr" and value ending with "val"img[src$=.png]
E[attr*=val]an Element with the attribute named "attr" and value containing "val"a[href*=/search/]
The above may be combined in any orderdiv.header[title]

Combinators

E Fan F element descended from an E elementdiv a, .logo h1
E > Fan F child of Eol > li
E + Fan F element immediately preceded by sibling Eli + li, div.head + div
E ~ Fan F element preceded by sibling Eh1 ~ p
E, F, Gany matching element E, F, or Ga[href], div, h3

Author:
Jonathan Hedley, jonathan@hedley.net
See Also:
Element.select(String)

Nested Class Summary
static class Selector.SelectorParseException
           
 
Method Summary
static Elements select(String query, Element root)
          Find elements matching selector.
static Elements select(String query, Iterable<Element> roots)
          Find elements matching selector.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

select

public static Elements select(String query,
                              Element root)
Find elements matching selector.

Parameters:
query - CSS selector
root - root element to descend into
Returns:
matching elements, empty if not

select

public static Elements select(String query,
                              Iterable<Element> roots)
Find elements matching selector.

Parameters:
query - CSS selector
roots - root elements to descend into
Returns:
matching elements, empty if not


Copyright © 2009-2010 Jonathan Hedley. All Rights Reserved.