NAME
XML::LibXML::QuerySelector - add querySelector and querySelectorAll
methods to XML::LibXML nodes
SYNOPSIS
my $document = XML::LibXML->new->parse_file('my.xhtml');
my $warning = $document->querySelector('p.warning strong');
print $warning->toString if defined $warning;
DESCRIPTION
This module defines a class (it has no constructor so perhaps closer to
an abstract class or a role)XML::LibXML::QuerySelector, and sets itself
up as a superclass (not a subclass) of XML::LibXML::Document,
XML::LibXML::DocumentFragment and XML::LibXML::Element, thus making its
methods available to objects of those classes.
Yes, this is effectively monkey-patching, but it's performed in a
*relatively* safe manner.
Methods
The methods provided by this module are defined in the W3C Candidate
Recomendation "Selectors API Level 1"
.
"querySelector($selector)"
Given a CSS selector, returns the first match or undef if there are
no matches.
"querySelectorAll($selector)"
Given a CSS selector, returns all matches as a list, or if called in
scalar context, as an XML::LibXML::NodeList.
CAVEATS
* When called on an element, "querySelectorAll" returns a static node
list; not a live node list. (Called on a document or document
fragment, it will return a live node list as specified in the W3C
Candidate Recommendation.)
* Use on mixed-namespace documents is largely untested. The module is
mostly intended for use with XHTML and HTML documents.
BUGS
Please report any bugs to
.
TODO
* Track changes to HTML::Selector::XPath.
* Consider adding HTML5 DOM traversal methods including
"getElementsByClassName".
SEE ALSO
HTML::Selector::XPath, XML::LibXML.
AUTHOR
Toby Inkster .
This module includes large portions of the not-easily-subclassable
HTML::Selector::XPath by Tatsuhiko Miyagawa and Max Maischein.
COPYRIGHT AND LICENCE
This software is copyright (c) 2012 by Toby Inkster.
Portions copyright 2006-2011 by Tatsuhiko Miyagawa; portions copyright
2011 by Max Maischein.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
DISCLAIMER OF WARRANTIES
THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.