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 を返します。

    エラー / 例外

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

    例

    例1 Dom\TokenList::toggle() の例

    3つのクラスを切り替えます。 2つは force を指定せず、 1つは指定します

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