HTML: The Living Standard

Edition for Web Developers — Last Updated 30 November 2021

1. 1. 4.12 スクリプティング
      1. 4.12.1 script要素
         1. 4.12.1.1 スクリプト言語
         2. 4.12.1.2 script要素のコンテンツの制約
         3. 4.12.1.3 外部スクリプトに対するインライン文書
      2. 4.12.2 noscript要素
      3. 4.12.3 template要素
      4. 4.12.4 slot要素

4.12 スクリプティング

スクリプトは著者が文書に双方向性を追加することを許可する。

著者は、宣言型のメカニズムがしばしばより保守しやすく、かつ多くのユーザーがスクリプトを無効としているため、可能であれば、スクリプトに宣言型の代替を使用するよう推奨される。

著者はまた、スクリプトのサポートがない状態でそれらのアプリケーションが行儀よくデグレードするよう推奨される。

4.12.1 script要素

カテゴリー：

メタデータコンテンツ。

フローコンテンツ。

フレージングコンテンツ。

スクリプトサポート要素。

この要素を使用できるコンテキスト：

メタデータコンテンツが期待される場所。

フレージングコンテンツが期待される場所。

スクリプトサポート要素が期待される場所。

コンテンツモデル：

src属性が存在しない場合、type属性の値に依存するが、スクリプトの内容制限に一致しなければならない。

src属性が存在する場合、要素は空またはスクリプト文書を含むだけでなくスクリプトの内容制限に一致するかのいずれかでなければならない。

text/htmlにおけるタグ省略：

どちらのタグも省略不可。

コンテンツ属性：

グローバル属性

src — リソースのアドレス

type — スクリプトの種類

nomodule — モジュールスクリプトをサポートするユーザーエージェントにおける実行を防ぐ

async — フェッチの間ブロックなしで、可能な場合にスクリプトを実行する

defer — スクリプトの実行を延期する

crossorigin — 要素が生成元をまたいだ要求を処理する方法

integrity — Subresource Integrityチェックで使用される整合性メタデータ[SRI]

referrerpolicy — 要素によって開始されたフェッチのためのリファラーポリシー

アクセシビリティの考慮：

著者向け。

実装者向け。

DOMインターフェイス：

HTMLScriptElementを使用する。

script要素は、著者が文書に動的スクリプトおよびデータブロックを含むことを許可する。この要素は、ユーザーにコンテンツを表すものでない。

type属性は、表されるスクリプトの型をカスタマイズを可能にする：

• 属性を省略する、空文字列に設定する、またはJavaScript MIMEタイプエッセンスマッチに設定することは、スクリプトがJavaScript Scriptトップレベル制作物によって解釈されるようなクラシックスクリプトであることを意味する。クラシックスクリプトはasync属性およびdefer属性の影響を受けるが、src属性が設定されている場合のみである。著者は重複して設定する代わりに、type属性を省略すべきである。

• Setting the attribute to an ASCII case-insensitive match for the string "module" means that the script is a JavaScript module script, to be interpreted according to the JavaScript Module top-level production. モジュールスクリプトはdefer属性の影響を受けないが、 async属性の影響を受ける（src属性の状態に関係なく）。

• 他の値に属性を設定することは、スクリプトが処理されないデータブロックであることを意味する。（type自身を除く）script属性のいずれもデータブロック上で任意の効果を持たない。著者は、データブロックを示すためにJavaScript MIMEタイプエッセンシャルマッチでない妥当なMIMEタイプ文字列を使用しなければならない。

データブロックが妥当なMIMEタイプ文字列を使用して表記されなければならない要件は、潜在的な将来の衝突を回避するための場所である。この仕様がスクリプトの追加の型をいずれ追加する場合、その追加の型は"module"値がモジュールスクリプトを表す方法のように、MIMEタイプでない何かにtype属性を設定することによってトリガーされる。現在に妥当なMIMEタイプ文字列を使用することで、将来のユーザーエージェントでさえも、データブロックが異なるスクリプトタイプとして再解釈されないことを保証する。

