DocumentFragment

A interface do DocumentFragment representa um objeto de documento mínimo que não possui pai. Ela é utilizada como uma versão leve de Document para armazenar fragmentos bem formados ou fragments potencialmente mal formados de XML.

Vários outros métodos podem usar um document fragment como argumento (ex. qualquer interface de Node como Node.appendChild e Node.insertBefore) em casos em que os filhos do fragment são acrescentados ou inseridos, e não o próprio fragment.

Essa interface também é excelente para ser usada com Web components: elementos <template>  contém um DocumentFragment na propriedade HTMLTemplateElement.content (en-US) deles.

Um DocumentFragment pode ser criado usando o método document.createDocumentFragment (en-US) ou o construtor.

Propriedades

Essa interface não tem uma propriedade específica, mas herda de seu pai, Node, e implementa aquelas da interface ParentNode.

ParentNode.children Somente leitura This is an experimental API that should not be used in production code.
Returns a live HTMLCollection containing all objects of type Node that are children of the DocumentFragment object.
ParentNode.firstElementChild (en-US) Somente leitura This is an experimental API that should not be used in production code.
Returns the Element that is the first child of the DocumentFragment object, or null if there is none.
ParentNode.lastElementChild (en-US) Somente leitura This is an experimental API that should not be used in production code.
Returns the Element that is the last child of the DocumentFragment object, or null if there is none.
ParentNode.childElementCount Somente leitura This is an experimental API that should not be used in production code.
Returns an unsigned long giving the amount of children that the DocumentFragment has.

Construtor

DocumentFragment() (en-US) This is an experimental API that should not be used in production code.
Retorna um objeto DocumentFragment vazio.

Métodos

This interface inherits the methods of its parent, Node, and implements those of the ParentNode interface.

DocumentFragment.find() This is an experimental API that should not be used in production code.
Returns the first matching Element in the tree of the DocumentFragment.
DocumentFragment.findAll() This is an experimental API that should not be used in production code.
Returns a NodeList of matching Element in the tree of the DocumentFragment.
DocumentFragment.querySelector() (en-US)
Returns the first Element node within the DocumentFragment, in document order, that matches the specified selectors.
DocumentFragment.querySelectorAll() (en-US)
Returns a NodeList of all the Element nodes within the DocumentFragment that match the specified selectors.
DocumentFragment.getElementById()
Returns the first Element node within the DocumentFragment, in document order, that matches the specified ID.

Especificações

Specification Status Comment
DOM
The definition of 'DocumentFragment' in that specification.
Padrão em tempo real Added the constructor and the implementation of ParentNode.
Selectors API Level 2
The definition of 'DocumentFragment' in that specification.
Obsoleto Added the find() and findAll() methods.
Selectors API Level 1
The definition of 'DocumentFragment' in that specification.
Obsoleto Added the querySelector() and querySelectorAll() methods.
Document Object Model (DOM) Level 3 Core Specification
The definition of 'DocumentFragment' in that specification.
Obsoleto No change from Document Object Model (DOM) Level 2 Core Specification
Document Object Model (DOM) Level 2 Core Specification
The definition of 'DocumentFragment' in that specification.
Obsoleto No change from Document Object Model (DOM) Level 1 Specification
Document Object Model (DOM) Level 1 Specification
The definition of 'DocumentFragment' in that specification.
Obsoleto Initial definition

Browser compatibility

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar! (en-US)

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
querySelector() and querySelectorAll() 1.0 3.5 (1.9.1) 8.0 10.0 3.2 (525.3)
findAll() and find() This is an experimental API that should not be used in production code. Não suportado Não suportado Não suportado Não suportado Não suportado
DocumentFragment() constructor This is an experimental API that should not be used in production code. 28.0 24.0 (24.0) Não suportado 15.0 Não suportado
ParentNode properties This is an experimental API that should not be used in production code. 28.0 25.0 (25.0) Não suportado 15.0 Não suportado
ParentNode methods This is an experimental API that should not be used in production code. Não suportado Não suportado Não suportado Não suportado Não suportado
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)
querySelector() and querySelectorAll() 2.1 3.5 (1.9.1) 8.0 10.0 3.2 (525.3)
findAll() and find() This is an experimental API that should not be used in production code. Não suportado Não suportado Não suportado Não suportado Não suportado
DocumentFragment() constructor This is an experimental API that should not be used in production code. ? 24.0 (24.0) Não suportado ? ?
ParentNode properties This is an experimental API that should not be used in production code. 28.0 25.0 (25.0) Não suportado 5.0 Não suportado
ParentNode methods This is an experimental API that should not be used in production code. Não suportado Não suportado Não suportado Não suportado Não suportado

Veja também