HTML — スクリプトの利用

【この訳に特有な表記規約】

用語 `文書片@ は、 `DocumentFragment$I ~objの略記である。

4.12.1. `script^e 要素

`分類$：

`~metadata内容$ ／ `~flow内容$ ／ `句ng内容$ ／ `~scriptを~supportする要素$ ◎ Metadata content. ◎ Flow content. ◎ Phrasing content. ◎ Script-supporting element.

`この要素を利用できる文脈$：

`~metadata内容$ ／ `句ng内容$ ／ `~scriptを~supportする要素$ が期待される所。 ◎ Where metadata content is expected. ◎ Where phrasing content is expected. ◎ Where script-supporting elements are expected.

`内容~model$：

`src$a 属性を有さない場合、 `type$a 属性の値にも依存するが，`~script内容~制約$に合致しなければナラナイ。 ◎ If there is no src attribute, depends on the value of the type attribute, but must match script content restrictions.

`src$a 属性を有する場合、 要素は空にされているか, または `~script内容~制約$にも合致するような`~script文書化$のみを包含していなければナラナイ。 ◎ If there is a src attribute, the element must be either empty or contain only script documentation that also matches script content restrictions.

`text/html における~tag省略$：

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$：

`大域~属性$ ◎ Global attributes

`src$a — 資源の~address ◎ src — Address of the resource

`type$a — ~scriptの種別 ◎ type — Type of script

`nomodule$a — `~module~script$を~supportする~UAにおける実行を防止する ◎ nomodule — Prevents execution in user agents that support module scripts

`async$a — ~scriptが可用になったら実行する — ~fetchしている間は他を阻むことなく ◎ async — Execute script when available, without blocking while fetching

`defer$a — ~script実行を先送りする ◎ defer — Defer script execution

`crossorigin$a — 要素は非同一-生成元 要請をどう取扱うか ◎ crossorigin — How the element handles crossorigin requests

`integrity$a — `Subresource Integrity^cite `SRI$r（下位資源の完全性）検査に利用される完全性~metadata ◎ integrity — Integrity metadata used in Subresource Integrity checks [SRI]

`referrerpolicy$a — 要素により起動された`~fetch$用の`~referrer施策$ ◎ referrerpolicy — Referrer policy for fetches initiated by the element

`blocking$a — 要素に`具現化を阻む能性$があるかどうか。 ◎ blocking — Whether the element is potentially render-blocking

`fetchpriority$a — 要素により起動される`~fetch$用の`優先度$rqを設定する。 ◎ fetchpriority — Sets the priority for fetches initiated by the element

`~accessibilityの考慮点$

