[edit] Last updated: Fri, 10 Feb 2012

DOMNode クラス

(PHP 5)

クラス概要

DOMNode {

/* プロパティ */

public readonly string $DOMNode->nodeName ;

public string $nodeValue ;

public readonly int $nodeType ;

public readonly DOMNode $parentNode ;

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 DOMDocument $ownerDocument ;

public readonly string $namespaceURI ;

public string $prefix ;

public readonly string $localName ;

public readonly string $baseURI ;

public string $textContent ;

/* メソッド */

public DOMNode DOMNode::appendChild ( DOMNode $newnode )

public string DOMNode::C14N ([ bool $exclusive [, bool $with_comments [, array $xpath [, array $ns_prefixes ]]]] )

public int DOMNode::C14NFile ( string $uri [, bool $exclusive [, bool $with_comments [, array $xpath [, array $ns_prefixes ]]]] )

public DOMNode DOMNode::cloneNode ([ bool $deep ] )

public int DOMNode::getLineNo ( void )

public string DOMNode::getNodePath ( void )

public bool DOMNode::hasAttributes ( void )

public bool DOMNode::hasChildNodes ( void )

public DOMNode DOMNode::insertBefore ( DOMNode $newnode [, DOMNode $refnode ] )

public bool DOMNode::isDefaultNamespace ( string $namespaceURI )

public bool DOMNode::isSameNode ( DOMNode $node )

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

public string DOMNode::lookupNamespaceURI ( string $prefix )

public string DOMNode::lookupPrefix ( string $namespaceURI )

public void DOMNode::normalize ( void )

public DOMNode DOMNode::removeChild ( DOMNode $oldnode )

public DOMNode DOMNode::replaceChild ( DOMNode $newnode , DOMNode $oldnode )

}

プロパティ

nodeName: 現在のノード型の正確な名前を返す
nodeValue: その型に応じてノードの値を返す
nodeType: ノードの型を、定義済みの定数 XML_xxx_NODE のいずれかで返す
parentNode: このノードの親を返す
childNodes: このノードのすべての子を含む DOMNodeList。子が存在しない場合は、空の DOMNodeList
firstChild: このノードの最初の子。存在しない場合は NULL を返す
lastChild: このノードの最後の子。存在しない場合は NULL を返す
previousSibling: このノードの直前のノード。存在しない場合は NULL を返す
nextSibling: このノードの直後のノード。存在しない場合は NULL を返す
attributes: このノードが DOMElement の場合はノードの属性を含む DOMNamedNodeMap、それ以外の場合は NULL
ownerDocument: このノードに関連付けられている DOMDocument オブジェクト
namespaceURI: このノードの名前空間 URI。指定されていない場合は NULL
prefix: このノードの名前空間プレフィックス。指定されていない場合は NULL
localName: このノードの名前のローカル部分を返す
baseURI: このノードの完全なベース URI。もし実装が完全な URL をできなかった場合は NULL
textContent: このノードとその子孫ノードのテキストを返す

注意

注意:
DOM 拡張モジュールは UTF-8 エンコーディングを使用します。ISO-8859-1 エンコーディングのテキストを扱うには utf8_encode() と utf8_decode() を使用します。またその他のエンコーディングを扱うには Iconv を使用します。

参考

» W3C specification of Node

DOMNode::appendChild — 子要素群の最後に新しい子要素を追加する
DOMNode::C14N — ノードを文字列に正規化する
DOMNode::C14NFile — ノードをファイルに正規化する
DOMNode::cloneNode — ノードを複製する
DOMNode::getLineNo — ノードが存在する行の番号を取得します。
DOMNode::getNodePath — ノードの XPath を取得する
DOMNode::hasAttributes — ノードが属性を保持しているかどうかを調べる
DOMNode::hasChildNodes — ノードが子を保持しているかどうかを調べる
DOMNode::insertBefore — 参照しているノードの前に新しい子を追加する
DOMNode::isDefaultNamespace — 指定した namespaceURI がデフォルトの名前空間かどうかを調べる
DOMNode::isSameNode — 2 つのノードが等しいかどうかを調べる
DOMNode::isSupported — 指定したバージョンで機能がサポートされているかどうかを調べる
DOMNode::lookupNamespaceURI — プレフィックスに基づいて、ノードの名前空間 URI を取得する
DOMNode::lookupPrefix — 名前空間 URI に基づいて、ノードの名前空間プレフィックスを取得する
DOMNode::normalize — ノードを正規化する
DOMNode::removeChild — 子要素群から子要素を削除する
DOMNode::replaceChild — 子を置き換える

DOMNode::appendChild

DOMNamedNodeMap::item

[edit] Last updated: Fri, 10 Feb 2012

add a note User Contributed Notes DOMNode

alastair dot dallas at gmail dot com 25-Sep-2011 05:44


The issues around mixed content took me some experimentation to remember, so I thought I'd add this note to save others time.



When your markup is something like: <div><p>First text.</p><ul><li><p>First bullet</p></li></ul></div>, you'll get XML_ELEMENT_NODEs that are quite regular. The <div> has children <p> and <ul> and the nodeValue for both <p>s yields the text you expect.



