Blame view

vendor/symfony/css-selector/CssSelector.php 3.79 KB
ad2e91f7   Mihail   move multyparser ...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
  <?php
  
  /*
   * This file is part of the Symfony package.
   *
   * (c) Fabien Potencier <fabien@symfony.com>
   *
   * For the full copyright and license information, please view the LICENSE
   * file that was distributed with this source code.
   */
  
  namespace Symfony\Component\CssSelector;
  
  use Symfony\Component\CssSelector\Parser\Shortcut\ClassParser;
  use Symfony\Component\CssSelector\Parser\Shortcut\ElementParser;
  use Symfony\Component\CssSelector\Parser\Shortcut\EmptyStringParser;
  use Symfony\Component\CssSelector\Parser\Shortcut\HashParser;
  use Symfony\Component\CssSelector\XPath\Extension\HtmlExtension;
  use Symfony\Component\CssSelector\XPath\Translator;
  
  /**
   * CssSelector is the main entry point of the component and can convert CSS
   * selectors to XPath expressions.
   *
   * $xpath = CssSelector::toXpath('h1.foo');
   *
   * This component is a port of the Python cssselect library,
   * which is copyright Ian Bicking, @see https://github.com/SimonSapin/cssselect.
   *
   * Copyright (c) 2007-2012 Ian Bicking and contributors. See AUTHORS
   * for more details.
   *
   * All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions are
   * met:
   *
   * 1. Redistributions of source code must retain the above copyright
   * notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   * notice, this list of conditions and the following disclaimer in
   * the documentation and/or other materials provided with the
   * distribution.
   *
   * 3. Neither the name of Ian Bicking nor the names of its contributors may
   * be used to endorse or promote products derived from this software
   * without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL IAN BICKING OR
   * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
   * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
   * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
   * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
   * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
   * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
   * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   *
   * @author Fabien Potencier <fabien@symfony.com>
   */
  class CssSelector
  {
      private static $html = true;
  
      /**
       * Translates a CSS expression to its XPath equivalent.
       * Optionally, a prefix can be added to the resulting XPath
       * expression with the $prefix parameter.
       *
       * @param mixed  $cssExpr The CSS expression.
       * @param string $prefix  An optional prefix for the XPath expression.
       *
       * @return string
       */
      public static function toXPath($cssExpr, $prefix = 'descendant-or-self::')
      {
          $translator = new Translator();
  
          if (self::$html) {
              $translator->registerExtension(new HtmlExtension($translator));
          }
  
          $translator
              ->registerParserShortcut(new EmptyStringParser())
              ->registerParserShortcut(new ElementParser())
              ->registerParserShortcut(new ClassParser())
              ->registerParserShortcut(new HashParser())
          ;
  
          return $translator->cssToXPath($cssExpr, $prefix);
      }
  
      /**
       * Enables the HTML extension.
       */
      public static function enableHtmlExtension()
      {
          self::$html = true;
      }
  
      /**
       * Disables the HTML extension.
       */
      public static function disableHtmlExtension()
      {
          self::$html = false;
      }
  }