`script$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLScriptElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute USVString `src$m;
  [`CEReactions$] attribute DOMString `type$m;
  [`CEReactions$] attribute boolean `noModule$m;
  [`CEReactions$] attribute boolean `async$m;
  [`CEReactions$] attribute boolean `defer$m;
  [`CEReactions$] attribute DOMString? `crossOrigin$m;
  [`CEReactions$] attribute DOMString `text$m;
  [`CEReactions$] attribute DOMString `integrity$m;
  [`CEReactions$] attribute DOMString `referrerPolicy$m;
  [SameObject, PutForwards=`value$m] readonly attribute `DOMTokenList$I `blocking$m;
  [`CEReactions$] attribute DOMString `fetchPriority$m;

  static boolean `supports$m(DOMString %type);

  // `HTMLScriptElement$obsMb
};

`script$e 要素により、 作者は，文書~内に［ 動的~script ／ ~data~block ］を含めることが可能になる。 この要素は、 利用者~向けの内容は`表現-$しない。 ◎ The script element allows authors to include dynamic script and data blocks in their documents. The element does not represent content for the user.

`type@a 属性は、 表現される~scriptの種別を~custom化できるようにする： ◎ The type attribute allows customization of the type of script represented:

• この属性を省略した場合, あるいは `~JS~MIME型に~essence合致-$するものに設定した場合、 当の~scriptは`古典~script$であるとされ， ~JSの `Script$P ~top-level生成規則に則って解釈されることになる。 古典~scriptは、 `src$a 属性が設定されている場合に限り，［ `async$a, `defer$a ］属性に影響される。 `type$a 属性を設定するのは冗長であり、 作者は，代わりに省略するべきである。 ◎ Omitting the attribute, setting it to the empty string, or setting it to a JavaScript MIME type essence match, means that the script is a classic script, to be interpreted according to the JavaScript Script top-level production. Classic scripts are affected by the async and defer attributes, but only when the src attribute is set. Authors should omit the type attribute instead of redundantly setting it.
• この属性を［ `~ASCII大小無視$で `module^l に合致する文字列 ］に設定することは、 当の~scriptが`~JS~module~script$になり，［ ~JSの `Module$P ~top-level生成規則に則って解釈される ］ことになることを意味する。 ~module~scriptは、 `defer$a 属性からは影響されないが， `async$a 属性からは影響される（ `src$a 属性の状態に関わらず）。 ◎ Setting the attribute to an ASCII case-insensitive match for "module" means that the script is a JavaScript module script, to be interpreted according to the JavaScript Module top-level production. Module scripts are not affected by the defer attribute, but are affected by the async attribute (regardless of the state of the src attribute).
• この属性を［ `~ASCII大小無視$で `importmap^l に合致する文字列 ］に設定することは、 当の~scriptは，`~import~map$になることを意味する — それは、［ `~module指定子を解決する$ときの挙動を制御する ］ために利用される~JSONを包含する。 ~import~mapは、 ~inlineに限られる — すなわち， `src$a 属性, および他のほとんどの属性は無意味になり、 ~import~mapと併に利用されることはない。 ◎ Setting the attribute to an ASCII case-insensitive match for "importmap" means that the script is an import map, containing JSON that will be used to control the behavior of module specifier resolution. Import maps can only be inline, i.e., the src attribute and most other attributes are meaningless and not to be used with them.
• この属性を他の値に設定した場合、 ~scriptは `~data~block@ であるとされ，処理されなくなる。 当の `script$e 要素の どの属性も，~data~blockに効果を及ぼすことはない （ `type$a 自身は除いて）。 作者は、 ~data~blockを~~指示するときは， `~JS~MIME型に~essence合致-$しない`妥当な~MIME型~文字列$を利用しなければナラナイ。 ◎ Setting the attribute to any other value means that the script is a data block, which is not processed. None of the script attributes (except type itself) have any effect on data blocks. Authors must use a valid MIME type string that is not a JavaScript MIME type essence match to denote data blocks.

注記： `~data~block$に，`妥当な~MIME型~文字列$を利用しなければナラナイとする要件は、 将来に起こり得る衝突を避けるためにある。 さもなければ、［ この仕様が，いつか`~script$に追加的な種別を追加した場合 ］に，それらが — 値 `module^l が`~module~script$を~~指示するのと同様に — 何かを誘発し得ることになる。 今，妥当な~MIME型~文字列を利用しておけば、［ 当の~data~blockは、 将来の~UAからも，何か別の~script種別に解釈し直されない ］ことを確保できる。 ◎ The requirement that data blocks must be denoted using a valid MIME type string is in place to avoid potential future collisions. If this specification ever adds additional types of script, they will be triggered by setting the type attribute to something which is not a MIME type, like how the "module" value denotes module scripts. By using a valid MIME type string now, you ensure that your data block will not ever be reinterpreted as a different script type, even in future user agents.

［ `古典~script$, `~JS~module~script$ ］どちらも、 ~inlineに埋込むことも， `src@a 属性を指定して外部~fileから取込むこともできる。 この `src^a 属性~値は、 利用する外部~script資源の`~URL$を与える — その値は、 `前後~空白~可の妥当かつ空でない~URL$でなければナラナイ。 ◎ Classic scripts and JavaScript module scripts can be embedded inline, or be imported from an external file using the src attribute, which if specified gives the URL of the external script resource to use. If src is specified, it must be a valid non-empty URL potentially surrounded by spaces.

［ ~inlineな `script$e 要素 ／ 外部~script資源 ］の内容は、［ `古典~script$の場合は，~JS仕様 `JAVASCRIPT$r の `Script$P 生成規則／ `~JS~module~script$の場合は，同~仕様の `Module$P 生成規則 ］による要件に適合しなければナラナイ。 ◎ The contents of inline script elements, or the external script resource, must conform with the requirements of the JavaScript specification's Script or Module productions, for classic scripts and JavaScript module scripts respectively. [JAVASCRIPT]

`~CSS~module~script$用の外部~script資源の内容は、 ~CSS仕様 `CSS$r の要件に適合しなければナラナイ。 ◎ The contents of the external script resource for CSS module scripts must conform to the requirements of the CSS specification. [CSS]

`~JSON~module~script$用の外部~script資源の内容は、 ~JSON仕様 `JSON$r の要件に適合しなければナラナイ。 ◎ The contents of the external script resource for JSON module scripts must conform to the requirements of the JSON specification. [JSON]

`~import~map$用の~inlineな `script$e 要素の内容は、 `~import~map著作~要件$に適合しなければナラナイ。 ◎ The contents of inline script elements for import maps must conform with the import map authoring requirements.

`~import~map$を与える `script$e 要素には、 次に挙げる属性を指定してはナラナイ ⇒＃ `src$a, `async$a, `nomodule$a, `defer$a, `crossorigin$a, `integrity$a, `referrerpolicy$a ◎ For import map script elements, the src, async, nomodule, defer, crossorigin, integrity, and referrerpolicy attributes must not be specified.

文書には、 `~import~map$を与える `script$e 要素が複数個~在ってはナラナイ。 ◎ A document must not have more than one import map script element.

`script$e 要素を，`~data~block$を含めるために利用する場合： ◎ When used to include data blocks,＼

• ~dataは、 ~inlineに埋込まなければナラナイ。 ◎ the data must be embedded inline,＼
• `type$a 属性を利用して，~dataの形式も与えなければナラナイ。 ◎ the format of the data must be given using the type attribute, and＼
• 要素の内容は、 利用される形式に定義される要件に適合していなければナラナイ。 ◎ the contents of the script element must conform to the requirements defined for the format used.＼
• 次に挙げる属性は、 要素に指定してはナラナイ ⇒＃ `src$a, `async$a, `nomodule$a, `defer$a, `crossorigin$a, `integrity$a, `referrerpolicy$a, `fetchpriority$a ◎ The src, async, nomodule, defer, crossorigin, integrity, referrerpolicy, and fetchpriority attributes must not be specified.

`nomodule@a 属性は，`真偽-属性$であり、 `~module~script$を~supportする~UAにおいて~scriptが実行されるのを防止する。 これにより、 `下の例に示す＠#script-nomodule-example$ように，［ 現代の~UAには`~module~script$／ 旧い~UAには`古典~script$ ］を選択的に実行させれるようになる。 `nomodule$a 属性は、 `~module~script$上に指定されてはナラナイ（また，指定されても無視される）。 ◎ The nomodule attribute is a boolean attribute that prevents a script from being executed in user agents that support module scripts. This allows selective execution of module scripts in modern user agents and classic scripts in older user agents, as shown below. The nomodule attribute must not be specified on module scripts (and will be ignored if it is).

`async@a, `defer@a 属性は，`真偽-属性$であり、 当の~scriptがどう評価されるべきかを指示する。 `古典~script$に対しては、 両~属性とも指定してヨイ — が、 `src$a 属性を有していない場合は，どちらも指定してはナラナイ。 `~module~script$に対しては、 `async$a 属性は指定してもヨイが， `defer$a 属性は指定してはナラナイ。 ◎ The async and defer attributes are boolean attributes that indicate how the script should be evaluated. Classic scripts may specify defer or async, but must not specify either unless the src attribute is present. Module scripts may specify the async attribute, but must not specify the defer attribute.

これらの属性を利用して選択され得る／できる~modeとしてアリなものは、 ~scriptの種別に依存して，いくつかある： ◎ There are several possible modes that can be selected using these attributes, and depending on the script's type.

• `古典~script$に対しては： ◎ For classic scripts,＼

  • 要素は `async$a 属性を有する場合 ⇒ ~scriptは，~pageの構文解析と`並列的$に~fetchされ、 可用になり次第，評価されることになる （構文解析が完了する前にもなり得る）。 ◎ if the async attribute is present, then the classic script will be fetched in parallel to parsing and evaluated as soon as it is available (potentially before parsing completes).＼
  • 要素は `async$a 属性を有さないが， `defer$a 属性は有する場合 ⇒ ~scriptは`並列的$に~fetchされ，~pageが構文解析を終えた時点で評価される。 ◎ If the async attribute is not present but the defer attribute is present, then the classic script will be fetched in parallel and evaluated when the page has finished parsing.＼
  • 要素は両~属性とも有さない場合 ⇒ ~scriptは，即時に~fetchされた上で評価され、 両者とも完了するまで~pageの構文解析を阻むことになる。 ◎ If neither attribute is present, then the script is fetched and evaluated immediately, blocking parsing until these are both complete.

• `~module~script$に対しては： ◎ For module scripts,＼

  • 要素は `async$a 属性を有する場合 ⇒ ~scriptとそのすべての依存物 【~scriptが取込む他の~script】 は，~pageの構文解析と`並列的$に~fetchされ、 可用になり次第，評価されることになる （構文解析が完了する前にもなり得る）。 ◎ if the async attribute is present, then the module script and all its dependencies will be fetched in parallel to parsing, and the module script will be evaluated as soon as it is available (potentially before parsing completes).＼
  • 他の場合 ⇒ ~scriptとその依存物は，構文解析と`並列的$に~fetchされ、 ~pageが構文解析を終えた時点で評価されることになる。 ◎ Otherwise, the module script and its dependencies will be fetched in parallel to parsing and evaluated when the page has finished parsing.＼
  • （ `defer$a 属性による効果は、 ~module~scriptにはない。） ◎ (The defer attribute has no effect on module scripts.)

これらすべては、 次の図式に要約される： ◎ This is all summarized in the following schematic diagram:

注記： `document.write()$m ~methodを利用して挿入された `script$e 要素は、 `通例的には＠~HTMLparsing#document-written-scripts-intervention$実行される （概して，その間は、 更なる［ ~script実行／~HTML構文解析 ］は阻まれる）。 ［ `innerHTML$m ／ `outerHTML$m ］属性を利用して挿入されたものは、 まったく実行されない。 ◎ When inserted using the document.write() method, script elements usually execute (typically blocking further script execution or HTML parsing). When inserted using the innerHTML and outerHTML attributes, they do not execute at all.

`async$a 属性が指定されている下でも， `defer$a 属性が指定されてヨイ — そうすることで、［ `defer$a は~supportするが `async$a は~supportしないような，旧来の~web~browser ］においても、 既定である他を阻む挙動に代えて， `defer$a による挙動に~fall-backするようになる。 ◎ The defer attribute may be specified even if the async attribute is specified, to cause legacy web browsers that only support defer (and not async) to fall back to the defer behavior instead of the blocking behavior that is the default.

`crossorigin@a 属性は、 `~CORS設定群~属性$である。 この属性は、 `古典~script$に対しては［ 他の`生成元$から得された~scriptによる~error情報が公開されるかどうか ］を制御し， `~module~script$に対しては［ 非同一-生成元 要請に利用される`資格証~mode$ ］を制御する。 ◎ The crossorigin attribute is a CORS settings attribute. For classic scripts, it controls whether error information will be exposed, when the script is obtained from other origins. For module scripts, it controls the credentials mode used for cross-origin requests.

注記： `古典~script$と違って，`~module~script$では、 非同一-生成元へ~fetchするときには，`~CORS~protocol$の利用が要求される。 ◎ Unlike classic scripts, module scripts require the use of the CORS protocol for cross-origin fetching.

`integrity@a 属性は、［ この要素が担当する要請 ］の`完全性~metadata$rqを表現する。 値は~textである。 この属性は、 `src$a 属性を指定していない場合には，指定してはナラナイ。 `SRI$r ◎ The integrity attribute represents the integrity metadata for requests which this element is responsible for. The value is text. The integrity attribute must not be specified when the src attribute is not specified. [SRI]

`referrerpolicy@a 属性は、 `~referrer施策~属性$である。 その目的は、［ ~script, および それが取込む~script ］を`~fetch$するときに利用される`~referrer施策$を設定することである。 `REFERRERPOLICY$r ◎ The referrerpolicy attribute is a referrer policy attribute. Its purpose is to set the referrer policy used when fetching the script, as well as any scripts imported from it. [REFERRERPOLICY]

<script referrerpolicy="origin">
  fetch('/api/data');   /* 
`script^e の~referrer施策では~fetchされない。
◎
not fetched with <script>'s referrer policy
 */
  import('./utils.mjs'); /* 
`script^e の~referrer施策（この事例では `origin^l ）で~fetchされる。
◎
is fetched with <script>'s referrer policy ("origin" in this case)
 */
</script>

`blocking@a 属性は、 `他を阻む属性$である。 ◎ The blocking attribute is a blocking attribute.

`fetchpriority@a 属性は、 `~fetch優先度~属性$である。 その目的は、 ~scriptの`~fetch$時に利用される`優先度$rqを設定することである。 ◎ The fetchpriority attribute is a fetch priority attribute. Its purpose is to set the priority used when fetching the script.

次に挙げる内容~属性を動的に変更しても，直接的な効果はない — これらの属性は、 下に述べる特定の時点に限り利用される ⇒＃ `src$a, `type$a, `nomodule$a, `async$a, `defer$a, `crossorigin$a, `integrity$a, `referrerpolicy$a, `fetchpriority$a ◎ Changing the src, type, nomodule, async, defer, crossorigin, integrity, referrerpolicy, and fetchpriority attributes dynamically has no direct effect; these attributes are only used at specific times described below.

`referrerPolicy@m ~IDL属性は、 `既知な値のみに制限され$る下で， `referrerpolicy$a 内容~属性を`反映する$モノトスル。 ◎ The referrerPolicy IDL attribute must reflect the referrerpolicy content attribute, limited to only known values.

`fetchPriority@m ~IDL属性は、 `既知な値のみに制限され$る下で， `fetchpriority$a 内容~属性を`反映する$モノトスル。 ◎ The fetchPriority IDL attribute must reflect the fetchpriority content attribute, limited to only known values.

`crossOrigin@m ~IDL属性は、 `既知な値のみに制限され$る下で， `crossorigin$a 内容~属性を`反映する$モノトスル。 ◎ The crossOrigin IDL attribute must reflect the crossorigin content attribute, limited to only known values.

`noModule@m ~IDL属性は、 `nomodule$a 内容~属性を`反映する$モノトスル。 ◎ The noModule IDL attribute must reflect the nomodule content attribute.

%script.`text$m [ = %value ]

要素の`子~text内容$を返す。 ◎ Returns the child text content of the element.

設定して，要素の子たちを所与の値に置換できる。 ◎ Can be set, to replace the element's children with the given value.

`HTMLScriptElement$I.`supports(type)$m

所与の %type は~UAが~supportする~script種別であるならば ~T を返す。 この仕様においてアリな~script種別は［ `classic^l, `module^l, `importmap^l ］に限られるが、 将来には，他の種別も追加されるかもしれない 【`説明書き＠https://github.com/horo-t/explainers/blob/main/script_element_supports.md$】 。 ◎ Returns true if the given type is a script type supported by the user agent. The possible script types in this specification are "classic", "module", and "importmap", but others might be added in the future.

<script type="module">
 import peopleInSpace from "http://api.open-notify.org/astros.json" with { type: "json" };

 const %list = document.querySelector("#people-in-space");
 for (const { %craft, %name } of peopleInSpace.people) {
   const %li = document.createElement("li");
   %li.textContent = ``^${name} / ${craft}``^;
   %list.append(%li);
 }
</script>

script
	= outer *( comment-open inner comment-close outer )

outer
	= < not-in-outer に合致する文字列は含まない任意の文字列 >
not-in-outer
	= comment-open
inner
	= < not-in-inner に合致する文字列は含まない任意の文字列 >
not-in-inner
	= comment-close
	/ script-open

comment-open
	= "<!--"
comment-close
	= "-->"
script-open
	= "<" s c r i p t tag-end

s
	= `0053^0x ; U+0053 LATIN CAPITAL LETTER S
	/ `0073^0x ; U+0073 LATIN SMALL LETTER S
c
	= `0043^0x ; U+0043 LATIN CAPITAL LETTER C
	/ `0063^0x ; U+0063 LATIN SMALL LETTER C
r
	= `0052^0x ; U+0052 LATIN CAPITAL LETTER R
	/ `0072^0x ; U+0072 LATIN SMALL LETTER R
i
	= `0049^0x ; U+0049 LATIN CAPITAL LETTER I
	/ `0069^0x ; U+0069 LATIN SMALL LETTER I
p
	= `0050^0x ; U+0050 LATIN CAPITAL LETTER P
	/ `0070^0x ; U+0070 LATIN SMALL LETTER P
t
	= `0054^0x ; U+0054 LATIN CAPITAL LETTER T
	/ `0074^0x ; U+0074 LATIN SMALL LETTER T

tag-end
	= `0009^0x ; U+0009 CHARACTER TABULATION (tab)
	/ `000A^0x ; U+000A LINE FEED (LF)
	/ `000C^0x ; U+000C FORM FEED (FF)
	/ `0020^0x ; U+0020 SPACE
	/ `002F^0x ; U+002F SOLIDUS (/)
	/ `003E^0x ; U+003E GREATER-THAN SIGN (>)

const %example = 'Consider this string: <!-- <script>';
console.log(%example);

<script>
  const %example = 'Consider this string: <!-- <script>';
  console.log(%example);
</script>

<script>
  const %example = 'Consider this string: <!-- <script>';
  console.log(%example);
</script>
<!-- 見かけに反し、実際には，ここも~scriptの一部になる。 -->
<script>
 ... // ここもまだ同じ~script~block内にある...
</script>

<script>
  /* 
`\x3C^l は `<^l 用の~escape列を与えることに注意。
◎
Note: `\x3C` is an escape sequence for `<`.
 */
  const %example = 'Consider this string: \x3C!-- \x3Cscript>';
  console.log(%example);
</script>
<!-- ここは単に 2 つの~script~blockの合間にある~commentになる -->
<script>
 ... // 新たな~script~block
</script>

if (x<!--y) { ... }
if ( player<script ) { ... }

if (x < !--y) { ... }
if (!--y > x) { ... }
if (!(--y) > x) { ... }
if (player < script) { ... }
if (script > player) { ... }

documentation
	= *( *( space / tab / comment ) [ line-comment ] newline )
comment
	= slash star *( not-star / star not-slash ) 1*star slash
line-comment
	= slash slash *not-newline

; characters
tab
	= `0009^0x ; U+0009 CHARACTER TABULATION (tab)
newline
	= `000A^0x ; U+000A LINE FEED (LF)
space
	= `0020^0x ; U+0020 SPACE
star
	= `002A^0x ; U+002A ASTERISK (*)
slash
	= `002F^0x ; U+002F SOLIDUS (/)
not-newline
	= `0000-0009^0x / `000B-10FFFF^0x
	; U+000A LINE FEED (LF) 以外の `~scalar値$
not-star
	= `0000-0029^0x / `002B-10FFFF^0x
	; U+002A ASTERISK (*) 以外の `~scalar値$
not-slash
	= `0000-002E^0x / `0030-10FFFF^0x
	; U+002F SOLIDUS (/) 以外の `~scalar値$

4.12.2. `noscript^e 要素

`分類$：

`~metadata内容$ ／ `~flow内容$ ／ `句ng内容$ ◎ Metadata content. ◎ Flow content. ◎ Phrasing content.

`この要素を利用できる文脈$：

`~HTML文書$の `head$e 要素~内, または `~HTML文書$内の `句ng内容$が期待される所 — ただし、いずれにせよ，先祖に `noscript$e 要素がある所は除く。 ◎ In a head element of an HTML document, if there are no ancestor noscript elements. ◎ Where phrasing content is expected in HTML documents, if there are no ancestor noscript elements.

`内容~model$：

要素~用の`~scriptingは不能化されて$いる場合：

• 要素が `head$e 要素~内にある場合、 順序は問わず，それぞれが［ `link$e, `style$e, `meta$e ］のいずれかであるような， 0 個以上の要素。
• 要素が `head$e 要素~外にある場合、 `透過的$になる — ただし、子孫に `noscript$e 要素があってはナラナイ。

◎ When scripting is disabled, in a head element: in any order, zero or more link elements, zero or more style elements, and zero or more meta elements. ◎ When scripting is disabled, not in a head element: transparent, but there must be no noscript element descendants.

他の場合、下の注釈文に与える要件に適合するような~text。 ◎ Otherwise: text that conforms to the requirements given in the prose.

`text/html における~tag省略$：

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$：

`大域~属性$ ◎ Global attributes

`~accessibilityの考慮点$

`noscript$AA ◎ For authors. For implementers.

`~DOM~interface$

`HTMLElement$I を利用する ◎ Uses HTMLElement.

`noscript$e 要素は、［ `~scriptingは可能化されて$いる場合は，何も`表現-$しない／ `~scriptingは不能化されて$いる場合は，その子たちを`表現-$する ］。 それは、［ ~UAが~scriptingを~supportするかどうかに応じて，文書がどう構文解析されるかを違える ］ことにより，~UAに異なる~markupを提示するために利用される。 ◎ The noscript element represents nothing if scripting is enabled, and represents its children if scripting is disabled. It is used to present different markup to user agents that support scripting and those that don't support scripting, by affecting how the document is parsed.

`noscript$e 要素 %noscript が `~HTML文書$に利用される場合に許容される内容~modelは、次に従う： ◎ When used in HTML documents, the allowed content model is as follows:

%noscript は `head$e 要素~内にある場合： ◎ ↓

`~scriptingは不能化されて$いる場合： ◎ In a head element, if scripting is disabled for the noscript element

%noscript は［ `link$e, `style$e, `meta$e ］要素のみを包含していなければナラナイ。 ◎ The noscript element must contain only link, style, and meta elements.

`~scriptingは可能化されて$いる場合： ◎ In a head element, if scripting is enabled for the noscript element

%noscript は、~textのみを包含するか, または次を満たさなければナラナイ：

• `~HTML素片~構文解析~algo$を ( `文脈~要素$V, %入力 ) として ( %noscript, %noscript の~text内容 ) を与える下で呼出したとき、 ~AND↓ を満たす：

  • `構文解析-~error$は生じない
  • ~algoの結果は、 ~nodeたちが成す~listであり，次に挙げる要素のみからなる ⇒ `link$e, `style$e, `meta$e
  • 前項の~listが %noscript の子たちであったとするとき，適合する

◎ The noscript element must contain only text, except that invoking the HTML fragment parsing algorithm with the noscript element as the context element and the text contents as the input must result in a list of nodes that consists only of link, style, and meta elements that would be conforming if they were children of the noscript element, and no parse errors.

%noscript は `head$e 要素~外にある場合： ◎ ↓

`~scriptingは不能化されて$いる場合： ◎ Outside of head elements, if scripting is disabled for the noscript element

%noscript の内容~modelは`透過的$になる — ただし， %noscript の先祖に `noscript$e 要素があってはナラナイ （すなわち， `noscript$e は入子にできない）。 ◎ The noscript element's content model is transparent, with the additional restriction that a noscript element must not have a noscript element as an ancestor (that is, noscript can't be nested).

`~scriptingは可能化されて$いる場合： ◎ Outside of head elements, if scripting is enabled for the noscript element

%noscript は、 ~textのみを包含するか, または次を満たさなければナラナイ：

• 下に与える~algoを走らせたとき、 ~AND↓ を満たす：

  • 例外は投出されない
  • 結果の文書は、［ `noscript$e, `script$e ］要素を含まない，適合~文書になる
  • `~HTML構文解析器$において，`構文解析-~error$は生じない

◎ The noscript element must contain only text, except that the text must be such that running the following algorithm results in a conforming document with no noscript elements and no script elements, and such that no step in the algorithm throws an exception or causes an HTML parser to flag a parse error:

~algoは、 次に従う： ◎ ↑

1. 当の文書からすべての `script$e 要素を除去する ◎ Remove every script element from the document.

2. 当の文書~内の ~EACH( `noscript$e 要素 %要素 ) に対し ⇒ %要素 の `outerHTML$m 属性 ~SET %要素 の`子~text内容$ ◎ Make a list of every noscript element in the document. For every noscript element in that list, perform the following steps: • Let s be the child text content of the noscript element. • Set the outerHTML attribute of the noscript element to the value of s.＼

   （これによる副作用として， %要素 は当の文書から除去される。） ◎ (This, as a side-effect, causes the noscript element to be removed from the document.)

注記： 上述の ひねくれた取扱いすべてが要求される — 歴史的な理由から、 `~HTML構文解析器$による `noscript$e 要素に対する取扱いは，［ 構文解析器が呼出されたとき， 当の要素~用の`~scriptingは可能化されていたかどうか＠~HTMLparsing#scripting-flag$ ］に応じて異なるので。 ◎ All these contortions are required because, for historical reasons, the noscript element is handled differently by the HTML parser based on whether scripting was enabled or not when the parser was invoked.

`~XML文書$には、 `noscript$e 要素を利用してはナラナイ。 ◎ The noscript element must not be used in XML documents.

注記： `noscript$e 要素による効果があるのは、 `~HTML構文$に限られる — `~XML構文$に対する効果は無い。 この要素は、 ~scriptが可能化されている下では， 本質的に構文解析器を “切る” ように働く — すなわち、 要素の内容は［ 本物の要素たちではなく，純粋な~text ］として扱われる — が、 ~XMLには，これを行う仕組みは定義されていないので。 ◎ The noscript element is only effective in the HTML syntax, it has no effect in the XML syntax. This is because the way it works is by essentially "turning off" the parser when scripts are enabled, so that the contents of the element are treated as pure text and not as real elements. XML does not define a mechanism by which to do this.

`noscript$e 要素には、 他の要件は無い。 特に，当の要素~用の`~scriptingは可能化されて$いるときでも、 `noscript$e 要素の各~子が `~form提出$, ~scripting, 等々, から免れることはない。 ◎ The noscript element has no other requirements. In particular, children of the noscript element are not exempt from form submission, scripting, and so forth, even when scripting is enabled for the element.

4.12.3. `template^e 要素

`分類$：

`~metadata内容$ ／ `~flow内容$ ／ `句ng内容$ ／ `~scriptを~supportする要素$ ◎ Metadata content. ◎ Flow content. ◎ Phrasing content. ◎ Script-supporting element.

`この要素を利用できる文脈$：

`~metadata内容$が期待される所。 ◎ Where metadata content is expected.

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`~scriptを~supportする要素$が期待される所。 ◎ Where script-supporting elements are expected.

`span$a 属性を有さない `colgroup$e 要素の子として。 ◎ As a child of a colgroup element that doesn't have a span attribute.

`内容~model$：

`なし$（より明確には， `例を見よ＠#template-example$。 ） ◎ Nothing (for clarification, see example).

`text/html における~tag省略$：

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$：

`大域~属性$ ◎ Global attributes

`shadowrootmode$a — 宣言的な~shadow根による~stream法を可能化する

【 “~stream法” とは、 `~server側~具現化＠https://github.com/mfreed7/declarative-shadow-dom/blob/master/README.md#motivation$ （略称 SSR） — ~JSを利用せずに~shadow~DOMを構築すること — を指すと思われる。 】

◎ shadowrootmode — Enables streaming declarative shadow roots

`shadowrootdelegatesfocus$a — 宣言的な~shadow根に対し，その`~focusを委任するか$sRを ~T に設定する ◎ shadowrootdelegatesfocus — Sets delegates focus on a declarative shadow root

`shadowrootclonable$a — 宣言的な~shadow根に対し，その`~clone可能か$sRを ~T に設定する ◎ shadowrootclonable — Sets clonable on a declarative shadow root

`shadowrootserializable$a — 宣言的な~shadow根に対し，その`直列化-可能か$sRを ~T に設定する ◎ shadowrootserializable — Sets serializable on a declarative shadow root

`~accessibilityの考慮点$

`template$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLTemplateElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  readonly attribute `DocumentFragment$I `content$m;
  [`CEReactions$] attribute DOMString `shadowRootMode$m;
  [`CEReactions$] attribute boolean `shadowRootDelegatesFocus$m;
  [`CEReactions$] attribute boolean `shadowRootClonable$m;
  [`CEReactions$] attribute boolean `shadowRootSerializable$m;
};

`template$e 要素は、［ ~scriptにより［ ~cloneできる／文書~内に挿入できる ］~HTML素片 ］を宣言するために利用される。 ◎ The template element is used to declare fragments of HTML that can be cloned and inserted in the document by script.

具現化においては、 `template$e 要素は何も`表現-$しない。 ◎ In a rendering, the template element represents nothing.

`shadowrootmode@a 内容~属性は、 `列挙d属性$であり， 次に挙げる~keyword, とり得る状態, それらの対応付けが定義される： ◎ The shadowrootmode content attribute is an enumerated attribute with the following keywords and states:

`shadowrootmode$a 属性の［ `妥当でない値~用の既定の状態$／ `欠落~値~用の既定の状態$ ］は、 `なし$st になるとする。 ◎ The shadowrootmode attribute's invalid value default and missing value default are both the none state.

`shadowrootdelegatesfocus@a 内容~属性は、 `真偽-属性$である。 ◎ The shadowrootdelegatesfocus content attribute is a boolean attribute.

`shadowrootclonable@a 内容~属性は、 `真偽-属性$である。 ◎ The shadowrootclonable content attribute is a boolean attribute.

`shadowrootserializable@a 内容~属性は、 `真偽-属性$である。 ◎ The shadowrootserializable content attribute is a boolean attribute.

`template$e 要素の`~template内容$は、 要素~自身の子ではない。 ◎ The template contents of a template element are not children of the element itself.

注記： ~DOM操作の結果として，［ `template$e 要素が `Text$I ~nodeや要素~nodeを包含する ］こともアリだが、 `template$e 要素の内容~modelは`なし$と定義されているので，それは違反になる。 ◎ It is also possible, as a result of DOM manipulation, for a template element to contain Text nodes and element nodes; however, having any is a violation of the template element's content model, since its content model is defined as nothing.

%~template.`content$m

`~template内容$（ `文書片$ ）を返す。 ◎ Returns the template contents (a DocumentFragment).

各 `template$e 要素には、 ある`文書片$が結付けられる — それが、 当の要素の `~template内容@ になる。 `~template内容$には 【構文~以外に】 `適合性~要件は無い＠~HTMLdom#no-browsing-context$。 ◎ Each template element has an associated DocumentFragment object that is its template contents. The template contents have no conformance requirements.＼

`shadowRootMode@m ~IDL属性は、 `既知な値のみに制限され$る下で， `shadowrootmode$a 内容~属性を`反映する$モノトスル。 ◎ The shadowRootMode IDL attribute must reflect the shadowrootmode content attribute, limited to only known values.

`shadowRootDelegatesFocus@m ~IDL属性は、 `shadowrootdelegatesfocus$a 内容~属性を`反映する$モノトスル。 ◎ The shadowRootDelegatesFocus IDL attribute must reflect the shadowrootdelegatesfocus content attribute.

`shadowRootClonable@m ~IDL属性は、 `shadowrootclonable$a 内容~属性を`反映する$モノトスル。 ◎ The shadowRootClonable IDL attribute must reflect the shadowrootclonable content attribute.

`shadowRootSerializable@m ~IDL属性は、 `shadowrootserializable$a 内容~属性を`反映する$モノトスル。 ◎ The shadowRootSerializable IDL attribute must reflect the shadowrootserializable content attribute.

4.12.4. `slot^e 要素

`分類$：

`~flow内容$ ／ `句ng内容$ ◎ Flow content. ◎ Phrasing content.

`この要素を利用できる文脈$：

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$：

`透過的$ ◎ Transparent

`text/html における~tag省略$：

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$：

`大域~属性$ ◎ Global attributes

`name$a — `~shadow~tree$の`~slot$の`~slot名$ ◎ name — Name of shadow tree slot

`~accessibilityの考慮点$

`slot$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLSlotElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute DOMString `name$m;
  sequence<Node> `assignedNodes$m(optional `AssignedNodesOptions$I %options = {});
  sequence<Element> `assignedElements$m(optional `AssignedNodesOptions$I %options = {});
  undefined `assign$m((`Element$I or `Text$I)... %nodes);
};

dictionary `AssignedNodesOptions@I {
  boolean `flatten@m = false;
};

`slot$e 要素は、 `~slot$を定義する。 それは概して，`~shadow~tree$に利用される。 `slot$e 要素は、［ それに`割当された~node群$は空でないならば それらの~node ／ ~ELSE_ 自身の内容 ］を`表現-$する。 ◎ The slot element defines a slot. It is typically used in a shadow tree. A slot element represents its assigned nodes, if any, and its contents otherwise.

`name@a 内容~属性が包含する値は、 どのような文字列でもヨイ。 それは、 `~slot$の`~slot名$を表現する。 ◎ The name content attribute may contain any string value. It represents a slot's name.

注記： `name$a 属性は、 他の要素を，この要素が定義する`~slotに割当する$ために利用される： `name$a 属性を有する `slot$e 要素 %slot は、 その属性~値を`~slot名$とする`~slot$を作成し， 次を満たすような他の要素を その`~slotに割当する$ことが可能になる ⇒ ［ 要素の `slot$a 属性の値は~slot名に合致する ］~AND［ %slot を子とする`~shadow~tree$の`根$の`~host$が，対応する `slot$a 属性~値を持つ【？】 ］ 【！要素は slot の~shadow根の~hostの子／子孫である？】 ◎ The name attribute is used to assign slots to other elements: a slot element with a name attribute creates a named slot to which any element is assigned if that element has a slot attribute whose value matches that name attribute's value, and the slot element is a child of the shadow tree whose root's host has that corresponding slot attribute value.

%slot.`name$m

%slot の`~slot名$を取得したり設定するために利用できる。 ◎ Can be used to get and set slot's name.

%slot.`assignedNodes(options)$m

%options の `flatten^m ~member値に応じて：

• ~F （ %options の省略時も含む）ならば ⇒ %slot に`割当された~node群$を返す。
• ~T ならば ⇒ %slot に`割当された~node群$は［ 空でないならば それを成す~nodeたち ／ 空ならば %slot の子たち ］に加えて、 それらに含まれる各 `slot$e 要素に対しても， `slot$e 要素が尽きるまで，再帰的に同じことをして得られる~node群を返す。

◎ Returns slot's assigned nodes. ◎ slot . assignedNodes({ flatten: true }) ◎ Returns slot's assigned nodes, if any, and slot's children otherwise, and does the same for any slot elements encountered therein, recursively, until there are no slot elements left.

%slot.`assignedElements(options)$m

`assignedNodes(options)$m と同じ結果を，要素のみに制限した上で返す。 ◎ Returns slot's assigned nodes, limited to elements. ◎ slot . assignedElements({ flatten: true }) ◎ Returns the same as assignedNodes({ flatten: true }), limited to elements.

%slot.`assign(...nodes)$m

%~slot に`手動で割当された~node群$を所与の %nodes に設定する。 ◎ Sets slot's manually assigned nodes to the given nodes.

`name@m ~IDL属性は、 `name$a 内容~属性を`反映する$モノトスル。 ◎ The name IDL attribute must reflect the content attribute of the same name.

各 `slot$e 要素には `手動で割当された~node群@ がある — それは、 `~slot可能$たちが成す`有順序~集合$であり，初期~時は空とする。 この集合は、 `assign()$m により設定される。 ◎ The slot element has manually assigned nodes, which is an ordered set of slottables set by assign(). This set is initially empty.

注記： `手動で割当された~node群$は、 ~scriptからは直に~access可能でないので， `~slot可能$への弱い参照を利用して実装できる／され得る。 ◎ The manually assigned nodes set can be implemented using weak references to the slottables, because this set is not directly accessible from script.