But when your markup is more like <p>This is <b>bold</b> and this is <i>italic</i>.</p>, you realize that the nodeValue for XML_ELEMENT_NODEs is not reliable. In this case, you need to look at the <p>'s child nodes. For this example, the <p> has children: #text, <b>, #text, <i>, #text. 



In this example, the nodeValue of <b> and <i> is the same as their #text children. But you could have markup like: <p>This <b>is bold and <i>bold italic</i></b>, you see?</p>. In this case, you need to look at the children of <b>, which will be #text, <i>, because the nodeValue of <b> will not be sufficient.



XML_TEXT_NODEs have no children and are always named '#text'. Depending on how whitespace is handled, your tree may have "empty" #text nodes as children of <body> and elsewhere.



Attributes are nodes, but I had forgotten that they are not in the tree expressed by childNodes. Walking the full tree using childNodes will not visit any attribute nodes.

mjpelmear at gmail dot com 03-Jun-2011 10:33


getAttribute() returns an empty string if the requested attribute doesn't exist in the node.

stilgar at gilevski dot fakepart dot name 21-May-2011 10:17


If you have empty $node->textContent and $node->textValue, check if document that is loaded have UTF-8 encoding.

imranomar at gmail dot com 20-Mar-2011 03:10


Just discovered that node->nodeValue strips out all the tags

I. Cook 19-Apr-2010 11:43


For a reference with more information about the XML DOM node types, see http://www.w3schools.com/dom/dom_nodetype.asp



(When using PHP DOMNode, these constants need to be prefaced with "XML_")

R. Studer 13-Jan-2010 06:03


For clarification:

The assumingly 'discoverd' by previous posters and seemingly undocumented methods (.getElementsByTagName and .getAttribute) on this class (DOMNode) are in fact methods of the class DOMElement, which inherits from DOMNode.



See: http://www.php.net/manual/en/class.domelement.php

David Rekowski 08-Jan-2010 10:54


You cannot simply overwrite $textContent, to replace the text content of a DOMNode, as the missing readonly flag suggests. Instead you have to do something like this:



<?php



$node->removeChild($node->firstChild);

$node->appendChild(new DOMText('new text content'));



?>



This example shows what happens:



<?php



$doc = DOMDocument::loadXML('<node>old content</node>');

$node = $doc->getElementsByTagName('node')->item(0);

echo "Content 1: ".$node->textContent."\n";



$node->textContent = 'new content';

echo "Content 2: ".$node->textContent."\n";



$newText = new DOMText('new content');



$node->appendChild($newText);

echo "Content 3: ".$node->textContent."\n";



$node->removeChild($node->firstChild);

$node->appendChild($newText);

echo "Content 4: ".$node->textContent."\n";



?>



The output is:



Content 1: old content // starting content

Content 2: old content // trying to replace overwriting $node->textContent

Content 3: old contentnew content // simply appending the new text node

Content 4: new content // removing firstchild before appending the new text node



If you want to have a CDATA section, use this:



<?php

$doc = DOMDocument::loadXML('<node>old content</node>');

$node = $doc->getElementsByTagName('node')->item(0);

$node->removeChild($node->firstChild);

$newText = $doc->createCDATASection('new cdata content');

$node->appendChild($newText);

echo "Content withCDATA: ".$doc->saveXML($node)."\n";

?>

Steve K 03-Nov-2009 08:47


This class apparently also has a getElementsByTagName method.



I was able to confirm this by evaluating the output from DOMNodeList->item() against various tests with the is_a() function.

marc at ermshaus dot org 05-May-2009 05:36


It took me forever to find a mapping for the XML_*_NODE constants. So I thought, it'd be handy to paste it here:



 1 XML_ELEMENT_NODE

 2 XML_ATTRIBUTE_NODE

 3 XML_TEXT_NODE

 4 XML_CDATA_SECTION_NODE

 5 XML_ENTITY_REFERENCE_NODE

 6 XML_ENTITY_NODE

 7 XML_PROCESSING_INSTRUCTION_NODE

 8 XML_COMMENT_NODE

 9 XML_DOCUMENT_NODE

10 XML_DOCUMENT_TYPE_NODE

11 XML_DOCUMENT_FRAGMENT_NODE

12 XML_NOTATION_NODE

matt at lamplightdb dot co dot uk 06-Apr-2009 02:39


And apparently also a setAttribute method too:



$node->setAttribute( 'attrName' , 'value' );

jorge dot hebrard at gmail dot com 24-Jan-2009 02:29


Try canonicalization:

<?php

$dom = new DOMDocument;

$dom->loadHTMLFile('http://www.example.com/');

echo $dom->documentElement->C14N();

?>



Or output it to a file, using C14NFile()



Undocumented stuff ;)

brian wildwoodassociates.info 08-Dec-2008 08:27


This class has a getAttribute method.



Assume that a DOMNode object $ref contained an anchor taken out of a DOMNode List.  Then 



    $url = $ref->getAttribute('href'); 



would isolate the url associated with the href part of the anchor.

add a note

DOMNode クラス

クラス概要

プロパティ

注意

参考

目次