Last updated: Sun, 25 Nov 2007

DOMDocument->createDocumentFragment()

(No version information available, might be only in CVS)

DOMDocument->createDocumentFragment() — Create new document fragment

설명

DOMDocument

DOMDocumentFragment createDocumentFragment ( void )

This function creates a new instance of class DOMDocumentFragment. 이 노드는 DOMNode->appendChild() 등을 통하여 삽입하지 않으면 보여지지 않습니다.

반환값

The new DOMDocumentFragment or FALSE if an error occured.

참고

DOMDocument->createElement()

DOMDocument->createComment()

Last updated: Sun, 25 Nov 2007

add a note User Contributed Notes
DOMDocument->createDocumentFragment()

xavier.pinard at laposte.net
13-Jul-2006 07:08


The interest of fragment is I think :



 - only nodes inside the fragment are inserted, 

   not the fragment itself when you insert the fragment

 - you can append String litteral with the method

   DOMDocumentFragment->appendXML()



So, a fragment may look like this :



part of document<li>bla bla </li> ...



This fragment is describe with a fragment description

 that may look like this is you use 

it as an "XML Fragment Interchange" :



<f:fcs xmlns:f="http://www.w3.org/2001/02/xml-fragment"



[...]



<myOriginalStructure>



[...]



<f:fragbody/>



[...]



</myOriginalStructure>



cf :: http://www.w3.org/TR/xml-fragment



An example could be for "XML Fragment Interchange":



$dom = new DomDocument();

$frag = $dom->createDocumentFragment();

$fragbody = $dom->createElementNS(

 'http://www.w3.org/2001/02/xml-package',

 'p:body'

);

$frag->appendXML(

 'test fragment<ilo>data</ilo> + 

 an object property +

 something else '

);

$fragbody->appendChild($frag);

$dom->appendChild($fragbody);

var_dump($dom->saveXML());

jb at jbpros dot com
12-May-2006 08:04


DOMDocumentFragment can be very useful with XPath: you may need to apply an XPath expression to a list of nodes.



$dom_doc = new DOMDocument();

$dom_fragment = $dom_doc->createDocumentFragment();

$dom_element_a1 = $dom_fragment->appendChild($dom_doc->createElement('a', 'first node'));

$dom_element_a2 = $dom_fragment->appendChild($dom_doc->createElement('a', 'second node'));

$xpath = new DOMXpath($dom_doc);

$nodes = $xpath->query('a', $dom_fragment);



foreach ($nodes as $node) {

    echo $node->textContent . "\n";

}



This way you do not need to embed the nodes within a parent element that could be returned by the xpath expression when you do not want this to happen.

02-Dec-2005 12:58


You can append document fragments to documents. This will append their nodes instead of fragment node itself.

So if you're asking yourself "how do I make function that returns more than one node" - that is the answer.

Naonak
15-Sep-2005 10:31


Example :



$dom = new DomDocument;

$frag = $dom->createDocumentFragment();

$fragment= $dom->createElement( 'fragment' );

$frag->appendChild( $fragment);



$domNode = $dom2->importNode($frag, true);

$dom2->appendChild( $domNode );



print_r($dom2->saveXML());

add a note

DOMDocument->createElement()

DOMDocument->createComment()

Last updated: Sun, 25 Nov 2007