文脈 [11] DocumentFragment 節点 は createDocumentFragment メソッド により自由に作ることができます。
[12] template 要素 を作ると、雛形内容 として自動的に関連付けられた
DocumentFragment オブジェクト が作られます。
[13] ShadowRoot インターフェイス は DocumentFragment インターフェイス を継承しています。
[14] 仕様書上の技法として、複数の節点 を挿入する操作を記述するために (架空の) DocumentFragment 節点 を使うことがあり、 DOM Standard や HTML Standard で使われています。
[21] 他の節点 はソースコード 上の何らかの構造と対応関係を持ちますが、
唯一 DocumentFragment はスクリプト の便宜のため導入されたもので、
HTML構文 やXML構文 で表すことができません。
[16] RDFデータ型 の rdf:HTML や
rdf:XMLLiteral は、値空間 に
DocumentFragment を使っています。
メモ [3] 文書素片Document fragment は、
その名の通り文書 の素片 です。
XML の (内容 から参照されている)
整形式 外部解析対象実体 に丁度相当します。
[6]
文書Document 節ノード は、
要素節 を1つしか持てません。
それに対して、文書断片節は複数の要素節を持てますし、
その節の外側に文節 などを自由に配置できます。
[1] 文書断片節DocumentFragment node は、
次の種類の節 を子供に持てます:
Element ProcessingInstruction Comment Text CDATASection EntityReference [2] DocumentFragment 界面 (Interface)
は、 Node 構成員メンバー の定義はありません。)
[4] 文書素片物体オブジェクト を
(appendChild
他の節のどこかに挿入すると、
(他の節物体ならその節がそのままその位置に挿入されるのに対し、)
当該文書断片の子節 がその位置に挿入されます。
その文書断片は空 (子節なし) になります。
[5] 文書の一部を用意しておいて、それを組立てるのに便利です。
例えば、次の架空の言語の DOM 束縛を使って書いた code
は、見出し要素節と段落群(文書断片)節から章要素節を作ります。
my $heading := $document.createElement ('h');
$heading.appendChild ($document.createTextNode ('Heading'));
my $paragraphs := $document.createDocumentFragment ();
for my $i (1..10) {
my $paragraph := $document.createElement ('p');
$paragraph.appendChild ($document.createTextNode ("Paragraph $i");
$paragraphs.appendChild ($paragraph);
}
;; ここで、 $heading 節は
;; <h>:$heading
;; +-- "Heading"
;; $paragraphs 節は
;; {断片}:$paragraphs
;; +-- <p>
;; | +-- "Paragraph 1"
;; +-- <p>
;; | +-- "Paragraph 2"
;; :
;; +-- <p>
;; +-- "Paragraph 10"
;; という構造になっている。
my $section = makeSection ($heading, $paragraphs);
function makeSection ($heading, $paragraphs) {
my $section = $document.createElement ('section');
$section.appendChild ($heading);
$section.appendChild ($paragraph);
return $section;
}
;; 最終的に、 $section 節は次のような構造となる。
;; <section>
;; +-- <h>:$heading
;; | +-- "Heading"
;; +-- <p>
;; | +-- "Paragraph 1"
;; +-- <p>
;; | +-- "Paragraph 2"
;; :
;; +-- <p>
;; +-- "Paragraph 10"
;; {断片} の節そのものは消滅したことに注意。 [7] 仕様書:
[DOM1] Document Object Model (Core) Level 1 http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-B63ED1A3 [DOM2] Document Object Model Core http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-B63ED1A3 [8]
文書ツリーを多数回変更するときはDocument Fragmentを経由する (agenda) (2008-02-20 02:55:06 +09:00 版) http://jintrick.net/agenda/2008/02/document-fragment.html
[9] Opera9.5+ DocumentFragment 経由でノードを追加すると再描画しない - uupaaの開発日記 (2008-12-27 15:05:25 +09:00 版) http://d.hatena.ne.jp/uupaa/20081022/1224674908
[10] Add constructors for DocumentFragment, Text, and Comment. (DocumentType ... · a2f1e18 · whatwg/dom
( (2013-02-16 12:38:10 +09:00 版))
https://github.com/whatwg/dom/commit/a2f1e18ff56ecc12643dc54fcf50f0c335beec71
[15] XQuery and XPath Data Model 3.0
( (2014-04-08 07:00:06 +09:00 版))
http://www.w3.org/TR/xpath-datamodel-3/#dt-fragment
[17] Shadow: add shadow root · whatwg/dom@b2ee400
(2016-03-16 14:23:18 +09:00 版)
https://github.com/whatwg/dom/commit/b2ee400a6542dc76d41bed5d2edb8c85ba241bfc
[18] Editorial: be clearer on host, define light tree · whatwg/dom@ce7df0b
(2016-03-20 18:55:17 +09:00 版)
https://github.com/whatwg/dom/commit/ce7df0bfe425b4502bb40e66806dd76f14fcf68b
[19] Set <template>'s DocumentFragment's host · whatwg/html@baa8e34
(2016-03-20 18:57:17 +09:00 版)
https://github.com/whatwg/html/commit/baa8e346d737c115d4a676caa4a172983b87255e
[23] Specify global object references in more detail
(annevk 著, 2016-08-17 19:43:59 +09:00 )
https://github.com/whatwg/dom/commit/fa8adb6cd107cd845feaeb71c9da208971b670ca
[26] Align with IDL constructor changes
(autokagami 著, 2019-09-24 22:42:56 +09:00 )
https://github.com/whatwg/dom/commit/57512fac17cf2f1c4c85be4aec178c8086ee5ee4
[27] Update to constructor operations · Issue #780 · whatwg/dom
(2020-05-14 14:04:50 +09:00 )
https://github.com/whatwg/dom/issues/780