This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
symfony/src/Symfony/Component/CssSelector
2014-01-01 08:52:14 +01:00
..
Exception [CssSelector] fully rewritted component 2013-03-23 19:04:09 +01:00
Node fixed CS 2013-10-30 09:30:20 +01:00
Parser merged branch dantleech/enforce_sprintf_for_exceptions (PR #7620) 2013-04-11 08:50:46 +02:00
Tests fixes PSR-0 issues in tests 2013-12-30 22:13:42 +01:00
XPath removed unneeded use statements 2014-01-01 08:52:14 +01:00
.gitignore Added missing files .gitignore 2013-07-21 14:12:18 +02:00
CHANGELOG.md [CssSelector] added CHANGELOG 2012-04-26 22:11:05 +02:00
composer.json [CssSelector] fully rewritted component 2013-03-23 19:04:09 +01:00
CssSelector.php [CssSelector] fixed BC break 2013-03-23 20:31:06 +01:00
LICENSE updated license year 2013-01-04 17:59:43 +01:00
phpunit.xml.dist made usage of Composer autoloader for subtree-split unit tests 2012-11-09 14:10:06 +01:00
README.md Merge branch '2.2' into 2.3 2013-09-19 11:45:20 +02:00

CssSelector Component

CssSelector converts CSS selectors to XPath expressions.

The component only goal is to convert CSS selectors to their XPath equivalents:

use Symfony\Component\CssSelector\CssSelector;

print CssSelector::toXPath('div.item > h4 > a');

HTML and XML are different

The CssSelector component comes with an HTML extension which is enabled by default. If you need to use this component with XML documents, you have to disable this HTML extension. That's because, HTML tag & attribute names are always lower-cased, but case-sensitive in XML:

// disable `HTML` extension:
CssSelector::disableHtmlExtension();

// re-enable `HTML` extension:
CssSelector::enableHtmlExtension();

When the HTML extension is enabled, tag names are lower-cased, attribute names are lower-cased, the following extra pseudo-classes are supported: checked, link, disabled, enabled, selected, invalid, hover, visited, and the lang() function is also added.

Resources

This component is a port of the Python lxml library, which is copyright Infrae and distributed under the BSD license.

Current code is a port of https://github.com/SimonSapin/cssselect@v0.7.1

You can run the unit tests with the following command:

$ cd path/to/Symfony/Component/CssSelector/
$ composer.phar install
$ phpunit