PHP: Dom\TokenList::toggle - Manual

(PHP 8 >= 8.4.0)

Dom\TokenList::toggle — Toggles the presence of a token in the list

Description

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

Toggles the presence of token in the list.

Parameters

token

The token to toggle.

force

If force is provided, setting it to true will add the token, and setting it to false will remove the token.

Return Values

Returns true if the token is in the list after the call, false otherwise.

Errors/Exceptions

• Throws a ValueError if a token contains any null bytes.
• Throws a Dom\DOMException with code Dom\SYNTAX_ERR if a token is the empty string.
• Throws a Dom\DOMException with code Dom\INVALID_CHARACTER_ERR if a token contains any ASCII whitespace.

Examples

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

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