Home/ Manual/ dom / domelement/ DOMElement::setAttribute

DOMElement::setAttribute

PHP function Edit on GitHub ✎

(PHP 5, PHP 7, PHP 8)

Adds new or modifies existing attribute

Description

DOMElement::setAttribute(string $qualifiedName, string $value): DOMAttr|bool

Sets an attribute with name qualifiedName to the given value. If the attribute does not exist, it will be created.

Parameters

qualifiedName: The name of the attribute.
value: The value of the attribute.

Return Values

The created or modified DOMAttr or false if an error occurred.

Errors/Exceptions

May throw a DOMException with the following error codes:

DOM_NO_MODIFICATION_ALLOWED_ERR: Raised if the node is readonly.

Examples

Setting an attribute

php

<?php
$doc = new DOMDocument("1.0");
$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);
$newnode->setAttribute("align", "left");
?>