HTML::Selector::XPath3pm

Usage

  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');
  my $relative = selector_to_xpath('div.foo', root => '/html/body/p' );
  # /html/body/p/div[contains(concat(' ', @class, ' '), ' foo ')]
  my $relative = selector_to_xpath('div:root', root => '/html/body/p' );
  # /html/body/p/div

Overview

HTML::Selector::XPath is a utility function to compile full set of CSS2 and partial CSS3 selectors to the equivalent XPath expression.

FUNCTIONS and METHODS

selector_to_xpath

  $xpath = selector_to_xpath($selector, %options);

Shortcut for "HTML::Selector::XPath->new(shift)->to_xpath(@_)". Exported upon request.

new

  $sel = HTML::Selector::XPath->new($selector, %options);

Creates a new object.

to_xpath

  $xpath = $sel->to_xpath;
  $xpath = $sel->to_xpath(root => "."); # ./foo instead of //foo

Returns the translated XPath expression. You can optionally pass "root" parameter, to specify which root to start the expression. It defaults to "/".

The optional "prefix" option allows you to specify a namespace prefix for the generated XPath expression.

Subclassing notes

parse_pseudo

This method is called during xpath construction when we encounter a pseudo selector (something that begins with comma). It is passed the selector and a reference to the string we are parsing. It should return one or more xpath sub-expressions to add to the parts if the selector is handled, otherwise return an empty list.

Caveats

  div.123foo