PHP 8.6.0RC7 available for testing

Dom\Element::getElementsByClassName

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

Dom\Element::getElementsByClassName — Retorna uma coleção de elementos descendentes que possuem as classes fornecidas

Descrição

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

Retorna uma Dom\HTMLCollection dos descendentes deste elemento, na ordem do documento, cujo atributo class contém todas as classes fornecidas em classNames. O próprio elemento nunca faz parte da coleção.

Parâmetros

classNames

Um ou mais nomes de classe separados por espaços em branco ASCII. Um elemento só corresponde se possuir todas essas classes, em qualquer ordem.

Os nomes de classe são comparados com distinção entre maiúsculas e minúsculas, a menos que o documento esteja no modo quirks, caso em que a comparação não distingue maiúsculas de minúsculas ASCII.

Valor Retornado

Retorna uma Dom\HTMLCollection dos elementos correspondentes. A coleção fica vazia se nenhum elemento corresponder ou se classNames não contiver nenhum nome de classe, por exemplo, quando for uma string vazia ou contiver apenas espaços em branco.

Erros/Exceções

Lança um ValueError se classNames contiver um byte nulo.

Exemplos

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

O exemplo acima produzirá:

One
2

Veja também

+adicionar nota

Notas de Usuários

Não há notas de usuários para esta página.
To Top