Dom\TokenList::toggle

(PHP 8 >= 8.4.0)

Dom\TokenList::toggle — Переключает присутствие лексемы в списке

Описание

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

Переключает присутствие лексемы token в списке.

Список параметров

token: Переключаемая лексема.
force: Если указан параметр force, установка значения true добавит лексему, а установка значения false удалит лексему.

Возвращаемые значения

Метод возвращает значение true, если токен находится в списке после вызова, в противном случае возвращает значение false.

Ошибки

Выбрасывает ошибку ValueError, если токен содержит нулевые байты.
Выбрасывает исключение Dom\DOMException с кодом Dom\SYNTAX_ERR, если лексема является пустой строкой.
Выбрасывает исключение Dom\DOMException с кодом Dom\INVALID_CHARACTER_ERR, если лексема содержит любой пробел ASCII. ASCII whitespace.

Примеры

Пример #1 Пример использования Dom\TokenList::toggle()

Переключает три класса, два без указания параметра force и один с ним.

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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы