PHP 8.4.2 Released!

    The DOMAttr class

    (PHP 5, PHP 7, PHP 8)

    Introduction

    DOMAttr represents an attribute in the DOMElement object.

    Class synopsis

    class DOMAttr extends DOMNode {
    /* Inherited constants */
    public const int DOMNode::DOCUMENT_POSITION_DISCONNECTED = 0x1;
    public const int DOMNode::DOCUMENT_POSITION_PRECEDING = 0x2;
    public const int DOMNode::DOCUMENT_POSITION_FOLLOWING = 0x4;
    public const int DOMNode::DOCUMENT_POSITION_CONTAINS = 0x8;
    public const int DOMNode::DOCUMENT_POSITION_CONTAINED_BY = 0x10;
    public const int DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
    /* Properties */
    public readonly string $name;
    public readonly bool $specified;
    public string $value;
    public readonly ?DOMElement $ownerElement;
    public readonly mixed $schemaTypeInfo;
    /* Inherited properties */
    public readonly string $nodeName;
    public ?string $nodeValue;
    public readonly int $nodeType;
    public readonly ?DOMNode $parentNode;
    public readonly ?DOMElement $parentElement;
    public readonly DOMNodeList $childNodes;
    public readonly ?DOMNode $firstChild;
    public readonly ?DOMNode $lastChild;
    public readonly ?DOMNode $previousSibling;
    public readonly ?DOMNode $nextSibling;
    public readonly ?DOMNamedNodeMap $attributes;
    public readonly bool $isConnected;
    public readonly ?DOMDocument $ownerDocument;
    public readonly ?string $namespaceURI;
    public string $prefix;
    public readonly ?string $localName;
    public readonly ?string $baseURI;
    public string $textContent;
    /* Methods */
    public __construct(string $name, string $value = "")
    public isId(): bool
    /* Inherited methods */
    public DOMNode::appendChild(DOMNode $node): DOMNode|false
    public DOMNode::C14N(
        bool $exclusive = false,
        bool $withComments = false,
        ?array $xpath = null,
        ?array $nsPrefixes = null
    ): string|false
    public DOMNode::C14NFile(
        string $uri,
        bool $exclusive = false,
        bool $withComments = false,
        ?array $xpath = null,
        ?array $nsPrefixes = null
    ): int|false
    public DOMNode::cloneNode(bool $deep = false): DOMNode|false
    public DOMNode::compareDocumentPosition(DOMNode $other): int
    public DOMNode::contains(DOMNode|DOMNameSpaceNode|null $other): bool
    public DOMNode::getLineNo(): int
    public DOMNode::getNodePath(): ?string
    public DOMNode::getRootNode(?array $options = null): DOMNode
    public DOMNode::hasAttributes(): bool
    public DOMNode::hasChildNodes(): bool
    public DOMNode::insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false
    public DOMNode::isDefaultNamespace(string $namespace): bool
    public DOMNode::isEqualNode(?DOMNode $otherNode): bool
    public DOMNode::isSameNode(DOMNode $otherNode): bool
    public DOMNode::isSupported(string $feature, string $version): bool
    public DOMNode::lookupNamespaceURI(?string $prefix): ?string
    public DOMNode::lookupPrefix(string $namespace): ?string
    public DOMNode::normalize(): void
    public DOMNode::removeChild(DOMNode $child): DOMNode|false
    public DOMNode::replaceChild(DOMNode $node, DOMNode $child): DOMNode|false
    public DOMNode::__sleep(): array
    public DOMNode::__wakeup(): void
    }

    Properties

    name

    The name of the attribute.

    ownerElement

    The element which contains the attribute or null.

    schemaTypeInfo

    Not implemented yet, always is null.

    specified

    Not implemented yet, always is true.

    value

    The value of the attribute.

    Note:

    Note, XML entities are expanded upon setting a value. Thus the & character has a special meaning. Setting value to itself will fail when value contains an &. To avoid entity expansion, use DOMElement::setAttribute() instead.

    See Also

    Table of Contents

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    2
    greubel at nkey dot de
    10 years ago
    Please take care on debugging DOMAttr related code. This will cause an E_WARNING that retrieving schemaTypeInfo attribute is not implemented yet. An IDE like Eclipse will inspect the object and its member elements. In conjunction with registered error handlers, which will translate the E_WARNING into Exception your debugging session will end unexpectedly. This has caused me some trouble while debugging my PHPUnit test case in eclipse using "Makegood" plugin.

    A possible workarround is to deactivate the error handling during debugging using error_reporting(0). Remove the statement after finishing your debugging session.

    Notable ticket in Bugtracker: https://bugs.php.net/bug.php?id=61858
    And a xdebug tracker ticket: http://bugs.xdebug.org/view.php?id=910
    up
    1
    chregu at php dot net
    15 years ago
    See also the properties from the inherited class DOMNode ( http://php.net/manual/en/class.domnode.php ), eg. namespaceURI, prefix, localName, etc, especially if you have to deal with namespaced attributes
    ＋add a note
    To Top