Dom\TokenList::toggle

(PHP 8 >= 8.4.0)

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

Beschreibung

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

Toggles the presence of token in the list.

Parameter-Liste

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.

Rückgabewerte

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

Fehler/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.

Beispiele

Beispiel #1 Dom\TokenList::toggle() example

Toggles three classes, two without force, and one with.

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.