HTML::TreeBuilder::Select - Traverse a HTML tree using CSS selectors


Version 0.111


  my $tree = new HTML::TreeBuilder::Select

  my @entries = $tree->select("div.main div.entry");
@elements = $tree->select(QUERY)

Search the tree for elements matching the QUERY, which should be a CSS selector.


Returns a string representation of the tree in (possibly invalid) HTML format. This method will preserve any text outside of the root-level elements and NOT automatically wrap the content in <html><head></head><body> ... </body></html>.

my $element = $tree->container()

A convenience method that will return either the containing element of the tree, or a simple div container containing the root-level elements. This is very similar to the guts method, but container will also remember whether the tree had a containing root element or not.


Same as HTML::TreeBuilder::delete


Robert Krimen, <rkrimen at>


Please report any bugs or feature requests to bug-html-treebuilder-select at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


You can find documentation for this module with the perldoc command.

    perldoc HTML::TreeBuilder::Select

You can also look for information at:



Copyright 2007 Robert Krimen, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.