DOMNode クラス

(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 function appendChild(DOMNode $node): DOMNode|false
public function C14N(
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): string|false
public function C14NFile(
    string $uri,
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): int|false
public function cloneNode(bool $deep = false): DOMNode|false
public function compareDocumentPosition(DOMNode $other): int
public function contains(DOMNode|DOMNameSpaceNode|null $other): bool
public function getLineNo(): int
public function getNodePath(): ?string
public function getRootNode(?array $options = null): DOMNode
public function hasAttributes(): bool
public function hasChildNodes(): bool
public function insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false
public function isDefaultNamespace(string $namespace): bool
public function isEqualNode(?DOMNode $otherNode): bool
public function isSameNode(DOMNode $otherNode): bool
public function isSupported(string $feature, string $version): bool
public function lookupNamespaceURI(?string $prefix): ?string
public function lookupPrefix(string $namespace): ?string
public function normalize(): void
public function removeChild(DOMNode $child): DOMNode|false
public function replaceChild(DOMNode $node, DOMNode $child): DOMNode|false
public function __sleep(): array
public function __wakeup(): void
}

定義済み定数

DOMNode::DOCUMENT_POSITION_DISCONNECTED
もう一方のノードと参照ノードが同じツリー内にない場合に設定されます。
DOMNode::DOCUMENT_POSITION_PRECEDING
もう一方のノードが参照ノードより前にある場合に設定されます。
DOMNode::DOCUMENT_POSITION_FOLLOWING
もう一方のノードが参照ノードの後に続く場合に設定されます。
DOMNode::DOCUMENT_POSITION_CONTAINS
もう一方のノードが参照ノードの祖先である場合に設定されます。
DOMNode::DOCUMENT_POSITION_CONTAINED_BY
もう一方のノードが参照ノードの子孫である場合に設定されます。
DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
結果が実装依存の動作に基づいており、移植性がない場合に設定されます。 これは、同じツリー内にないノードや属性ノードの場合に発生する可能性があります。

プロパティ

nodeName

現在のノード型の正確な名前を返す

nodeValue

その型に応じてノードの値を返す。 W3C の仕様とは異なり、 DOMElement ノードの値は null ではなく DOMNode::textContent と等しくなる。

nodeType

ノードの型を、定義済みの定数 XML_*_NODE のいずれかで返す

parentNode

このノードの親 (存在しない場合は null) を返す

parentElement

この要素の親要素。存在しない場合は null を返す

childNodes

このノードのすべての子を含む DOMNodeList。 子が存在しない場合は、空の DOMNodeList

firstChild

このノードの最初の子。存在しない場合は null を返す

lastChild

このノードの最後の子。存在しない場合は null を返す

previousSibling

このノードの直前のノード。存在しない場合は null を返す

nextSibling

このノードの直後のノード。存在しない場合は null を返す

attributes

このノードが DOMElement の場合は ノードの属性を含む DOMNamedNodeMap、 それ以外の場合は null

isConnected

ノードが Document に接続されているかどうか

ownerDocument

このノードに関連付けられている DOMDocument オブジェクト。 このノードが関連付けられた文書を持たない場合は null (例: ノードがデタッチされているか、DOMDocument だった場合)

namespaceURI

このノードの名前空間 URI。指定されていない場合は null

prefix

このノードの名前空間プレフィックス

localName

このノードの名前のローカル部分を返す

baseURI

このノードの完全なベース URI。もし実装が完全な URL を できなかった場合は null

textContent

このノードとその子孫ノードのテキスト

変更履歴

バージョン 説明
8.4.0 DOMNode::compareDocumentPosition() メソッドが追加されました。
8.4.0 以下の定数が新たに追加されました。 DOMNode::DOCUMENT_POSITION_DISCONNECTED、 DOMNode::DOCUMENT_POSITION_PRECEDING、 DOMNode::DOCUMENT_POSITION_FOLLOWING、 DOMNode::DOCUMENT_POSITION_CONTAINS、 DOMNode::DOCUMENT_POSITION_CONTAINED_BY、および DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC。
8.3.0 DOMNode::contains() と、 DOMNode::isEqualNode() というメソッドが追加されました。
8.3.0 プロパティ DOMNode::$parentElement と DOMNode::$isConnected が追加されました。
8.0.0 実装されていなかったメソッド DOMNode::compareDocumentPosition(), DOMNode::isEqualNode(), DOMNode::getFeature(), DOMNode::setUserData(), DOMNode::getUserData() が削除されました。

注意

注意:

DOM拡張モジュール は UTF-8 エンコーディングを使います。他のエンコーディングを扱う場合は、mb_convert_encoding(), UConverter::transcode(), iconv() を使ってください。

参考

目次