-
Notifications
You must be signed in to change notification settings - Fork 4
/
464.txt
113 lines (78 loc) · 7.09 KB
/
464.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
[2] [CODE(HTMLe)@en[[[template]]]] [[要素]]に関連付けられた[[内容]]を[DFN[[RUBYB[雛形内容]@en[template content]]]]といい、
[CODE(DOMi)@en[[[DocumentFragment]]]] [[節点]]として表されます。通常の[[要素]]では[[内容]] ([[子供]]) となるものが、
[CODE(HTMLe)@en[[[template]]]] [[要素]]では[[雛形内容]]となります。[[雛形内容]]には [CODE(DOMi)@en[[[HTMLTemplateElement]]]]
[[インターフェイス]]の [DFN[[CODE(DOMa)@en[[[content]]]]]] [[IDL属性]]を通じてアクセスできます。
* 仕様書
[REFS[
- [1] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2013-12-19 00:10:55 +09:00]] 版) <http://www.whatwg.org/specs/web-apps/current-work/#template-contents>
]REFS]
* 処理モデル
[11] [CODE(HTMLe)@en[[[template]]]] [[要素]]が作られると、自動的に [CODE(DOMi)@en[[[DocumentFragment]]]]
[[節点]]が作られ、[[雛形内容]]となります。
[CODE(DOMi)@en[DocumentFragment]] の[F[ホスト][host (DOM)]]は、
[CODE(HTMLe)@en[template]] [[要素]]に設定されます [SRC[>>1]]。
[10] [CODE(HTMLe)@en[[[template]]]] [[要素]]の [[cloning steps]] は、子供も複製するモードの場合
([CODE(DOMm)@en[[[cloneNodes]]]] [[メソッド]]の引数が[[真]]の場合) には[[雛形内容]]も複製します。
[18] [CODE(HTMLe)@en[[[template]]]] [[要素]]と[[雛形内容]]の関係は、一度[[要素]]が作られたらずっと変化することはありません。
;; [16] [CODE(DOMi)@en[[[DocumentFragment]]]] は [CODE(DOMm)@en[[[appendChild]]]] などでもそれ自体には[[親]]ができませんし、
[[ホスト]]が生じる [[DOM]] メソッドは存在しないので、[[親]]や[[ホスト]]が複数生じることはありません。
* 節点文書
[4] [[雛形内容]]である [CODE(DOMi)@en[[[DocumentFragment]]]] とその[[子孫]]の[[節点文書]]
([CODE(DOMa)@en[[[ownerDocument]]]]) は[DFN[[RUBYB[適切な雛形内容所有子文書]@en[appropriate template contents owner document]]]]
[SRC[>>1]] に設定されます。
[5] [[適切な雛形内容所有子文書]]とは[[文書]]ごとに決まる[[文書]]です。
[6] [CODE(HTMLe)@en[[[template]]]] [[要素]]自体が[[雛形内容]]のために作られた[[文書]]に含まれているなら、
その[[文書]]がそのまま[[適切な雛形内容所有子文書]]として使われます。
[7] そうでなく [CODE(HTMLe)@en[[[template]]]] [[要素]]が最外の[[文書]]に属しているなら、
[DFN[[RUBYB[関連付けられた不活性雛形文書]@en[associated inert template document]]]]が[[適切な雛形内容所有子文書]]として使われます。
[[関連付けられた不活性雛形文書]]は[[雛形内容]]専用の[[文書]]で、既になければ新しく作られます。
元の[[文書]]の[[HTML文書]]と[[XML文書]]の違いを引き継ぎます。
;; [8] 従って、 [CODE(HTMLe)@en[[[template]]]] は入れ子にできますが、どんなに深く入れ子にしても、
また並列に [CODE(HTMLe)@en[[[template]]]] がいくつ存在しても、[[文書]]は元の[[文書]]と[[雛形内容]]用の[[文書]]の
2種類だけ存在します。
[9] [[adopt]] により [CODE(HTMLe)@en[[[template]]]] の[[節点文書]]が変更された時は、[[雛形内容]]である
[CODE(DOMi)@en[[[DocumentFragment]]]] が新しい[[文書]]の側の[[適切な雛形内容所有子文書]]へと [[adopt]]
されます。 [SRC[>>1]]
[13] [[雛形内容]]の [CODE(DOMi)@en[[[DocumentFragment]]]] が他の[[文書]]に [[adopt]]
されると[[適切な雛形内容所有子文書]]と[[雛形内容]]の[[節点文書]]が別の[[文書]]になります。
;; [17] これによって、最外[[文書]]の [CODE(HTMLe)@en[[[template]]]] [[要素]]であっても、
[[要素]]と[[雛形内容]]が同じ[[文書]]に属することがあり得ます。 [CODE(HTMLe)@en[[[template]]]]
[[要素]]が[[雛形内容]]側の[[文書]]に [[adopt]] された場合にも同じようなことになります。
;; [14] [[雛形内容]]の中に [CODE(HTMLe)@en[[[template]]]] があった場合、 [[adopt]] 前は内側の[[雛形内容]]も同じ[[文書]]が[[節点文書]]ですが、
[[adopt]] 後は別の[[文書]]になります。その更に内側に [CODE(HTMLe)@en[[[template]]]]
があった場合は、その[[節点文書]]も連鎖的に変更されます。
;; [15] [[adopt]] されても[[雛形内容]]/[[ホスト]]の関係は解消されません。
* 比較と順序
[19] [[雛形内容]]と[[ホスト]]の[[文書順]]には特別な規定はありません。従って、 [CODE(DOMm)@en[[[compareDocumentPosition]]]]
の結果も実装依存となります。
[20] [CODE(DOMm)@en[[[isEqualNode]]]] は[[雛形内容]]を無視して比較します。
* 名前空間
[21] 構文解析や直列化の際は[[雛形内容]]は[[内容]]であるかのように扱われるので、[[名前空間]]は他の[[要素]]の場合と同じように処理されます。
[22] [[DOM]] 上では違う[[節点木]]となりますので、 [CODE(DOMm)@en[[[lookupNamespacePrefix]]]] や
[CODE(DOMm)@en[[[lookupNamespaceURI]]]] については外側の[[名前空間宣言]]などが内側に影響しないことになります。
[[DOM]] を使って [[XSLT]] を実装するような場合には注意が必要です。
* 適合性
[27] [[要素の内容]]を参照。
* 関連
[3] [CODE(HTMLe)@en[[[template]]]] [[要素]]からみて [CODE(DOMi)@en[[[DocumentFragment]]]] のことを[[雛形内容]]といいますが、
逆に [CODE(DOMi)@en[[[DocumentFragment]]]] からみた [CODE(HTMLe)@en[[[template]]]] [[要素]]は[[ホスト]]といいます。
[12] [[XPath]] や [[XSLT]] との関係は、 [CODE(HTMLe)@en[[[template]]]] [[要素]]の項をご覧ください。
* 歴史
[REFS[
- [23] [CITE@en[Web Applications 1.0 r8351 Make the template contents of <template> elements in docs created by createDocument() not have live bindings.]]
( ([TIME[2013-12-13 08:47:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=8350&to=8351>
- [24] [CITE@en[Close #103: use "adopting steps" from DOM and add ID · whatwg/html@a9890f1]] ([TIME[2015-09-08 19:50:25 +09:00]] 版) <https://github.com/whatwg/html/commit/a9890f11b5ddfff95fdf1f255151a34c9ebf9d59>
]REFS]
[25] [CITE@en[Set <template>'s DocumentFragment's host · whatwg/html@baa8e34]]
([TIME[2016-03-20 18:57:08 +09:00]] 版)
<https://github.com/whatwg/html/commit/baa8e346d737c115d4a676caa4a172983b87255e>
[26] [CITE@en[Allow anything in <template> for document conformance]]
([[zcorpan]]著, [TIME[2016-07-08 03:42:26 +09:00]])
<https://github.com/whatwg/html/commit/950d3015bead974bec1d7d86c00d641655ea0b66>
[28] [CITE@en[Template element: "Content model: Nothing." · Issue #3021 · whatwg/html]]
([TIME[2017-09-17 11:23:58 +09:00]])
<https://github.com/whatwg/html/issues/3021>
[29] [CITE@en[Editorial: template *Content model* ➡️ “See prose” by sideshowbarker · Pull Request #3031 · whatwg/html]]
([TIME[2017-09-17 11:25:18 +09:00]])
<https://github.com/whatwg/html/pull/3031>