Dom\Element::getElementsByClassName

(No version information available, might only be in Git)

Dom\Element::getElementsByClassName — Returns a collection of descendant elements that have the given classes

Beschreibung

public function Dom\Element::getElementsByClassName(string $classNames): Dom\HTMLCollection

Returns a Dom\HTMLCollection of the descendants of this element, in document order, whose class attribute contains all the classes given in classNames. The element itself is never part of the collection.

Parameter-Liste

classNames

One or more class names separated by ASCII whitespace. An element only matches if it has every one of these classes, in any order.

Class names are compared case-sensitively, unless the document is in quirks mode, in which case the comparison is ASCII case-insensitive.

Rückgabewerte

Returns a Dom\HTMLCollection of the matching elements. The collection is empty if no element matches, or if classNames contains no class name, for example when it is an empty string or only whitespace.

Fehler/Exceptions

Throws a ValueError if classNames contains a null byte.

Beispiele

Beispiel #1 Dom\Element::getElementsByClassName() example

<?php

$dom = Dom\HTMLDocument::createFromString(
    '<!DOCTYPE html><body><div id="list">'
        . '<p class="item new">One</p>'
        . '<p class="item">Two</p>'
        . '<p class="Item">Three</p>'
        . '</div></body>',
    LIBXML_NOERROR
);

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

foreach ($list->getElementsByClassName('new  item') as $element) {
    echo $element->textContent, "\n";
}

echo $list->getElementsByClassName('item')->length, "\n";

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

One
2

Siehe auch

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes

There are no user contributed notes for this page.