クラシックスクリプトおよびJavaScriptモジュールスクリプトは、インラインで埋め込むかsrc属性を使用する外部ファイルからインポートすることができ、これは指定された場合に使用する外部スクリプトリソースのURLを与える。srcが指定される場合、潜在的にスペースで囲まれる妥当な空でないURLでなければならない。

インラインscript要素、または外部スクリプトリソースのコンテンツは、それぞれクラシックスクリプトおよびJavaScriptモジュールスクリプトに対するJavaScript仕様のScriptまたはModule生成物の要件に適合しなければならない。[JAVASCRIPT]

The contents of the external script resource for CSS module scripts must conform to the requirements of the CSS specification. [CSS]

JSONモジュールスクリプトの外部スクリプトリソースのコンテンツは、JSON仕様[JSON]の要件に準拠しなければならない。

データブロックを含めるために使用される場合、データは、インラインに埋め込まれなければならず、データの形式は、type属性を使用して指定しなければならず、かつscript要素のコンテンツは、使用される形式のために定義される要件に適合しなければならない。src、async、nomodule、defer、crossorigin、integrityおよびreferrerpolicy属性を指定してはならない。

nomodule属性は、モジュールスクリプトをサポートするユーザーエージェントでスクリプトが実行されないようにする真偽属性である。これは、以下に示すように、モダンなユーザーエージェントのモジュールスクリプトと古いユーザーエージェントのクラシックスクリプトの選択的な実行を可能にする。nomodule属性をモジュールスクリプトで指定してはならない（この属性がある場合は無視される）。

asyncおよびdefer属性は、どのようにスクリプトが評価されるべきかを示す真偽属性である。クラシックスクリプトは、deferまたはasyncを指定してもよいが、src属性が存在しない限り、いずれかを指定してはならない。モジュールスクリプトはasync属性を指定してもよいが、defer属性を指定してはならない。

これらの属性を使用して、スクリプトの種類によって選択できる複数の可能なモードが存在する。

クラシックスクリプトについて、async属性が存在する場合、クラシックスクリプトは、構文解析と並行してフェッチされるとすぐに（潜在的に構文解析が完了する前に）利用可能になると評価される。asyncが存在しないがdefer属性が存在する場合、クラシックスクリプトは、並行してフェッチされ、ページが解析終了したときに評価される。いずれの属性も存在しない場合、スクリプトは、両方が完了するまで解析を阻止して、すぐにフェッチされ評価される。

モジュールスクリプトについて、async属性が存在する場合、モジュールスクリプトとそのすべての依存関係は、構文解析と並行してフェッチされ、モジュールスクリプトは利用可能になるとすぐに（潜在的に構文解析が完了する前に）評価される。そうでなければ、モジュールスクリプトとその依存関係は、構文解析と並行してフェッチされ、ページが解析終了したときに評価される。（defer属性は、モジュールスクリプトに影響しない。）

これは、次の模式図にすべて要約される：

これら属性の正確な処理の詳細は、主に歴史的な理由から、いくぶん自明でない、多くのHTMLの側面を含む。したがって、実装要求は必然的に仕様のあらゆる場所に散在している。（この節の）下記のアルゴリズムは、この処理の中核を説明するが、これらのアルゴリズムが参照する、およびHTMLにおけるscriptの開始タグと終了タグに対する構文解析規則、無関係なコンテンツで、XMLで、document.write()メソッドに対する規則、スクリプトの取り扱いなどによって参照される。

たとえasync属性が指定されても、デフォルトとなるブロッキング動作の代わりにdeferの動作をフォールバックするために、deferのみをサポートする（かつasyncをサポートしない）レガシーウェブブラウザーをもたらすため、defer属性は指定されてもよい。

crossorigin属性はCORS設定属性である。クラシックスクリプトについて、スクリプトが他の生成元から得られる場合、エラー情報が公開されるかどうかを制御する。モジュールスクリプトについて、生成元をまたいだリクエストに使用される資格情報モードを制御する。

