HTML::Selector::XPath - phpMan

HTML::Selector::XPath(3pm)     User Contributed Perl Documentation     HTML::Selector::XPath(3pm)

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

         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

DESCRIPTION
       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
   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.

COPYRIGHT
       Tatsuhiko Miyagawa 2006-2011

       Max Maischein 2011-

AUTHOR
       Tatsuhiko Miyagawa <miyagawa AT bulknews.net>

       Most of the logic 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/>

       Also see

       <http://www.mail-archive.com/www-archive AT w3.org/msg00906.html>

       and

       <http://kilianvalkhof.com/2008/css-xhtml/the-css3-not-selector/>

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

SEE ALSO
       <http://www.w3.org/TR/REC-CSS2/selector.html>
       <http://use.perl.org/~miyagawa/journal/31090>
       <https://en.wikibooks.org/wiki/XPath/CSS_Equivalents>

perl v5.32.1                                2021-12-17                 HTML::Selector::XPath(3pm)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-26 18:55 @216.73.216.86 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)