mirror of
https://github.com/FreshRSS/FreshRSS.git
synced 2026-03-29 03:32:53 -04:00
9f4f6e9cac
Includes https://github.com/PhpGt/CssXPath/pull/227
Follow-up of https://github.com/PhpGt/CssXPath/pull/227 for PHP 8.4
Requires PHP 8.0+
Full diff d99d35f719...45f3ac151f
64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
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()`][qsa] to PHP in the [PHP.Gt/Dom][gt-dom] project.
|
|
|
|
***
|
|
|
|
<a href="https://github.com/PhpGt/CssXPath/actions" target="_blank">
|
|
<img src="https://badge.status.php.gt/cssxpath-build.svg" alt="Build status" />
|
|
</a>
|
|
<a href="https://app.codacy.com/gh/PhpGt/CssXPath" target="_blank">
|
|
<img src="https://badge.status.php.gt/cssxpath-quality.svg" alt="Code quality" />
|
|
</a>
|
|
<a href="https://app.codecov.io/gh/PhpGt/CssXPath" target="_blank">
|
|
<img src="https://badge.status.php.gt/cssxpath-coverage.svg" alt="Code coverage" />
|
|
</a>
|
|
<a href="https://packagist.org/packages/PhpGt/CssXPath" target="_blank">
|
|
<img src="https://badge.status.php.gt/cssxpath-version.svg" alt="Current version" />
|
|
</a>
|
|
<a href="http://www.php.gt/cssxpath" target="_blank">
|
|
<img src="https://badge.status.php.gt/cssxpath-docs.svg" alt="PHP.Gt/CssXPath documentation" />
|
|
</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][gt-dom].
|
|
|
|
[qsa]: https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll
|
|
[gt-dom]: https://www.php.gt/dom
|