PHP 8.5.0 Beta 2 available for testing

    Dom\TokenList::toggle

    (PHP 8 >= 8.4.0)

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

    説明

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

    Toggles the presence of token in the list.

    パラメータ

    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.

    戻り値

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

    エラー / 例外

    • トークンが NULL バイトを含んでいる場合、 ValueError をスローします。
    • トークンが空文字列である場合、エラーコード Dom\SYNTAX_ERR を持つ Dom\DOMException をスローします。
    • トークンが ASCII の空白文字を含む場合、エラーコード Dom\INVALID_CHARACTER_ERR を持つ Dom\DOMException をスローします。

    例

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

    上の例の出力は以下となります。

    <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.
    To Top