Dom\ParentNode::querySelector

(PHP 8 >= 8.4.0)

Dom\ParentNode::querySelector — Returns the first element that matches the CSS selectors

Description

public function Dom\ParentNode::querySelector(string $selectors): ?Dom\Element

Returns the first element that matches the CSS selectors specified in selectors.

Parameters

selectors

A string containing one or more CSS selectors.

Return Values

Returns the first Dom\Element that matches selectors. Returns null if no element matches.

Errors/Exceptions

Throws a DOMException with code Dom\SYNTAX_ERR when selectors is not a valid CSS selector string.

Examples

Example #1 Dom\ParentNode::querySelector() example

<?php
$dom = Dom\HTMLDocument::createFromString(
    '<!DOCTYPE html><body><div id="container"><p class="item">First</p><p class="item">Second</p></div></body>',
    LIBXML_NOERROR
);

$container = $dom->getElementById('container');

$firstItem = $container->querySelector('.item');
echo $firstItem->textContent, "\n";

echo $container->querySelector('p.item')->textContent, "\n";

?>

The above example will output:

First
First

See Also