Back to Freshrss

README

lib/phpgt/cssxpath/README.md

1.28.12.5 KB
Original Source

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.


<a href="https://github.com/PhpGt/CssXPath/actions" target="_blank"> </a> <a href="https://app.codacy.com/gh/PhpGt/CssXPath" target="_blank"> </a> <a href="https://app.codecov.io/gh/PhpGt/CssXPath" target="_blank"> </a> <a href="https://packagist.org/packages/PhpGt/CssXPath" target="_blank"> </a> <a href="http://www.php.gt/cssxpath" target="_blank"> </a>

Example usage

php
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.

php
$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