Translate CSS selectors to XPath queries.
25
stars
94
commits
PHP
primary language
Aug 26, 2026
updated
README
Translate CSS selectors to XPath queries.
A lightweight and dependency free CSS to XPath translator. This repository is used to bring modern DOM functionality like querySelectorAll() to PHP in the PHP.Gt/Dom project.
Example usage
use GT\CssXPath\Translator;
$html = <<<HTML
<form>
<label>
Name
<input name="name" />
</label>
<label>
Code:
<input name="code" />
</label>
<button name="do" value="submit">Submit code</button>
</form>
HTML;
$document = new DOMDocument();
$document->loadHTML($html);
$xpath = new DOMXPath($document);
$inputElementList = $xpath->query(new Translator("form>label>input"));
Using this library with XML Documents
To correctly work with XML documents, where the attributes are case-sensitive, pass false to the htmlMode property of the constructor.
$translator = new Translator("[data-FOO='bar']", htmlMode: false);
It's perhaps worth noting that for XML-style matching to work, you must load the document content with DOMDocument->load/DOMDocument->loadXML instead of DOMDocument->loadHTMLFile/DOMDocument->loadHTML, as the HTML loading methods automatically convert the tags and attribute names to lowercase. This is handled automatically when using PHP.Gt/Dom.
Proudly sponsored by
JetBrains Open Source sponsorship program
Contributors
Similar repos
Languages
PHP
100.0%
Translate CSS selectors to XPath queries.
25
stars
94
commits
PHP
primary language
Aug 26, 2026
updated
README
Translate CSS selectors to XPath queries.
A lightweight and dependency free CSS to XPath translator. This repository is used to bring modern DOM functionality like querySelectorAll() to PHP in the PHP.Gt/Dom project.
Example usage
use GT\CssXPath\Translator;
$html = <<<HTML
<form>
<label>
Name
<input name="name" />
</label>
<label>
Code:
<input name="code" />
</label>
<button name="do" value="submit">Submit code</button>
</form>
HTML;
$document = new DOMDocument();
$document->loadHTML($html);
$xpath = new DOMXPath($document);
$inputElementList = $xpath->query(new Translator("form>label>input"));
Using this library with XML Documents
To correctly work with XML documents, where the attributes are case-sensitive, pass false to the htmlMode property of the constructor.
$translator = new Translator("[data-FOO='bar']", htmlMode: false);
It's perhaps worth noting that for XML-style matching to work, you must load the document content with DOMDocument->load/DOMDocument->loadXML instead of DOMDocument->loadHTMLFile/DOMDocument->loadHTML, as the HTML loading methods automatically convert the tags and attribute names to lowercase. This is handled automatically when using PHP.Gt/Dom.
Proudly sponsored by
JetBrains Open Source sponsorship program
Similar repos
Contributors
Languages
PHP
100.0%