Dom\TokenList::toggle

(PHP 8 >= 8.4.0)

Dom\TokenList::toggle — Alterna a presença de um token na lista

Descrição

public Dom\TokenList::toggle(string $token, ?bool $force = null): bool

Alterna a presença de token na lista.

Parâmetros

token: O token a alternar.
force: Se force for informado, defini-lo para true adicionará o token, e para false removerá o token.

Valor Retornado

Retorna true se o token estiver na lista após a chamada, false caso contrário.

Erros/Exceções

Lança uma exceção ValueError se um token contiver algum byte nulo.
Lança uma exceção Dom\DOMException com código Dom\SYNTAX_ERR se um token for uma string vazia.
Lança uma exceção Dom\DOMException com código Dom\INVALID_CHARACTER_ERR se um token contiver algum espaço em branco ASCII.

Exemplos

Exemplo #1 Exemplo de Dom\TokenList::toggle()

Alterna três classes, duas sem incluir force e uma incluindo.

<?php
$dom = Dom\HTMLDocument::createFromString('<p class="font-bold important"></p>', LIBXML_NOERROR);
$p = $dom->body->firstChild;

$classList = $p->classList;
$classList->toggle('font-bold', 'font-small');
$classList->toggle('important', force: true);

echo $dom->saveHtml($p);
?>

O exemplo acima produzirá:

<p class="font-bold important"></p>

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês)

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