HXSELECT(1) HTML-XML-utils HXSELECT(1)NAME
hxselect - extract elements that match a (CSS) selector
SYNOPSIS
hxselect [ -i ] [ -c ] [ -l language ] [ -s separator ] selector
DESCRIPTION
hxselect reads a well-formed XML document and outputs elements that match the CSS selector that is given as an argument. For example
hxselect ol li:first-child
selects the first li (list item in XHTML) in an ol (ordered list).
The command operates on the standard input.
Assumes that class selectors (".foo") refer to an attribute called "class".
Assumes that ID selectors ("#foo") refer to an attribute called "id".
OPTIONS
The following options are supported:
-i Match case-insensitively. Useful for HTML and some other SGML-based languages.
-c Print content only. Without -c, the start and end tag of the matched element are printed as well; with -c only the contents of
the matched element are printed.
-l language
Sets the default language, in case the root element doesn't have an xml:lang attribute (default: none). Example: -l en
-s separator
A string to print after each match (default: empty). Accepts C-like escapes. Example: -s '
' to print an empty line after each
match.
-? Show command usage.
OPERANDS
The following operand is supported:
selector
A selector. Most selectors from CSS level 3 are supported, with the exception of pseudo-classes, pseudo-elements and selectors with
last- in their name.
6.x 10 Jul 2011 HXSELECT(1)
Check Out this Related Man Page
Mojo::DOM::CSS(3pm) User Contributed Perl Documentation Mojo::DOM::CSS(3pm)NAME
Mojo::DOM::CSS - CSS3 selector engine
SYNOPSIS
use Mojo::DOM::CSS;
# Select elements from DOM tree
my $css = Mojo::DOM::CSS->new(tree => $tree);
my $elements = $css->select('h1, h2, h3');
DESCRIPTION
Mojo::DOM::CSS is the CSS3 selector engine used by Mojo::DOM.
SELECTORS
All CSS3 selectors that make sense for a standalone parser are supported.
"*"
Any element.
my $all = $css->select('*');
"E"
An element of type "E".
my $title = $css->select('title');
"E[foo]"
An "E" element with a "foo" attribute.
my $links = $css->select('a[href]');
"E[foo="bar"]"
An "E" element whose "foo" attribute value is exactly equal to "bar".
my $fields = $css->select('input[name="foo"]');
"E[foo~="bar"]"
An "E" element whose "foo" attribute value is a list of whitespace-separated values, one of which is exactly equal to "bar".
my $fields = $css->select('input[name~="foo"]');
"E[foo^="bar"]"
An "E" element whose "foo" attribute value begins exactly with the string "bar".
my $fields = $css->select('input[name^="f"]');
"E[foo$="bar"]"
An "E" element whose "foo" attribute value ends exactly with the string "bar".
my $fields = $css->select('input[name$="o"]');
"E[foo*="bar"]"
An "E" element whose "foo" attribute value contains the substring "bar".
my $fields = $css->select('input[name*="fo"]');
"E:root"
An "E" element, root of the document.
my $root = $css->select(':root');
"E:checked"
A user interface element "E" which is checked (for instance a radio-button or checkbox).
my $input = $css->select(':checked');
"E:empty"
An "E" element that has no children (including text nodes).
my $empty = $css->select(':empty');
"E:nth-child(n)"
An "E" element, the "n-th" child of its parent.
my $third = $css->select('div:nth-child(3)');
my $odd = $css->select('div:nth-child(odd)');
my $even = $css->select('div:nth-child(even)');
my $top3 = $css->select('div:nth-child(-n+3)');
"E:nth-last-child(n)"
An "E" element, the "n-th" child of its parent, counting from the last one.
my $third = $css->select('div:nth-last-child(3)');
my $odd = $css->select('div:nth-last-child(odd)');
my $even = $css->select('div:nth-last-child(even)');
my $bottom3 = $css->select('div:nth-last-child(-n+3)');
"E:nth-of-type(n)"
An "E" element, the "n-th" sibling of its type.
my $third = $css->select('div:nth-of-type(3)');
my $odd = $css->select('div:nth-of-type(odd)');
my $even = $css->select('div:nth-of-type(even)');
my $top3 = $css->select('div:nth-of-type(-n+3)');
"E:nth-last-of-type(n)"
An "E" element, the "n-th" sibling of its type, counting from the last one.
my $third = $css->select('div:nth-last-of-type(3)');
my $odd = $css->select('div:nth-last-of-type(odd)');
my $even = $css->select('div:nth-last-of-type(even)');
my $bottom3 = $css->select('div:nth-last-of-type(-n+3)');
"E:first-child"
An "E" element, first child of its parent.
my $first = $css->select('div p:first-child');
"E:last-child"
An "E" element, last child of its parent.
my $last = $css->select('div p:last-child');
"E:first-of-type"
An "E" element, first sibling of its type.
my $first = $css->select('div p:first-of-type');
"E:last-of-type"
An "E" element, last sibling of its type.
my $last = $css->select('div p:last-of-type');
"E:only-child"
An "E" element, only child of its parent.
my $lonely = $css->select('div p:only-child');
"E:only-of-type"
An "E" element, only sibling of its type.
my $lonely = $css->select('div p:only-of-type');
"E.warning"
my $warning = $css->select('div.warning');
An "E" element whose class is "warning".
"E#myid"
my $foo = $css->select('div#foo');
An "E" element with "ID" equal to "myid".
E:not(s)
An "E" element that does not match simple selector "s".
my $others = $css->select('div p:not(:first-child)');
"E F"
An "F" element descendant of an "E" element.
my $headlines = $css->select('div h1');
"E > F"
An "F" element child of an "E" element.
my $headlines = $css->select('html > body > div > h1');
"E + F"
An "F" element immediately preceded by an "E" element.
my $second = $css->select('h1 + h2');
"E ~ F"
An "F" element preceded by an "E" element.
my $second = $css->select('h1 ~ h2');
"E, F, G"
Elements of type "E", "F" and "G".
my $headlines = $css->select('h1, h2, h3');
"E[foo=bar][bar=baz]"
An "E" element whose attributes match all following attribute selectors.
my $links = $css->select('a[foo^="b"][foo$="ar"]');
ATTRIBUTES
Mojo::DOM::CSS implements the following attributes.
"tree"
my $tree = $css->tree;
$css = $css->tree(['root', [qw(text lalala)]]);
Document Object Model.
METHODS
Mojo::DOM::CSS inherits all methods from Mojo::Base and implements the following new ones.
"select"
my $results = $css->select('head > title');
Run CSS3 selector against "tree".
SEE ALSO
Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.
perl v5.14.2 2012-09-05 Mojo::DOM::CSS(3pm)