Dom\TokenList::add

(PHP 8 >= 8.4.0)

Dom\TokenList::add — Adds the given tokens to the list

Beschreibung

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

Adds the given tokens to the list, but not any that were already present.

Parameter-Liste

tokens: The tokens to add.

Rückgabewerte

Es wird kein Wert zurückgegeben.

Fehler/Exceptions

Wenn ein Token Null-Bytes enthält, wird ein ValueError ausgelöst.
Wenn ein Token eine leere Zeichenkette ist, wird eine Dom\DOMException mit dem Code Dom\SYNTAX_ERR ausgelöst.
Wenn ein Token ein ASCII-Leerzeichen enthält, wird eine Dom\DOMException mit dem Code Dom\INVALID_CHARACTER_ERR ausgelöst.

Beispiele

Beispiel #1 Dom\TokenList::add() example

Adds two classes to a newly created paragraph element.

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

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

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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