PHP 8.6.0RC7 available for testing

Dom\Element::getElementsByClassName

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

Dom\Element::getElementsByClassName — Renvoie une collection des éléments descendants qui possèdent les classes données

Description

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

Renvoie une Dom\HTMLCollection des descendants de cet élément, dans l'ordre du document, dont l'attribut class contient toutes les classes données dans classNames. L'élément lui-même ne fait jamais partie de la collection.

Liste de paramètres

classNames

Un ou plusieurs noms de classe séparés par des caractères d'espacement blancs ASCII. Un élément ne correspond que s'il possède chacune de ces classes, dans n'importe quel ordre.

Les noms de classe sont comparés en tenant compte de la casse, sauf si le document est en mode quirks, auquel cas la comparaison ignore la casse ASCII.

Valeurs de retour

Renvoie une Dom\HTMLCollection des éléments correspondants. La collection est vide si aucun élément ne correspond, ou si classNames ne contient aucun nom de classe, par exemple lorsqu'il s'agit d'une chaîne vide ou composée uniquement de caractères d'espacement blancs.

Erreurs / Exceptions

Lève une ValueError si classNames contient un octet nul.

Exemples

Exemple #1 Exemple de Dom\Element::getElementsByClassName()

<?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";

L'exemple ci-dessus va afficher :

One
2

Voir aussi

+add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top