クラシックスクリプトとは異なり、モジュールスクリプトは、生成元をまたいだフェッチのためにCORSプロトコルを使用する必要がある。

integrity属性は、この要素が責任を負うリクエストに対する完全性メタデータを表す。値はテキストである。src属性が指定されていない場合、integrity属性は指定してはならない。[SRI]

referrerpolicy属性は、リファラーポリシー属性である。その目的は、スクリプトをフェッチするときに使用されるリファラーポリシーと、そこからインポートされたスクリプトを設定することにある。[REFERRERPOLICY]

<script referrerpolicy="origin">
  fetch('/api/data');    // not fetched with <script>'s referrer policy
  import('./utils.mjs'); // is fetched with <script>'s referrer policy ("origin" in this case)
</script>

src、type、nomodule、async、defer、crossorigin、integrityおよびreferrerpolicyを動的に変更する属性は直接的な影響はない。これらの属性は、下記の特定の時間でのみ使用される。

script.text [ = value ]

要素の子テキストコンテンツを返す。

与えられた値を持つ要素の子を置換するために、設定できる。

HTMLScriptElement.supports(type)

⚠MDN

HTMLScriptElement/supports

Support in one engine only.

Firefox94+SafariNoChromeNo

---

OperaNoEdgeNo

---

Edge (Legacy)NoInternet ExplorerNo

---

Firefox Android94+Safari iOSNoChrome AndroidNoWebView AndroidNoSamsung InternetNoOpera AndroidNo

Returns true if the given type is a script type supported by the user agent. The possible script types in this specification are "classic" and "module", but others might be added in the future.

document.write()メソッドを使用して挿入するとき、通常はscript要素が実行される（一般に、スクリプトの実行またはHTMLの解析をブロックする）。innerHTML属性とouterHTML属性を使用して挿入する場合、それらは一切実行されない。

The supports(type) method steps are:

1. If type is "classic", then return true.

2. If type is "module", then return true.

3. falseを返す。

The type argument has to exactly match these values; we do not perform an ASCII case-insensitive match. This is different from how type content attribute values are treated, and how DOMTokenList's supports() method works, but it aligns with the WorkerType enumeration used in the Worker() constructor.

<script src="game-engine.js"></script>
<script type="text/x-game-map">
........U.........e
o............A....e
.....A.....AAA....e
.A..AAA...AAAAA...e
</script>

<script>
 function calculate(form) {
   var price = 52000;
   if (form.elements.brakes.checked)
     price += 1000;
   if (form.elements.radio.checked)
     price += 2500;
   if (form.elements.turbo.checked)
     price += 5000;
   if (form.elements.sticker.checked)
     price += 250;
   form.elements.result.value = price;
 }
</script>
<form name="pricecalc" onsubmit="return false" onchange="calculate(this)">
 <fieldset>
  <legend>Work out the price of your car</legend>
  <p>Base cost: £52000.</p>
  <p>Select additional options:</p>
  <ul>
   <li><label><input type=checkbox name=brakes> Ceramic brakes (£1000)</label></li>
   <li><label><input type=checkbox name=radio> Satellite radio (£2500)</label></li>
   <li><label><input type=checkbox name=turbo> Turbo charger (£5000)</label></li>
   <li><label><input type=checkbox name=sticker> "XZ" sticker (£250)</label></li>
  </ul>
  <p>Total: £<output name=result></output></p>
 </fieldset>
 <script>
  calculate(document.forms.pricecalc);
 </script>
</form>

<script type="module" src="app.mjs"></script>

<script type="module" src="app.mjs"></script>
<script nomodule defer src="classic-app-bundle.js"></script>

