The DOMNode class

(PHP 5, PHP 7, PHP 8)

类摘要

class DOMNode {

/* 常量 */

public const int DOCUMENT_POSITION_DISCONNECTED = 0x1;

public const int DOCUMENT_POSITION_PRECEDING = 0x2;

public const int DOCUMENT_POSITION_FOLLOWING = 0x4;

public const int DOCUMENT_POSITION_CONTAINS = 0x8;

public const int DOCUMENT_POSITION_CONTAINED_BY = 0x10;

public const int DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;

/* 属性 */

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;

/* 方法 */

public appendChild(DOMNode $node): DOMNode|false

public C14N(
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): string|false

public C14NFile(
    string $uri,
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): int|false

public cloneNode(bool $deep = false): DOMNode|false

public compareDocumentPosition(DOMNode $other): int

public contains(DOMNode|DOMNameSpaceNode|null $other): bool

public getLineNo(): int

public getNodePath(): ?string

public getRootNode(?array $options = null): DOMNode

public hasAttributes(): bool

public hasChildNodes(): bool

public insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false

public isDefaultNamespace(string $namespace): bool

public isEqualNode(?DOMNode $otherNode): bool

public isSameNode(DOMNode $otherNode): bool

public isSupported(string $feature, string $version): bool

public lookupNamespaceURI(?string $prefix): ?string

public lookupPrefix(string $namespace): ?string

public normalize(): void

public removeChild(DOMNode $child): DOMNode|false

public replaceChild(DOMNode $node, DOMNode $child): DOMNode|false

public __sleep(): array

public __wakeup(): void

}

预定义常量

DOMNode::DOCUMENT_POSITION_DISCONNECTED: Set when the other node and reference node are not in the same tree.
DOMNode::DOCUMENT_POSITION_PRECEDING: Set when the other node precedes the reference node.
DOMNode::DOCUMENT_POSITION_FOLLOWING: Set when the other node follows the reference node.
DOMNode::DOCUMENT_POSITION_CONTAINS: Set when the other node is an ancestor of the reference node.
DOMNode::DOCUMENT_POSITION_CONTAINED_BY: Set when the other node is a descendant of the reference node.
DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: Set when the result depends on implementation-specific behaviour and may not be portable. This may happen with disconnected nodes or with attribute nodes.

属性

nodeName: Returns the most accurate name for the current node type
nodeValue: The value of this node, depending on its type. Contrary to the W3C specification, the node value of DOMElement nodes is equal to DOMNode::textContent instead of null.
nodeType: Gets the type of the node. One of the predefined XML_*_NODE constants
parentNode: The parent of this node. If there is no such node, this returns null.
parentElement: The parent element of this element. If there is no such element, this returns null.
childNodes: A DOMNodeList that contains all children of this node. If there are no children, this is an empty DOMNodeList.
firstChild: The first child of this node. If there is no such node, this returns null.
lastChild: The last child of this node. If there is no such node, this returns null.
previousSibling: The node immediately preceding this node. If there is no such node, this returns null.
nextSibling: The node immediately following this node. If there is no such node, this returns null.
attributes: A DOMNamedNodeMap containing the attributes of this node (if it is a DOMElement) or null otherwise.
isConnected: Whether the node is connected to a document
ownerDocument: The DOMDocument object associated with this node, or null if this node does not have an associated document (e.g. if it is detached, or if it is a DOMDocument).
namespaceURI: The namespace URI of this node, or null if it is unspecified.
prefix: The namespace prefix of this node.
localName: Returns the local part of the qualified name of this node.
baseURI: The absolute base URI of this node or null if the implementation wasn't able to obtain an absolute URI.
textContent: The text content of this node and its descendants.

更新日志

版本	说明
8.4.0	Method DOMNode::compareDocumentPosition() has been added.
8.4.0	Constants `DOMNode::DOCUMENT_POSITION_DISCONNECTED`, `DOMNode::DOCUMENT_POSITION_PRECEDING`, `DOMNode::DOCUMENT_POSITION_FOLLOWING`, `DOMNode::DOCUMENT_POSITION_CONTAINS`, `DOMNode::DOCUMENT_POSITION_CONTAINED_BY`, and `DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC` have been added.
8.3.0	Methods DOMNode::contains(), and DOMNode::isEqualNode() have been added.
8.3.0	Properties DOMNode::$parentElement, and DOMNode::$isConnected have been added.
8.0.0	The unimplemented methods DOMNode::compareDocumentPosition(), DOMNode::isEqualNode(), DOMNode::getFeature(), DOMNode::setUserData() and DOMNode::getUserData() have been removed.

注释

注意:
此 DOM 扩展采用 UTF-8 编码。使用 mb_convert_encoding()、UConverter::transcode() 或 iconv() 来处理其它编码。

参见

» W3C specification of Node

DOMNode::appendChild — Adds new child at the end of the children
DOMNode::C14N — Canonicalize nodes to a string
DOMNode::C14NFile — Canonicalize nodes to a file
DOMNode::cloneNode — Clones a node
DOMNode::compareDocumentPosition — Compares the position of two nodes
DOMNode::contains — Checks if node contains other node
DOMNode::getLineNo — Get line number for a node
DOMNode::getNodePath — Get an XPath for a node
DOMNode::getRootNode — Get root node
DOMNode::hasAttributes — Checks if node has attributes
DOMNode::hasChildNodes — Checks if node has children
DOMNode::insertBefore — Adds a new child before a reference node
DOMNode::isDefaultNamespace — Checks if the specified namespaceURI is the default namespace or not
DOMNode::isEqualNode — Checks that both nodes are equal
DOMNode::isSameNode — Indicates if two nodes are the same node
DOMNode::isSupported — Checks if feature is supported for specified version
DOMNode::lookupNamespaceURI — Gets the namespace URI of the node based on the prefix
DOMNode::lookupPrefix — Gets the namespace prefix of the node based on the namespace URI
DOMNode::normalize — Normalizes the node
DOMNode::removeChild — Removes child from list of children
DOMNode::replaceChild — Replaces a child
DOMNode::__sleep — Forbids serialization unless serialization methods are implemented in a subclass
DOMNode::__wakeup — Forbids unserialization unless unserialization methods are implemented in a subclass

The DOMNode class

类摘要

预定义常量

属性

更新日志

注释

参见

目录