翻譯不完整。請協助 翻譯此英文文件。
DocumentFragment 介面表示了一個沒有父節點的最小化文件物件。DocumentFragment 被當作一種輕量化的 Document,用以儲存良好格式(well-formed)或非良好格式(non-well-formed)的 XML 片段。
許多方法可以將 DocumentFragment 當作參數傳入(如所有 Node 介面的 Node.appendChild() 及 Node.insertBefore() 方法),在此情況下被加入(appended)或被插入(inserted)的為文件片段的子節點,而非文件片段本身。
This interface is also of great use with Web components: <template> elements contain a DocumentFragment in their HTMLTemplateElement.content property.
一個空的 DocumentFragment 物件可使用 document.createDocumentFragment() 方法或 DocumentFragment 的建構式來建立。
屬性
This interface has no specific property, but inherits those of its parent, Node, and implements those of the ParentNode interface.
ParentNode.childrenRead only- Returns a live
HTMLCollectioncontaining all objects of typeElementthat are children of theDocumentFragmentobject. ParentNode.firstElementChildRead only- Returns the
Elementthat is the first child of theDocumentFragmentobject, ornullif there is none. ParentNode.lastElementChildRead only- Returns the
Elementthat is the last child of theDocumentFragmentobject, ornullif there is none. ParentNode.childElementCountRead only- Returns an
unsigned longgiving the amount of children that theDocumentFragmenthas.
建構式
DocumentFragment()- Returns an empty
DocumentFragmentobject.
方法
This interface inherits the methods of its parent, Node, and implements those of the ParentNode interface.
DocumentFragment.find()- Returns the first matching
Elementin the tree of theDocumentFragment. DocumentFragment.findAll()- Returns a
NodeListof matchingElementin the tree of theDocumentFragment. DocumentFragment.querySelector()- Returns the first
Elementnode within theDocumentFragment, in document order, that matches the specified selectors. DocumentFragment.querySelectorAll()- Returns a
NodeListof all theElementnodes within theDocumentFragmentthat match the specified selectors.
DocumentFragment.getElementById()- Returns the first
Elementnode within theDocumentFragment, in document order, that matches the specified ID.
規範
| Specification | Status | Comment |
|---|---|---|
| DOM The definition of 'DocumentFragment' in that specification. |
Living Standard | Added the constructor and the implementation of ParentNode. |
| Selectors API Level 2 The definition of 'DocumentFragment' in that specification. |
Working Draft | Added the find() and findAll() methods. |
| Selectors API Level 1 The definition of 'DocumentFragment' in that specification. |
Recommendation | Added the querySelector() and querySelectorAll() methods. |
| Document Object Model (DOM) Level 3 Core Specification The definition of 'DocumentFragment' in that specification. |
Recommendation | 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. |
Recommendation | No change from Document Object Model (DOM) Level 1 Specification |
| Document Object Model (DOM) Level 1 Specification The definition of 'DocumentFragment' in that specification. |
Recommendation | Initial definition |
瀏覽器相容性
| 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() |
No support | No support | No support | No support | No support |
DocumentFragment() constructor |
28.0 | 24.0 (24.0) | No support | 15.0 | No support |
ParentNode properties |
28.0 | 25.0 (25.0) | No support | 15.0 | No support |
ParentNode methods |
No support | No support | No support | No support | No support |
| 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 | 1.0 (1.0) | 8.0 | 10.0 | 3.2 (525.3) |
findAll() and find() |
No support | No support | No support | No support | No support |
DocumentFragment() constructor |
? | 24.0 (24.0) | No support | ? | ? |
ParentNode properties |
(Yes) | 25.0 (25.0) | No support | 5.0 | No support |
ParentNode methods |
No support | No support | No support | No support | No support |

