carica/phpcss

An css selector parser and converter

2.0.0 2021-04-25 14:14 UTC

This package is auto-updated.

Last update: 2024-03-25 20:37:32 UTC


README

Build Status License Total Downloads Latest Stable Version Latest Unstable Version

Thanks to Benjamin Eberlei, Bastian Feder and Jakob Westhoff for ideas and concepts.

PhpCSS is a parser for CSS 3 selectors. It parses them into an AST and allows them to compile the AST to CSS selectors or Xpath expressions.

The main target of this project is the possibilty to convert CSS selectors into Xpath expressions.

Demo

A small demo application can be found at: http://xpath.thomas.weinert.info/

Installation

PhpCss is available on Packagist: Carica/PhpCss. Add it to you composer.json and update.

Basic Usage

Get CSS selector as Xpath expression

$expression = PhpCss::toXpath($selector);

Reformat/Validate CSS Selector

$selector = PhpCss::reformat($selector);

Get the AST

$ast = PhpCss::getAst($selector);

FluentDOM

FluentDOM 5 allows to inject a callback to convert selectors. If you have FluentDOM and PhpCss installed in your project, you can use CSS selectors in FluentDOM:

$fd = FluentDOM::QueryCss($xml);
$fd
  ->find('td:nth-of-type(even)')
  ->addClass('even');

Supported

Selectorto CSSto Xpath
*
E
ns|*
ns|E
Attributes
E[foo]
E[foo="bar"]
E[foo~="bar"]
E[foo^="bar"]
E[foo$="bar"]
E[foo*="bar"]
E[foo|="bar"]
Structural Pseudo Classes
E:root
E:nth-child(42)
E:nth-last-child(42)
E:nth-of-type(42)
E:nth-last-of-type(42)
E:first-child
E:last-child
E:first-of-type
E:last-of-type
E:only-child
E:only-of-type
E:empty
Link Pseudo Classes
E:link
E:visited
User Action Pseudo Classes
E:active
E:hover
E:focus
Target Pseudo Class
E:target
Language Pseudo Class
E:lang(fr)
UI Element states Pseudo Class
E:enabled✓ (not disabled)
E:disabled✓ (attribute)
E:checked✓ (attribute)
Pseudo Elements
E:first-line
E:first-letter
E:before
E:after
Class Selector
E.warning
Id Selector
E#myid
Negation Pseudo Class
E:not(s)
Combinators
E F
E > F
E + F
E ~ F
jQuery
:contains("text")
:has(s)
:gt(42)
:lt(42)
:odd
:even