HTML::Selector::XPath - CSS Selector to XPath compiler
use HTML::Selector::XPath; my $selector = HTML::Selector::XPath->new("li#main"); $selector->to_xpath; # //li[@id='main'] # functional interface use HTML::Selector::Xpath 'selector_to_xpath'; my $xpath = selector_to_xpath('div.foo');
HTML::Selector::XPath is a utility function to compile CSS2 selector to the equivalent XPath expression.
This module supports :first-child and :lang pseudo class, and a partial support for :not CSS 3 pseudo class as well. When you use :not, this module will produce the equivalent XPath expression :not(), which is only available in XPath 2.0 implementation.
So far as I have tested, :not() is not available in Perl XPath modules like XML::LibXML and HTML::Builder::XPath.
This module doesn't validate if the original CSS Selector expression is valid. For example,
div.123foo
is an invalid CSS selector (class names should not begin with numbers), but this module ignores that and tries to generate an equivalent XPath expression anyway.
Tatsuhiko Miyagawa <miyagawa@bulknews.net>
Most of the code is based on Joe Hewitt's getElementsBySelector.js on http://www.joehewitt.com/blog/2006-03-20.php and Andrew Dupont's patch to Prototype.js on http://dev.rubyonrails.org/ticket/5171, but slightly modified using Aristotle Pegaltzis' CSS to XPath translation table per http://plasmasturm.org/log/444/
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
http://www.w3.org/TR/REC-CSS2/selector.html http://use.perl.org/~miyagawa/journal/31090
To install HTML::Selector::XPath, copy and paste the appropriate command in to your terminal.
cpanm
cpanm HTML::Selector::XPath
CPAN shell
perl -MCPAN -e shell install HTML::Selector::XPath
For more information on module installation, please visit the detailed CPAN module installation guide.