159 lines
2.9 KiB
PHP
159 lines
2.9 KiB
PHP
<?php
|
|
|
|
namespace Kirby\Parsley;
|
|
|
|
use DOMElement;
|
|
use DOMNodeList;
|
|
use DOMXPath;
|
|
use Kirby\Toolkit\Str;
|
|
|
|
/**
|
|
* Represents a block level element
|
|
* in an HTML document
|
|
*
|
|
* @since 3.5.0
|
|
*
|
|
* @package Kirby Parsley
|
|
* @author Bastian Allgeier <bastian@getkirby.com>,
|
|
* @link https://getkirby.com
|
|
* @copyright Bastian Allgeier
|
|
* @license https://getkirby.com/license
|
|
*/
|
|
class Element
|
|
{
|
|
public function __construct(
|
|
protected DOMElement $node,
|
|
protected array $marks = []
|
|
) {
|
|
}
|
|
|
|
/**
|
|
* The returns the attribute value or
|
|
* the given fallback if the attribute does not exist
|
|
*/
|
|
public function attr(
|
|
string $attr,
|
|
string|null $fallback = null
|
|
): string|null {
|
|
if ($this->node->hasAttribute($attr) === true) {
|
|
return $this->node->getAttribute($attr) ?? $fallback;
|
|
}
|
|
|
|
return $fallback;
|
|
}
|
|
|
|
/**
|
|
* Returns a list of all child elements
|
|
*/
|
|
public function children(): DOMNodeList
|
|
{
|
|
return $this->node->childNodes;
|
|
}
|
|
|
|
/**
|
|
* Returns an array with all class names
|
|
*/
|
|
public function classList(): array
|
|
{
|
|
return Str::split($this->className(), ' ');
|
|
}
|
|
|
|
/**
|
|
* Returns the value of the class attribute
|
|
*/
|
|
public function className(): string|null
|
|
{
|
|
return $this->attr('class');
|
|
}
|
|
|
|
/**
|
|
* Returns the original dom element
|
|
*/
|
|
public function element(): DOMElement
|
|
{
|
|
return $this->node;
|
|
}
|
|
|
|
/**
|
|
* Returns an array with all nested elements
|
|
* that could be found for the given query
|
|
*/
|
|
public function filter(string $query): array
|
|
{
|
|
$result = [];
|
|
|
|
if ($queryResult = $this->query($query)) {
|
|
foreach ($queryResult as $node) {
|
|
$result[] = new static($node);
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Tries to find a single nested element by
|
|
* query and otherwise returns null
|
|
*/
|
|
public function find(string $query): static|null
|
|
{
|
|
if ($result = $this->query($query)[0]) {
|
|
return new static($result);
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Returns the inner HTML of the element
|
|
*
|
|
* @param array|null $marks List of allowed marks
|
|
*/
|
|
public function innerHtml(array|null $marks = null): string
|
|
{
|
|
$marks ??= $this->marks;
|
|
$inline = new Inline($this->node, $marks);
|
|
return $inline->innerHtml();
|
|
}
|
|
|
|
/**
|
|
* Returns the contents as plain text
|
|
*/
|
|
public function innerText(): string
|
|
{
|
|
return trim($this->node->textContent);
|
|
}
|
|
|
|
/**
|
|
* Returns the full HTML for the element
|
|
*/
|
|
public function outerHtml(array|null $marks = null): string
|
|
{
|
|
return $this->node->ownerDocument->saveHtml($this->node);
|
|
}
|
|
|
|
/**
|
|
* Searches nested elements
|
|
*/
|
|
public function query(string $query): DOMNodeList|null
|
|
{
|
|
$path = new DOMXPath($this->node->ownerDocument);
|
|
return $path->query($query, $this->node);
|
|
}
|
|
|
|
/**
|
|
* Removes the element from the DOM
|
|
*/
|
|
public function remove(): void
|
|
{
|
|
$this->node->parentNode->removeChild($this->node);
|
|
}
|
|
|
|
/**
|
|
* Returns the name of the element
|
|
*/
|
|
public function tagName(): string
|
|
{
|
|
return $this->node->tagName;
|
|
}
|
|
}
|