Dom\TokenList::add

(PHP 8 >= 8.4.0)

Dom\TokenList::add — 指定されたトークンをリストに追加する

説明

public function Dom\TokenList::add(string ...$tokens): void

指定された tokens をリストに追加しますが、既に存在しないものに限ります。

パラメータ

tokens: 追加するトークン

戻り値

値を返しません。

エラー / 例外

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

例

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

新しく作成したパラグラフ要素に、クラスを2つ追加します。

<?php
$dom = Dom\HTMLDocument::createEmpty();
$p = $dom->createElement('p');

$classList = $p->classList;
$classList->add('font-bold', 'important');

echo $dom->saveHtml($p);
?>

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

<p class="font-bold important"></p>

関連キーワード:

トークン TokenList tokens classList エラーコード DOMException font bold important contains バイト ValueError 空白パラグラフ HTMLDocument createEmpty createElement saveHtml