mirror of
https://github.com/FreshRSS/FreshRSS.git
synced 2026-02-14 15:31:13 -05:00
1abb261cea
* CssXPath: Implement ~ Subsequent-sibling fix https://github.com/FreshRSS/FreshRSS/issues/8143 Upstream PR https://github.com/phpgt/CssXPath/pull/231 * Use CssXPath release v1.4.0 https://github.com/phpgt/CssXPath/releases/tag/v1.4.0
70 lines
2.5 KiB
Markdown
70 lines
2.5 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
|
|
|
|
# Proudly sponsored by
|
|
|
|
[JetBrains Open Source sponsorship program](https://www.jetbrains.com/community/opensource/)
|
|
|
|
[](https://www.jetbrains.com/community/opensource/)
|