betterCode() PHP 2025

    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>

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

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

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

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