-
Notifications
You must be signed in to change notification settings - Fork 8
/
HTML-dynamic-markup-insertion-ja.html
2890 lines (2695 loc) · 79.9 KB
/
HTML-dynamic-markup-insertion-ja.html
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html><html lang="ja"><head><meta charset="utf-8">
<title>HTML Standard — Dynamic markup insertion, DOM parsing and serialization APIs（日本語訳）</title>
<link rel="stylesheet" href="common.css" type="text/css">
<link rel="stylesheet" href="common-whatwg.css" type="text/css">
<style>
.arg-list {
display: block;
padding-left: 2em;
white-space: pre-line;
}
</style>
<script src="common0.js"></script>
<script src="common1.js" async></script>
<script>
Util.ready = function(){
const source_data = {
toc_main: 'MAIN',
generate: expand
};
Util.switchWordsInit(source_data);
}
function expand(){
const class_map = this.class_map;
const tag_map = this.tag_map;
const link_map = this.link_map;
return this.html.replace(
/%[\w\-~一-鿆あ-ん]+|`(.+?)([$@\^])(\w*)/g,
create_html
);
function create_html(match, key, indicator, klass){
if(!key) {//%
return `<var>${match.slice(1)}</var>`;
}
let href = '';
let href1 = '';
{
const n = key.indexOf('＠');
if(n > 0) {
href1 = key.slice(n + 1);
key = key.slice(0, n);
}
}
let text = key;
switch(klass){
case 'r':
text = `[${key}]`;
href = `HTML-references.html#refs${key}`;
break;
case 'mt':
case 'l':
text = `"<code class="literal">${text}</code>"`;
break;
case 'm':
case 'm1':
const n = text.indexOf('(');
if(n > 0){
key = text.slice(0, n);
text = key + text.slice(n).replace(/\w+/g, '<var>$&</var>');
}
break;
case 'U':
text = `U+${key}`;
break;
case 'en':
text = `<span lang="en">${key}</span>`;
break;
}
let tag = tag_map[klass];
if(tag) {
let classname = class_map[klass];
classname = classname ? ` class="${classname}"` : '';
text = `<${tag}${classname}>${text}</${tag}>`;
}
if(indicator !== '^'){
href = href1 || link_map[ klass ? `${klass}.${key}` : key ] || href;
if(!href){
console.log(match); // check error
return match;
}
switch(indicator){
case '$':
text = `<a href="${href}">${text}</a>`;
break;
case '@':
text = `<dfn id="${href.slice(1)}">${text}</dfn>`;
break;
}
}
return text;
}
}
</script>
<script type="text/plain" id="_source_data">
●●options
spec_date:2024-12-12
trans_update:2024-11-04
source_checked:240415
page_state_key:HTML
spec_status:LS
original_url:https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html
abbr_url:HTMLdynamic
nav_prev:HTMLGAPI
nav_next:HTMLnavigator
trans_1st_pub:2018-05-03
●●class_map
e:element
a:attr
et:event-type
sc:scheme
jA:abstract
E:error
U:code-point
●●tag_map
I:code
E:code
m:code
m1:code
mb:code
c:code
e:code
a:code
sc:code
et:code
jA:span
U:span
i:i
●●original_urls
●●original_id_map
●●mdn_urls
domparser:API/DOMParser
domparsersupportedtype:API/DOMParserSupportedType
●●link_map
●IDL
CEReactions:~HEcustom#cereactions
LegacyNullToEmptyString:~WEBIDLjs#LegacyNullToEmptyString
E.DOMException:~WEBIDL#idl-DOMException
E.InvalidAccessError:~WEBIDL#invalidaccesserror
E.InvalidStateError:~WEBIDL#invalidstateerror
E.SecurityError:~WEBIDL#securityerror
E.SyntaxError:~WEBIDL#syntaxerror
E.NoModificationAllowedError:~WEBIDL#nomodificationallowederror
I.TrustedHTML:~TRUSTED-TYPES#trustedhtml
I.Node:~DOM4#interface-node → ~node
I.Document:~HTMLdom#document
I.DOMParser:#domparser
I.DOMParserSupportedType:#domparsersupportedtype
I.Element:~DOM4#element
I.Text:~DOM4#text
I.Comment:~DOM4#comment
I.ShadowRoot:~DOM4#shadowroot
I.DocumentFragment:~DOM4#documentfragment → 文書片
I.DocumentFragment:~DOM4#documentfragment
I.Range:~DOM4#range
I.GetHTMLOptions:#gethtmloptions
m.new DOMParser:#dom-domparser-constructor
m.parseFromString:#dom-domparser-parsefromstring
m.close:#dom-document-close
m.createContextualFragment:#dom-range-createcontextualfragment
m.document.close:#dom-document-close
m.~openW:#dom-document-open-window
m.open:#dom-document-open
c.document.open():#dom-document-open
＠~WINDOW#dom-window-open
m.write:#dom-document-write
c.document.write():#dom-document-write
m.writeln:#dom-document-writeln
m.document:~HTMLdom#document
m.innerHTML:#dom-element-innerhtml
m1.innerHTML:#dom-shadowroot-innerhtml
m.outerHTML:#dom-element-outerhtml
m.insertAdjacentHTML:#dom-element-insertadjacenthtml
m.setHTMLUnsafe:#dom-element-sethtmlunsafe
m1.setHTMLUnsafe:#dom-shadowroot-sethtmlunsafe
m.parseHTMLUnsafe:#dom-parsehtmlunsafe
m.getHTML:#dom-element-gethtml
m1.getHTML:#dom-shadowroot-gethtml
m.content:~HEscripting#dom-template-content → ~template内容
誤）m.parent:~WINDOW#dom-window-parent／#dom-parent → 親:~DOM4
mb.serializableShadowRoots:#dom-gethtmloptions-serializableshadowroots
mb.shadowRoots:#dom-gethtmloptions-shadowroots
document.write 手続き:#document-write-steps
document.open 手続き:#document-open-steps
et.beforeunload:~HTMLindex#event-beforeunload
et.pagehide:~HTMLindex#event-pagehide
et.unload:~HTMLindex#event-unload
et.readystatechange:~HTMLindex#event-readystatechange
e.html:~HEmetadata#the-html-element
e.script:~HEscripting#the-script-element
e.meta:~HEmetadata#the-meta-element
e.template:~HEscripting#the-template-element
mt.text/html:~HTMLiana#text/html
mt.text/xml:~HTMLindex#text/xml
mt.application/xml:~HTMLindex#application/xml
mt.application/xhtml+xml:~HTMLiana#application/xhtml+xml
mt.image/svg+xml:~HTMLindex#image/svg+xml
l.text/html:#dom-domparsersupportedtype-texthtml
l.text/xml:#dom-domparsersupportedtype-otherwise
l.application/xml:#dom-domparsersupportedtype-otherwise
l.application/xhtml+xml:#dom-domparsersupportedtype-otherwise
l.image/svg+xml:#dom-domparsersupportedtype-otherwise
●用語
動的~markup挿入-時には投出する~counter:#throw-on-dynamic-markup-insertion-counter
破壊的な書込nは無視する~counter:#ignore-destructive-writes-counter
作動中な構文解析器は中止されたか:#active-parser-was-aborted
~scriptにより作成された構文解析器:#script-created-parser
文字列から~HTMLを構文解析する:#parse-html-from-a-string
~HTMLを安全でなく設定する:#unsafely-set-html
素片に直列化する:#fragment-serializing-algorithm-steps
素片を構文解析する:#fragment-parsing-algorithm-steps
●用語（HTML
sc.~about_blank:~HTMLdep#about:blank
文書:~HTMLdom#the-document-object
文書:~HTMLdom#document
doc.初期~about_blankか:~HTMLdom#is-initial-about:blank
作動中な構文解析器:~HTMLdom#active-parser
文書の現在の準備度を更新する:~HTMLdom#update-the-current-document-readiness
~template内容:~HEscripting#template-contents
scE.すでに開始したか:~HEscripting#already-started
scE.構文解析器~文書:~HEscripting#parser-document
生成元:~ORIGIN#concept-origin
同一-生成元:~ORIGIN#same-origin
~window~open手続き:~WINDOW#window-open-steps
結付けられた文書:~WINDOW#concept-document-window
~node~navigable:~HTMLds#node-navigable
全部的に作動中:~HTMLds#fully-active
閲覧~文脈:~HTMLds#browsing-context
属する閲覧~文脈:~HTMLds#concept-document-bc
~navi:~HTMLnav#navigate
進行中な~navi:~HTMLnav#ongoing-navigation
~navi~ID:~HTMLnav#navigation-id
~URLと履歴を更新する:~HTMLnav#url-and-history-update-steps
読込ngを停止する:~HTMLlifecycle#nav-stop
~unload中にある:~HTMLlifecycle#unload-a-document
~unload~counter:~HTMLlifecycle#unload-counter
完全に読込まれ:~HTMLlifecycle#completely-loaded
関連な大域~obj:~WAPI#concept-relevant-global
入口~大域~obj:~WAPI#entry-global-object
~event~loopを回す:~WAPI#spin-the-event-loop
すべての~event~listener／~event~handlerを消去する:~WAPI#erase-all-event-listeners-and-handlers
~WAPI#concept-n-script → ＠~WAPI#concept-n-noscript
~event~handler内容~属性:~WAPI#event-handler-content-attributes
~XML構文解析器:~HTMLxml#xml-parser
:~HTMLxml#xml-scripting-support-disabled
~HTML素片~直列化~algo:~HTMLwriting#html-fragment-serialisation-algorithm
~tokenから要素を作成-:~HTMLparsing#create-an-element-for-the-token
~HTML構文解析器:~HTMLparsing#html-parser
~load後~task用に準備済み:~HTMLparsing#ready-for-post-load-tasks
~script入子ng~level:~HTMLparsing#script-nesting-level
入力~stream:~HTMLparsing#input-stream
挿入~地点:~HTMLparsing#insertion-point
明示的な~EOF:~HTMLparsing#explicit-eof-character
符号化法の確度:~HTMLparsing#concept-encoding-confidence
静止するか:~HTMLparsing#parser-pause-flag
~HTMLparsing#check-parser-pause-flag
~HTML素片の構文解析~algo:~HTMLparsing#html-fragment-parsing-algorithm
V.文脈~要素:~HTMLparsing#concept-frag-parse-context
~XML素片の構文解析~algo:~HTMLxml#xml-fragment-parsing-algorithm
~iframe~loadを黙らすか:~HEembed#mute-iframe-load
~iframe~loadは進捗-中か:~HEembed#iframe-load-in-progress
~custom要素~構築子:~HEcustom#custom-element-constructor
構文解析器を阻んでいる~script:~HEscripting#pending-parsing-blocking-script
●用語（外部
文字列:~INFRA#string
~ASCII小文字~化する:~INFRA#ascii-lowercase
~ASCII大小無視:~INFRA#ascii-case-insensitive → ~ASCII小文字~化する
~HTML名前空間:~INFRA#html-namespace
url.素片:~URL1#concept-url-fragment
~tree順序:~DOM4#concept-tree-order
~node:~DOM4#concept-node
親:~DOM4#concept-tree-parent
親~要素:~DOM4#parent-element
子孫:~DOM4#concept-tree-descendant
最初の子？:~DOM4#concept-tree-first-child
直後の同胞？:~DOM4#concept-tree-next-sibling
文書片:~DOM4#_concept-documentfragment
要素:~DOM4#concept-element
el.局所~名:~DOM4#concept-element-local-name
el.名前空間:~DOM4#concept-element-namespace
doc.~URL:~DOM4#concept-document-url
doc.生成元:~DOM4#concept-document-origin
doc.~mode:~DOM4#concept-document-mode
doc.符号化法:~DOM4#concept-document-encoding
doc.内容~型:~DOM4#concept-document-content-type
doc.種別:~DOM4#concept-document-type
doc.宣言的な~shadow根を許容するか:~DOM4#document-allow-declarative-shadow-roots
~HTML文書:~DOM4#html-document
~XML文書:~DOM4#xml-document
~node文書:~DOM4#concept-node-document
~host:~DOM4#concept-documentfragment-host
~shadow根:~DOM4#concept-shadow-root
sR.直列化-可能か:~DOM4#shadowroot-serializable
~shadowも含めた広義-子孫:~DOM4#concept-shadow-including-inclusive-descendant
子~群:~DOM4#concept-tree-child
全~内容を~nodeで置換する:~DOM4#concept-node-replace-all
~nodeを付加する:~DOM4#concept-node-append
要素を作成する:~DOM4#concept-create-element
子を~nodeに置換する:~DOM4#concept-node-replace
~nodeを子の前に挿入する:~DOM4#concept-node-insert
始端~node:~DOM4#concept-range-start-node
多重定義~解決~algo:~WEBIDLjs#dfn-overload-resolution-algorithm
実装-:~WEBIDLjs#implements
~UTF-8:~ENCODING#utf-8
~XML直列化:~DOM-Parsing#dfn-xml-serialization
tH.~data:~TRUSTED-TYPES#trustedhtml-data
信用-済みな型に準拠な文字列を取得する:~TRUSTED-TYPES#get-trusted-type-compliant-string-algorithm
●●words_table1
openW:open
about_blank:about:blank
getHTML0:getHTML
●●words_table
●環境／文脈／履歴
族:family::~
担当の:responsible
iframe:
黙らす:muteする::~
●処理一般／task
timer::::タイマー
多重定義:overload::~
入口:entry::~
再入呼出し:reentrant invocation:再入呼び出し
渡され:passされ:~
静止-:pause::~
回す:spinする::~
準備度:readiness::~
設置-:place:~
進捗-中:in progress
%~target:target
%~HTML:html
%文脈~要素:contextElement
%文脈:context
%新たな子~群:newChildren
%親:parent
%文書片:fragment
%文書片:element
%文書片:fragment node
%整形式が要求されるか:require_well-formed
%文字列:string
%~text:text
%値:value
%信用-済みか:isTrusted
sink::::シンク
%~sink:sink
LF:
%~LFを付加するか:lineFeed
%準拠な文字列:compliantString
%準拠な~HTML:compliantHTML
●データ／型／構造／操作
消去-:erase:~
広義-:inclusive:~
●構文解析
EOF:
end-of-file:
tokenizer:::token 化器:トークン化器:トークナイザ
書込まれ:writeされ::書き込まれ
発-:emit::~
地点:point::~
非~構文解析器:non-parser
確度:confidence::~
改行文字:newline character
整形式:well-formed::~
整形式性:well-formedness::整形式
●
open:
close:
load:
読込n後:post load
未読込みに:unload::未読み込みに::未ロードに
unload:
破壊的:destructive::~
書込n:write::書き込み
破壊的な書込n:destructive-writes
吹飛ばす:blow awayする:吹き飛ばす
●仕様
discourage
併用:used in conjunction with
導く:leadする:~
:abstract
直接間接問わず:direct にも indirectにも:直接間接を問わず
拒否-:refuse:~
特異的:idiosyncratic:~
究明-:investigate:~
無関連:irrelevant:関連しない
数えら:countさ:~
変種:variant:~
自立的:standalone:~
不幸:unfortunate:~
遺物:artifact:~
今日:today:~
追跡器:tracker::~::トラッカー
未決:outstanding:~
準拠な:compliantな:準拠する
-:per
注記
特に
与え
とても／ごく:very
し難い:hard to
同様に:like
〜すら:make matters even worse
に応じて，ふるまいが異なる:comes in several variants with
働き続け:continue working
保たれ:kept
特に:notably
応じて:according
〜を問わず:regardless of whether or not
●未分類
template:
現在:currently:~
段階:stage::~
危険:dangerous:~
危険になり得る:potentially-dangerous
無毒化:sanitization::~
安全でない:unsafe
安全でなく:unsafely
変わる:varies
に加え
化
在る
持たな
挙げる
属する
得ら
得る
満たさ
-:point
-:pending
ε:undefined
:end
以前／それまで:previous
各種:various
より前にある:earlier
下で:
中
伴
例
内
各種
その場で:in-place
対し
後者
〜時
時点では:at this point
様な
次
〜法
済み
無い
〜用
結果
被〜
〜間
〜順
次第
直前
種の
に:toward
●●trans_metadata
<p>
~THIS_PAGEは、~WHATWGによる HTML 仕様の
<a href="~SPEC_URL">§ Dynamic markup insertion, § DOM parsing and serialization APIs</a>
を日本語に翻訳したものです。
~PUB
</p>
</script>
</head>
<body>
<header>
<hgroup>
<h1>HTML — 動的マークアップ挿入, DOM の構文解析 API と直列化 API</h1>
</hgroup>
</header>
<main id="MAIN" hidden>
<section id="dynamic-markup-insertion">
<h3 title="Dynamic markup insertion">8.4. 動的~markup挿入</h3>
<p class="note">注記：
~markupを文書の中へ動的に挿入するための~APIは、
構文解析器と相互作用するので，それらの挙動は［
`~HTML文書$（および`~HTML構文解析器$）,
`~XML文書$（および`~XML構文解析器$）
］のどちらで利用されるかに依存して変わる。
◎
APIs for dynamically inserting markup into the document interact with the parser, and thus their behavior varies depending on whether they are used with HTML documents (and the HTML parser) or XML documents (and the XML parser).
</p>
<p>
各 `文書$には
`動的~markup挿入-時には投出する~counter@
があり、
初期~時は 0 に設定するモノトスル。
この~counterは、
`~tokenから要素を作成-$する~algoと併用され，［
`~custom要素~構築子$が構文解析器から呼出されたとき，`文書$の［
`open()$m ／ `close()$m ／ `write()$m
］が利用-可能になる
］ことを防止するために利用される。
◎
Document objects have a throw-on-dynamic-markup-insertion counter, which is used in conjunction with the create an element for the token algorithm to prevent custom element constructors from being able to use document.open(), document.close(), and document.write() when they are invoked by the parser. Initially, the counter must be set to zero.
</p>
<section id="opening-the-input-stream">
<h4 title="Opening the input stream">8.4.1. 入力~streamの~open法</h4>
<dl class="domintro">
<dt>%document = %document.`open()$m</dt>
<dd>
`文書$をその場で置換する
— それまでの~objを再利用しつつ，それが新たな`文書$であったかのように。
その~objが返される。
◎
Causes the Document to be replaced in-place, as if it was a new Document object, but reusing the previous object, which is then returned.
</dd>
<dd>
結果の`文書$には、
~HTML構文解析器が結付けられる
— それには `document.write()$c を利用して構文解析する~dataを与えれる。
◎
The resulting Document has an HTML parser associated with it, which can be given data to parse using document.write().
</dd>
<dd>
`文書$が依然として構文解析-中にある場合、
この~methodの効果は無い。
◎
The method has no effect if the Document is still being parsed.
</dd>
<dd>
次の場合、
`InvalidStateError$E 例外を投出する
⇒＃
`文書$は`~XML文書$である ／
`~custom要素~構築子$を現在~実行している
◎
Throws an "InvalidStateError" DOMException if the Document is an XML document.
◎
Throws an "InvalidStateError" DOMException if the parser is currently executing a custom element constructor.
</dd>
<dt>%window = %document.`~openW(url, name, features)$m</dt>
<dd>
`window.open()＠~WINDOW#dom-window-open$c ~methodと同様に働く。
◎
Works like the window.open() method.
</dd>
</dl>
<p>
各 `文書$には，真偽値をとる
`作動中な構文解析器は中止されたか@
があり、
初期~時は ~F をとるとする。
これは、［
文書にて`作動中な構文解析器$が中止された後
］に［
~scriptが［
`document.open()$c ／ `document.write()$c
］~methodを（直接間接問わず）呼出す
］ことを防止するために利用される。
◎
Document objects have an active parser was aborted boolean, which is used to prevent scripts from invoking the document.open() and document.write() methods (directly or indirectly) after the document's active parser has been aborted. It is initially false.
</p>
<div class="algo">
<p>
`document.open 手続き@
は, 所与の
( %文書 )
に対し，次を走らす：
◎
The document open steps, given a document, are as follows:
</p>
<ol>
<li>
~IF［
%文書 は`~XML文書$である
］
⇒
~THROW `InvalidStateError$E
◎
If document is an XML document, then throw an "InvalidStateError" DOMException exception.
</li>
<li>
~IF［
%文書 の`動的~markup挿入-時には投出する~counter$ ~GT 0
］
⇒
~THROW `InvalidStateError$E
◎
If document's throw-on-dynamic-markup-insertion counter is greater than 0, then throw an "InvalidStateError" DOMException.
</li>
<li>
%入口~文書 ~LET `入口~大域~obj$に`結付けられた文書$
◎
Let entryDocument be the entry global object's associated Document.
</li>
<li>
~IF［
( %文書 の`生成元$doc, %入口~文書 の`生成元$doc )
は`同一-生成元$でない
］
⇒
~THROW `SecurityError$E
◎
If document's origin is not same origin to entryDocument's origin, then throw a "SecurityError" DOMException.
</li>
<li>
<p>
~IF［
%文書 には`作動中な構文解析器$がある
］~AND［
その`~script入子ng~level$ ~GT 0
］
⇒
~RET %文書
◎
If document has an active parser whose script nesting level is greater than 0, then return document.
</p>
<p class="note">注記：
これは、
`document.open()$c が［
構文解析-中に見出された~inline~script内で~callされたとき
］には，基本的に無視させる
— ~timer~callbackや~event~handlerなどの，構文解析器によらない~taskから~callされたときには、
依然として効果があるようにしつつ。
◎
This basically causes document.open() to be ignored when it's called in an inline script found during parsing, while still letting it have an effect when called from a non-parser task such as a timer callback or event handler.
</p>
</li>
<li>
<p>
~IF［
%文書 の`~unload~counter$ ~GT 0
］
⇒
~RET %文書
◎
Similarly, if document's unload counter is greater than 0, then return document.
</p>
<p class="note">注記：
これは、
`document.open()$c が［
%文書 が~unloadされている間に［
`beforeunload$et ／ `pagehide$et ／ `unload$et
］~event~handlerから~callされたとき
］には，基本的に無視させる。
◎
This basically causes document.open() to be ignored when it's called from a beforeunload, pagehide, or unload event handler while the Document is being unloaded.
</p>
</li>
<li>
<p>
~IF［
%文書 の`作動中な構文解析器は中止されたか$ ~EQ ~T
］
⇒
~RET %文書
◎
If document's active parser was aborted is true, then return document.
</p>
<p class="note">注記：
これは特に、
`document.open()$c が［
`~navi$が開始された後に~callされたとき
］には，初期~構文解析-の間に限り無視させる。
更なる背景0は
`課題 #4723＠~HTMLissue/4723$
を見よ。
◎
This notably causes document.open() to be ignored if it is called after a navigation has started, but only during the initial parse. See issue #4723 for more background.
</p>
</li>
<li>
~IF［
%文書 の`~node~navigable$ ~NEQ ~NULL
］~AND［
%文書 の`~node~navigable$の`進行中な~navi$は`~navi~ID$である
］
⇒
`読込ngを停止する$( %文書 の`~node~navigable$ )
◎
If document's node navigable is non-null and document's node navigable's ongoing navigation is a navigation ID, then stop loading document's node navigable.
</li>
<li>
%文書 の
~EACH( `~shadowも含めた広義-子孫$ %~node )
に対し
⇒
`すべての~event~listener／~event~handlerを消去する$( %~node )
◎
For each shadow-including inclusive descendant node of document, erase all event listeners and handlers given node.
</li>
<li>
%~window ~LET %文書 に`関連な大域~obj$
◎
↓</li>
<li>
~IF［
%文書 ~EQ %~window に`結付けられた文書$
］
⇒
`すべての~event~listener／~event~handlerを消去する$( %~window )
◎
If document is the associated Document of document's relevant global object, then erase all event listeners and handlers given document's relevant global object.
</li>
<li>
%文書 の`全~内容を~nodeで置換する$( ~NULL )
◎
Replace all with null within document.
</li>
<li>
<p>
~IF［
%文書 は`全部的に作動中$である
］：
◎
If document is fully active, then:
</p>
<ol>
<li>
%新~URL ~LET %入口~文書 の`~URL$docの複製
◎
Let newURL be a copy of entryDocument's URL.
</li>
<li>
~IF［
%入口~文書 ~NEQ %文書
］
⇒
%新~URL の`素片$url ~SET ~NULL
◎
If entryDocument is not document, then set newURL's fragment to null.
</li>
<li>
`~URLと履歴を更新する$( %文書, %新~URL )
◎
Run the URL and history update steps with document and newURL.
</li>
</ol>
</li>
<li>
%文書 の`初期~about_blankか$doc ~SET ~F
◎
Set document's is initial about:blank to false.
</li>
<li>
~IF［
%文書 の`~iframe~loadは進捗-中か$ ~EQ ~T
］
⇒
%文書 の`~iframe~loadを黙らすか$ ~SET ~T
◎
If document's iframe load in progress flag is set, then set document's mute iframe load flag.
</li>
<li>
%文書 の`~mode$doc ~SET `no-quirks^l
◎
Set document to no-quirks mode.
</li>
<li>
<p>
%構文解析器 ~LET 新たな`~HTML構文解析器$
— その
⇒
`符号化法の確度$ ~SET `無関連^i
◎
Create a new HTML parser and associate it with document.＼
</p>
<p>
これは、
`~scriptにより作成された構文解析器@
と称される。
◎
This is a script-created parser＼
</p>
<div class="note">
<p>
それは、
次の 2 つを意味する：
</p>
<ul>
<li>
［
`document.open()$c ／ `document.close()$m
］~methodにより~closeできる。
</li>
<li>
その~tokenizerは、
~end-of-file~tokenを発する前に，明示的な `document.close()$m の~callを待機する。
</li>
</ul>
◎
(meaning that it can be closed by the document.open() and document.close() methods, and that the tokenizer will wait for an explicit call to document.close() before emitting an end-of-file token). The encoding confidence is irrelevant.
</div>
</li>
<li>
%構文解析器 を %文書 に結付ける
◎
↑</li>
<li>
`挿入~地点$ ~SET `入力~stream$の終端の直前
（入力~streamは、
この時点で空になる。）
◎
Set the insertion point to point at just before the end of the input stream (which at this point will be empty).
</li>
<li>
<p>
`文書の現在の準備度を更新する$( %文書, `loading^l )
◎
Update the current document readiness of document to "loading".
</p>
<p class="note">注記：
これにより `readystatechange$et ~eventが発火されるが、
その~eventは，実際には作者~codeから観測-可能にならない
— 上の段が，それを観測できる
`すべての~event~listener／~event~handlerを消去する$ので。
◎
This causes a readystatechange event to fire, but the event is actually unobservable to author code, because of the previous step which erased all event listeners and handlers that could observe it.
</p>
</li>
<li>
~RET %文書
◎
Return document.
</li>
</ol>
<p class="note">注記：
`document.open 手続き$は、
`文書$が［
`~load後~task用に準備済み$,
`完全に読込まれ$る
］のどちらになるかには影響しない。
◎
The document open steps do not affect whether a Document is ready for post-load tasks or completely loaded.
</p>
</div>
<div class="algo">
<p>
`open(unused1, unused2)@m
~method手続きは
⇒
~RET `document.open 手続き$( コレ )
◎
The open(unused1, unused2) method must return the result of running the document open steps with this.
</p>
<p class="note">注記：
%unused1, %unused2 引数は無視されるが、
1 〜 2 個の引数で関数を~callする~codeが働き続けられるよう，~IDLには保たれる。
それらは Web IDL の`多重定義~解決~algo$の規則に因り必要yである
— その規則は、
引数が無い~callに対し `TypeError^E 例外を投出する。
`whatwg/webidl 課題 #581＠https://github.com/whatwg/webidl/issues/581$
にて、
除去を許容するために~algoを変更することについて，究明-中にある。
`WEBIDL$r
◎
The unused1 and unused2 arguments are ignored, but kept in the IDL to allow code that calls the function with one or two arguments to continue working. They are necessary due to Web IDL overload resolution algorithm rules, which would throw a TypeError exception for such calls had the arguments not been there. whatwg/webidl issue #581 investigates changing the algorithm to allow for their removal. [WEBIDL]
</p>
</div>
<div class="algo">
<p>
`~openW(url, name, features)@m
~method手続きは：
◎
The open(url, name, features) method must run these steps:
</p>
<ol>
<li>
~IF［
コレは`全部的に作動中$でない
］
⇒
~THROW `InvalidAccessError$E
◎
If this is not fully active, then throw an "InvalidAccessError" DOMException exception.
</li>
<li>
~RET
`~window~open手続き$( %url, %name, %features )
◎
Return the result of running the window open steps with url, name, and features.
</li>
</ol>
</div>
</section>
<section id="closing-the-input-stream">
<h4 title="Closing the input stream">8.4.2. 入力~streamの~close法</h4>
<dl class="domintro">
<dt>%document.`close()$m</dt>
<dd>
`document.open()$c ~methodで~openされた入力~streamを~closeする。
◎
Closes the input stream that was opened by the document.open() method.
</dd>
<dd>
次の場合、
`InvalidStateError$E 例外を投出する
⇒＃
`文書$は`~XML文書$である ／
`~custom要素~構築子$を現在~実行している
◎
Throws an "InvalidStateError" DOMException if the Document is an XML document.