<script type="module">
 import { walkAllTextNodeDescendants } from "./dom-utils.mjs";

 const substitutions = new Map([
   ["witnesses", "these dudes I know"]
   ["allegedly", "kinda probably"]
   ["new study", "Tumblr post"]
   ["rebuild", "avenge"]
   ["space", "spaaace"]
   ["Google glass", "Virtual Boy"]
   ["smartphone", "Pokédex"]
   ["electric", "atomic"]
   ["Senator", "Elf-Lord"]
   ["car", "cat"]
   ["election", "eating contest"]
   ["Congressional leaders", "river spirits"]
   ["homeland security", "Homestar Runner"]
   ["could not be reached for comment", "is guilty and everyone knows it"]
 ]);

 function substitute(textNode) {
   for (const [before, after] of substitutions.entries()) {
     textNode.data = textNode.data.replace(new RegExp(`\\b${before}\\b`, "ig"), after);
   }
 }

 walkAllTextNodeDescendants(document.body, substitute);
</script>

<script type="module">
 import peopleInSpace from "http://api.open-notify.org/astros.json" assert { 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>

4.12.1.1 スクリプト言語

サーバーはJavaScriptリソースにtext/javascriptを使用すべきである。サーバーは、JavaScriptリソースに他のJavaScript MIMEタイプを使用すべきではなく、非JavaScript MIMEタイプを使用してはならない。

4.12.1.2 script要素のコンテンツの制約

The easiest and safest way to avoid the rather strange restrictions described in this section is to always escape an ASCII case-insensitive match for "<!--" as "\x3C!--", "<script" as "\x3Cscript", and "</script" as "\x3C/script" when these sequences appear in literals in scripts (e.g. in strings, regular expressions, or comments), and to avoid writing code that uses such constructs in expressions. この節の制限がトリガーになりやすい落とし穴を回避する：すなわち、歴史的な理由のために、HTMLにおけるscriptブロックの解析は、これらのシーケンスを考えた場合に直観的でない働きをする奇妙で風変わりな慣習である。

script要素の子孫テキストコンテンツは、Unicodeの文字セットである次のABNFのscript生成物と一致しなければならない。[ABNF]

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

outer         = < any string that doesn't contain a substring that matches not-in-outer >
not-in-outer  = comment-open
inner         = < any string that doesn't contain a substring that matches 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             =  %x0053 ; U+0053 LATIN CAPITAL LETTER S
s             =/ %x0073 ; U+0073 LATIN SMALL LETTER S
c             =  %x0043 ; U+0043 LATIN CAPITAL LETTER C
c             =/ %x0063 ; U+0063 LATIN SMALL LETTER C
r             =  %x0052 ; U+0052 LATIN CAPITAL LETTER R
r             =/ %x0072 ; U+0072 LATIN SMALL LETTER R
i             =  %x0049 ; U+0049 LATIN CAPITAL LETTER I
i             =/ %x0069 ; U+0069 LATIN SMALL LETTER I
p             =  %x0050 ; U+0050 LATIN CAPITAL LETTER P
p             =/ %x0070 ; U+0070 LATIN SMALL LETTER P
t             =  %x0054 ; U+0054 LATIN CAPITAL LETTER T
t             =/ %x0074 ; U+0074 LATIN SMALL LETTER T

tag-end       =  %x0009 ; U+0009 CHARACTER TABULATION (tab)
tag-end       =/ %x000A ; U+000A LINE FEED (LF)
tag-end       =/ %x000C ; U+000C FORM FEED (FF)
tag-end       =/ %x0020 ; U+0020 SPACE
tag-end       =/ %x002F ; U+002F SOLIDUS (/)
tag-end       =/ %x003E ; U+003E GREATER-THAN SIGN (>)

script要素がスクリプト文書を含む場合、以下の節で記述されるように、要素のコンテンツのさらなる制約がある。

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>
<!-- despite appearances, this is actually part of the script still! -->
<script>
 ... // this is the same script block still...
</script>

<script>
  // Note: `\x3C` is an escape sequence for `<`.
  const example = 'Consider this string: \x3C!-- \x3Cscript>';
  console.log(example);
</script>
<!-- this is just a comment between script blocks -->
<script>
 ... // this is a new script block
</script>

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

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

4.12.1.3 外部スクリプトに対するインライン文書

script要素のsrc属性が指定される場合、もしあれば、script要素のコンテンツは、要素のコンテンツから分割されるようなtext IDL属性値でなければならず、文字セットがUnicodeである下記のABNFでdocumentation生成物と一致しなければならない。[ABNF]

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           = %x0009 ; U+0009 CHARACTER TABULATION (tab)
newline       = %x000A ; U+000A LINE FEED (LF)
space         = %x0020 ; U+0020 SPACE
star          = %x002A ; U+002A ASTERISK (*)
slash         = %x002F ; U+002F SOLIDUS (/)
not-newline   = %x0000-0009 / %x000B-10FFFF
                ; a scalar value other than U+000A LINE FEED (LF)
not-star      = %x0000-0029 / %x002B-10FFFF
                ; a scalar value other than U+002A ASTERISK (*)
not-slash     = %x0000-002E / %x0030-10FFFF
                ; a scalar value other than U+002F SOLIDUS (/)

これは、JavaScriptのコメントで要素のコンテンツを設置するものと一致する。

この要求は、script要素のコンテンツの構文上に先の制約に加えて存在する。

<script src="cool-effects.js">
 // create new instances using:
 //    var e = new Effect();
 // start the effect using .play, stop using .stop:
 //    e.play();
 //    e.stop();
</script>

4.12.2 noscript要素

カテゴリー：

メタデータコンテンツ。

フローコンテンツ。

フレージングコンテンツ。

この要素を使用できるコンテキスト：

先祖noscript要素が存在しない場合、HTML文書のhead要素内。

先祖noscript要素が存在しない場合、HTML文書でフレージングコンテンツが期待される場所。

コンテンツモデル：

スクリプトが無効の場合、head要素内で：任意の順で、0個以上のlink要素、0個以上のstyle要素、0個以上のmeta要素。

スクリプトが無効の場合、head要素外で：透過的。ただし、noscript要素の子孫を持ってはならない。

そうでなければ：文で与えられる要件に適合するテキスト。

text/htmlにおけるタグ省略：

どちらのタグも省略不可。

コンテンツ属性：

グローバル属性

アクセシビリティの考慮：

著者向け。

実装者向け。

DOMインターフェイス：

HTMLElementを使用する。

noscript要素は、スクリプトが有効である場合は何も表さず、スクリプトが無効である場合は要素の子を表す。これは、文書が解析される方法に影響を与えることによって、スクリプトをサポートするユーザーエージェントとサポートしないユーザーエージェントに異なるマークアップを提示するために使用される。

HTML文書で使用する場合、許可されるコンテンツモデルは次のとおり：

スクリプトが無効である場合、head要素内のnoscript要素に対して

noscript要素は、link、style、およびmeta要素のみを含まなければならない。

スクリプトが有効である場合、head要素内のnoscript要素に対して

noscript要素は、テキストのみを含まなければならない。ただし、context要素としてnoscript要素をもつHTML断片解析アルゴリズムを呼び出し、かつinputとしてテキストコンテンツを呼び出すと、noscript要素の子であった場合に適合するだろう、link、style、meta要素のみからなるノードのリストをもたらさなければならず、かつ解析エラーでない場合を除く。

スクリプトが無効である場合、head要素外のnoscript要素に対して

noscript要素のコンテンツモデルは透過的であり、同時にnoscript要素がnoscript要素を持ってはならない（noscript要素を入れ子にできない）追加制限がある。

スクリプトが有効である場合、head要素外のnoscript要素に対して

noscript要素はテキストのみを含まなければならない。ただしテキストは、以下のアルゴリズムがnoscript要素およびscript要素をもたない適合文書をもたらすものでなければならず、アルゴリズムでステップは例外を投げるまたはHTMLパーサーに解析エラーを起こさないようにしなければならない：

1. 文書からすべてのscript要素を取り除く。
2. 文書においてすべてのnoscript要素のリストを作る。そのリストの各noscript要素に対して、以下のステップを実行する：
   1. sをnoscript要素要素の子テキストコンテンツとする。
   2. noscript要素のouterHTML属性をsの値に設定する。（これは、副作用としてnoscript要素を文書から除去させる。）[DOMPARSING]

歴史的な理由により、パーサーが呼び出されたときにスクリプトが有効にされたかどうかに基づくHTMLパーサーによってnoscript要素が異なる方法で処理されるので、これらのすべてのこじつけが必要とされる。

noscriptはXML文書で使用してはならない。

noscript要素はHTML構文でのみ有効だが、XML構文では効果がない。スクリプトが有効である場合、この要素が動作する方法は、基本的にパーサーを"オフ"にすることであり、要素の内容は、実際の要素としてではなく純粋にテキストとして扱われているのである。XMLは、これを実行するためのメカニズムを定義しない。

<form action="calcSquare.php">
 <p>
  <label for=x>Number</label>:
  <input id="x" name="x" type="number">
 </p>
 <script>
  var x = document.getElementById('x');
  var output = document.createElement('p');
  output.textContent = 'Type a number; it will be squared right then!';
  x.form.appendChild(output);
  x.form.onsubmit = function () { return false; }
  x.oninput = function () {
    var v = x.valueAsNumber;
    output.textContent = v + ' squared is ' + v * v;
  };
 </script>
 <noscript>
  <input type=submit value="Calculate Square">
 </noscript>
</form>

<form action="calcSquare.php">
 <p>
  <label for=x>Number</label>:
  <input id="x" name="x" type="number">
 </p>
 <input id="submit" type=submit value="Calculate Square">
 <script>
  var x = document.getElementById('x');
  var output = document.createElement('p');
  output.textContent = 'Type a number; it will be squared right then!';
  x.form.appendChild(output);
  x.form.onsubmit = function () { return false; }
  x.oninput = function () {
    var v = x.valueAsNumber;
    output.textContent = v + ' squared is ' + v * v;
  };
  var submit = document.getElementById('submit');
  submit.parentNode.removeChild(submit);
 </script>
</form>

4.12.3 template要素

カテゴリー：

メタデータコンテンツ。

フローコンテンツ。

フレージングコンテンツ。

スクリプトサポート要素。

この要素を使用できるコンテキスト：

メタデータコンテンツが期待される場所。

フレージングコンテンツが期待される場所。

スクリプトサポート要素が期待される場所。

span属性を持たないcolgroup要素の子として。

コンテンツモデル：

Nothing（明確化のために、例を参照）。

text/htmlにおけるタグ省略：

どちらのタグも省略不可。

コンテンツ属性：

グローバル属性

アクセシビリティの考慮：

著者向け。

実装者向け。

DOMインターフェイス：

HTMLTemplateElementを使用する。

template要素は、複製され、スクリプトによって文書に挿入できるHTMLの断片を宣言するために使用される。

レンダリングにおいて、template要素は何も表さない。

template要素のテンプレートコンテンツは、要素自体の子ではない。

DOM操作の結果として、template要素がTextノードと要素ノードを含むことも可能である。しかし、この要素のコンテンツモデルはnothingとして定義されるため、すべてのものはtemplate要素のコンテンツモデルに違反する。

<!doctype html>
<html lang="en">
 <head>
  <title>Homework</title>
 <body>
  <template id="template"><p>Smile!</p></template>
  <script>
   let num = 3;
   const fragment = document.getElementById('template').content.cloneNode(true);
   while (num-- > 1) {
     fragment.firstChild.before(fragment.firstChild.cloneNode(true));
     fragment.firstChild.textContent += fragment.lastChild.textContent;
   }
   document.body.appendChild(fragment);
  </script>
</html>

template.content

テンプレートコンテンツ（DocumentFragment）を返す。

<!DOCTYPE html>
<html lang='en'>
<title>Cat data</title>
<script>
 // Data is hard-coded here, but could come from the server
 var data = [
   { name: 'Pillar', color: 'Ticked Tabby', sex: 'Female (neutered)', legs: 3 },
   { name: 'Hedral', color: 'Tuxedo', sex: 'Male (neutered)', legs: 4 },
 ];
</script>
<table>
 <thead>
  <tr>
   <th>Name <th>Color <th>Sex <th>Legs
 <tbody>
  <template id="row">
   <tr><td><td><td><td>
  </template>
</table>
<script>
 var template = document.querySelector('#row');
 for (var i = 0; i < data.length; i += 1) {
   var cat = data[i];
   var clone = template.content.cloneNode(true);
   var cells = clone.querySelectorAll('td');
   cells[0].textContent = cat.name;
   cells[1].textContent = cat.color;
   cells[2].textContent = cat.sex;
   cells[3].textContent = cat.legs;
   template.parentNode.appendChild(clone);
 }
</script>

4.12.4 slot要素

カテゴリー：

フローコンテンツ。

フレージングコンテンツ。

この要素を使用できるコンテキスト：

フレージングコンテンツが期待される場所。

コンテンツモデル：

透過的

text/htmlにおけるタグ省略：

どちらのタグも省略不可。

コンテンツ属性：

グローバル属性

name — シャドウツリースロットの名前

アクセシビリティの考慮：

著者向け。

実装者向け。

DOMインターフェイス：

HTMLSlotElementを使用する。

slot要素は、スロットを定義する。典型的にシャドウツリーに使用される。もしあれば、slot要素はその割り当てられるノードを表し、そうでなければそのコンテンツを表す。

nameコンテンツ属性は、任意の文字列値を含んでもよい。これはスロットの名前を表す。

slot属性は、別の要素にスロットを割り当てるために使用される：name属性をもつslot要素は、その要素がそのname属性の値と一致する値を持つslot属性を持ち、かつslot要素がその対応するslot属性値を持つルートのホストを持つシャドウツリーの子である場合、任意の要素が割り当てられる名前付きスロットを作成する。

slot.name

slotの名前を取得し設定することが可能である。

slot.assignedNodes()

slotの割り当てられるノードを返す。

slot.assignedNodes({ flatten: true })

もしあれば、slotの割り当てられるノードを返し、そうでなければslotの子を返し、かつslot要素が存在しなくなるまで、再帰的に、slot要素に遭遇するのと同じものを返す。

slot.assignedElements()

要素に限定された、slotの割り当てられたノードを返す。

slot.assignedElements({ flatten: true })

要素に限定されたassignedNodes({ flatten: true })と同じものを返す。

slot.assign(...nodes)

Sets slot's manually assigned nodes to the given nodes.

name IDL属性は、同じ名前のコンテンツ属性を反映しなければならない。

The slot element has manually assigned nodes, which is an ordered set of slottables set by assign(). This set is initially empty.

The manually assigned nodes set can be implemented using weak references to the slottables, because this set is not directly accessible from script.

The assignedNodes(options) method steps are:

1. If options["flatten"] is false, then return this's assigned nodes.

2. Return the result of finding flattened slottables with this.

The assignedElements(options) method steps are:

1. If options["flatten"] is false, then return this's assigned nodes, filtered to contain only Element nodes.

2. Return the result of finding flattened slottables with this, filtered to contain only Element nodes.

The assign(...nodes) method steps are:

1. For each node of this's manually assigned nodes, set node's manual slot assignment to null.

2. Let nodesSet be a new ordered set.

3. For each node of nodes:

   1. If node's manual slot assignment refers to a slot, then remove node from that slot's manually assigned nodes.

   2. Set node's manual slot assignment to this.

   3. Append node to nodesSet.

4. Set this's manually assigned nodes to nodesSet.

5. Run assign slottables for a tree for this's root.