Server : Apache System : Linux server2.corals.io 4.18.0-348.2.1.el8_5.x86_64 #1 SMP Mon Nov 15 09:17:08 EST 2021 x86_64 User : corals ( 1002) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory :  /home/corals/old/vendor/phpgt/dom/src/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

<?php
namespace Gt\Dom;

use DOMDocument;
use DOMNode;
use DOMXPath;
use Gt\CssXPath\Translator;
use ReturnTypeWillChange;

/**
 * Contains methods that are particular to Node objects that can have children.
 *
 * This trait can only be used in a class that is a trait of LiveProperty.
 *
 * This trait is used by the following classes:
 *  - Element
 *  - Document and its subclasses XMLDocument and HTMLDocument
 *  - DocumentFragment
 * @property-read HTMLCollection $children A live HTMLCollection containing all
 *  objects of type Element that are children of this ParentNode.
 * @property-read Node|Element|null $firstChild
 * @property-read Element|null $firstElementChild The Element that is the first
 *  child of this ParentNode.
 * @property-read Node|Element|null $lastChild
 * @property-read Element|null $lastElementChild The Element that is the last
 *  child of this ParentNode.
 * @property-read int $childElementCount The amount of children that the
 *  ParentNode has.
 *
 * @method Element getElementById(string $id)
 * @method Node|Element importNode(DOMNode $importedNode, bool $deep = false)
 * @method Node|Element insertBefore(DOMNode $newNode, DOMNode $refNode = false)
 * @method Node|Element removeChild(DOMNode $oldNode)
 * @method Node|Element replaceChild(DOMNode $newNode, DOMNode $oldNode)
 */
trait ParentNode {
	public function querySelector(string $selector):?Element {
		$htmlCollection = $this->css($selector);

		return $htmlCollection->item(0);
	}

	public function querySelectorAll(string $selector):HTMLCollection {
		return $this->css($selector);
	}

	protected function prop_get_children():HTMLCollection {
		return new HTMLCollection($this->childNodes);
	}

	protected function prop_get_firstElementChild():?Element {
		return $this->children->item(0);
	}

	protected function prop_get_lastElementChild():?Element {
		return $this->children->item($this->children->length - 1);
	}

	protected function prop_get_childElementCount():int {
		return $this->children->length;
	}

	public function css(
		string $selectors,
		string $prefix = ".//"
	):HTMLCollection {
		$translator = new Translator($selectors, $prefix);
		return $this->xPath($translator);
	}

	public function xPath(string $selector):HTMLCollection {
		$x = new DOMXPath($this->getRootDocument());
		return new HTMLCollection($x->query($selector, $this));
	}

	#[ReturnTypeWillChange]
	public function getElementsByTagName($name) {
		$nodeList = parent::getElementsByTagName($name);
		if($nodeList instanceof NodeList) {
			return $nodeList;
		}

		return new HTMLCollection($nodeList);
	}

	public function removeAttributeFromNamedElementAndChildren(
		Element $form,
		string $name,
		string $attribute
	):void {
		$selector = "[name='$name'], [name='$name'] *";
		foreach($form->querySelectorAll($selector) as $element) {
			$element->removeAttribute($attribute);
		}
	}

	/**
	 * Normalises access to the parent dom document, which may be located in various places
	 * depending on what type of object is using the trait
	 *
	 * @return DOMDocument
	 */
	protected abstract function getRootDocument():DOMDocument;
}