Dom\TokenList::toggle

リスト中のトークンの存否を切り換える

説明

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

リスト中の 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>