PHP 8.6.0 RC5 available for testing

Dom\Element::getElementsByClassName

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

Dom\Element::getElementsByClassName — Devuelve una colección de los elementos descendientes que tienen las clases dadas

Descripción

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

Devuelve una Dom\HTMLCollection con los descendientes de este elemento, en el orden del documento, cuyo atributo class contiene todas las clases dadas en classNames. El propio elemento nunca forma parte de la colección.

Parámetros

classNames

Uno o varios nombres de clase separados por caracteres de espacio en blanco ASCII. Un elemento solo coincide si tiene cada una de estas clases, en cualquier orden.

Los nombres de clase se comparan distinguiendo entre mayúsculas y minúsculas, salvo si el documento está en modo quirks, en cuyo caso la comparación no distingue entre mayúsculas y minúsculas ASCII.

Valores devueltos

Devuelve una Dom\HTMLCollection con los elementos que coinciden. La colección está vacía si ningún elemento coincide, o si classNames no contiene ningún nombre de clase, por ejemplo cuando es un string vacío o solo contiene caracteres de espacio en blanco.

Errores/Excepciones

Lanza una ValueError si classNames contiene un byte nulo.

Ejemplos

Ejemplo #1 Ejemplo 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";

El ejemplo anterior mostrará:

One
2

Véase también

+add a note

User Contributed Notes

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