NAME

HTML::Selector::XPath - CSS Selector to XPath compiler

SYNOPSIS

  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');

DESCRIPTION

HTML::Selector::XPath is a utility function to compile CSS2 selector to the equivalent XPath expression.

CAVEATS

CSS SELECTOR VALIDATION

This module doesn't validate whether 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.

AUTHOR

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/

LICENSE

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

CPAN RT