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.

错误／异常

如果 token 包含 null 字节，抛出 ValueError。
如果 token 是空字符串，抛出 code 为 Dom\SYNTAX_ERR 的 Dom\DOMException。
如果 token 包含 ASCII 空格，抛出 code 为 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>

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

Dom\TokenList::toggle

说明

参数

返回值

错误／异常

示例

发现了问题？

用户贡献的备注