From 0cb95e07ac2031b60349114c1b1f17e0b75e8f6e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jean-Fran=C3=A7ois=20Simon?= Date: Sun, 16 Jun 2013 11:03:18 +0200 Subject: [PATCH] added a node about HTML extension in readme --- src/Symfony/Component/CssSelector/README.md | 22 +++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/src/Symfony/Component/CssSelector/README.md b/src/Symfony/Component/CssSelector/README.md index c4409fef6c..8c08e5ebed 100644 --- a/src/Symfony/Component/CssSelector/README.md +++ b/src/Symfony/Component/CssSelector/README.md @@ -10,6 +10,28 @@ equivalents: 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 `HTML` extension. +- `HTML` tag & attribute names are always lower-cased, with `XML` they are case-sensistive. + +Disable & enable `HTML` extension: + + // disable `HTML` extension: + CssSelector::disableHtmlExtension(); + // re-enable `HTML` extension: + CssSelector::enableHtmlExtension(); + +What brings `HTML` extension? +- Tag names are lower-cased +- Attribute names are lower-cased +- Adds following pseudo-classes: + - `checked`, `link`, `disabled`, `enabled`, `selected`: used with form tags + - `invalid`, `hover`, `visited`: always select nothing +- Adds `lang()` function + Resources ---------