メインコンテンツへスキップ

slot要素

1.仕様

SLOT要素は、
スロットを作成します。

SLOT - - (%Phrasing)* -- slot. (Normal elements.) [Flow|Phrasing] --

slot

スロット (slot.)

種類

通常要素

カテゴリ

使用できるコンテキスト
フレージングコンテンツを受け入れる要素

フレージングコンテンツを受け入れる要素のコンテンツとして、使用できます。

フレージングコンテンツを受け入れる要素は、<h1>要素, <h2>要素, <h3>要素, <h4>要素, <h5>要素, <h6>要素, <p>要素, <pre>要素, <output>要素, <progress>要素, <meter>要素, <label>要素, <datalist>要素, <body>要素, <section>要素, <nav>要素, <aside>要素, <article>要素, <header>要素, <footer>要素, <main>要素, <address>要素, <li>要素, <dt>要素, <dd>要素, <caption>要素, <th>要素, <td>要素, <form>要素, <fieldset>要素, <search>要素, <blockquote>要素, <figure>要素, <figcaption>要素, <div>要素, <dialog>要素, <abbr>要素, <b>要素, <bdi>要素, <bdo>要素, <cite>要素, <code>要素, <data>要素, <dfn>要素, <em>要素, <i>要素, <kbd>要素, <mark>要素, <q>要素, <s>要素, <samp>要素, <small>要素, <span>要素, <strong>要素, <sub>要素, <sup>要素, <u>要素, <var>要素 です。

コンテンツモデル
透過的コンテンツ

一部の要素は透明であると説明されており、そのコンテンツモデルの説明には「transparent」がある。透明な要素のコンテンツモデルは、その親要素のコンテンツモデルから派生します。「transparent」であるコンテンツモデルの部分で要求される要素は、透明な要素がそれ自身を見つける透明な要素の親のコンテンツモデルの部分で要求される要素と同じ要素です。

タグの省略

どちらのタグも省略できません。

コンテンツ属性
グローバル属性 他
name属性
シャドウツリースロットの名前
DOM インターフェイス
HTMLSlotElement
  1. [Exposed=Window]
  2. interface HTMLSlotElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute DOMString name;
  6. sequence assignedNodes(optional AssignedNodesOptions options = {});
  7. sequence assignedElements(optional AssignedNodesOptions options = {});
  8. undefined assign((Element or Text)... nodes);
  9. };
HTMLElement
  1. [Exposed=Window]
  2. interface HTMLElement : Element {
  3. [HTMLConstructor] constructor();
  4.  
  5. // metadata attributes
  6. [CEReactions] attribute DOMString title;
  7. [CEReactions] attribute DOMString lang;
  8. [CEReactions] attribute boolean translate;
  9. [CEReactions] attribute DOMString dir;
  10.  
  11. // user interaction
  12. [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
  13. [CEReactions] attribute DOMString inert;
  14. undefined click();
  15. [CEReactions] attribute DOMString accessKey;
  16. readonly attribute DOMString accessKeyLabel;
  17. [CEReactions] attribute boolean draggable;
  18. [CEReactions] attribute boolean spellcheck;
  19. [CEReactions] attribute DOMString writingSuggestions;
  20. [CEReactions] attribute DOMString autocapitalize;
  21.  
  22. [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
  23. [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
  24.  
  25. ElementInternals attachInternals();
  26.  
  27. // The popover API
  28. undefined showPopover();
  29. undefined hidePopover();
  30. boolean togglePopover(optional boolean force);
  31. [CEReactions] attribute DOMString? popover;
  32. };
  33.  
  34. HTMLElement includes GlobalEventHandlers;
  35. HTMLElement includes ElementContentEditable;
  36. HTMLElement includes HTMLOrSVGElement;
Element
  1. [Exposed=Window]
  2. interface Element : Node {
  3. readonly attribute DOMString? namespaceURI;
  4. readonly attribute DOMString? prefix;
  5. readonly attribute DOMString localName;
  6. readonly attribute DOMString tagName;
  7.  
  8. [CEReactions] attribute DOMString id;
  9. [CEReactions] attribute DOMString className;
  10. [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
  11. [CEReactions, Unscopable] attribute DOMString slot;
  12.  
  13. boolean hasAttributes();
  14. [SameObject] readonly attribute NamedNodeMap attributes;
  15. sequence<DOMString> getAttributeNames();
  16. DOMString? getAttribute(DOMString qualifiedName);
  17. DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
  18. [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
  19. [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
  20. [CEReactions] undefined removeAttribute(DOMString qualifiedName);
  21. [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
  22. [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
  23. boolean hasAttribute(DOMString qualifiedName);
  24. boolean hasAttributeNS(DOMString? namespace, DOMString localName);
  25.  
  26. Attr? getAttributeNode(DOMString qualifiedName);
  27. Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
  28. [CEReactions] Attr? setAttributeNode(Attr attr);
  29. [CEReactions] Attr? setAttributeNodeNS(Attr attr);
  30. [CEReactions] Attr removeAttributeNode(Attr attr);
  31.  
  32. ShadowRoot attachShadow(ShadowRootInit init);
  33. readonly attribute ShadowRoot? shadowRoot;
  34.  
  35. Element? closest(DOMString selectors);
  36. boolean matches(DOMString selectors);
  37. boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
  38.  
  39. HTMLCollection getElementsByTagName(DOMString qualifiedName);
  40. HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
  41. HTMLCollection getElementsByClassName(DOMString classNames);
  42.  
  43. [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
  44. undefined insertAdjacentText(DOMString where, DOMString data); // legacy
  45. };
GlobalEventHandlers
  1. interface mixin GlobalEventHandlers {
  2. attribute EventHandler onabort;
  3. attribute EventHandler onauxclick;
  4. attribute EventHandler onbeforeinput;
  5. attribute EventHandler onbeforematch;
  6. attribute EventHandler onbeforetoggle;
  7. attribute EventHandler onblur;
  8. attribute EventHandler oncancel;
  9. attribute EventHandler oncanplay;
  10. attribute EventHandler oncanplaythrough;
  11. attribute EventHandler onchange;
  12. attribute EventHandler onclick;
  13. attribute EventHandler onclose;
  14. attribute EventHandler oncontextlost;
  15. attribute EventHandler oncontextmenu;
  16. attribute EventHandler oncontextrestored;
  17. attribute EventHandler oncopy;
  18. attribute EventHandler oncuechange;
  19. attribute EventHandler oncut;
  20. attribute EventHandler ondblclick;
  21. attribute EventHandler ondrag;
  22. attribute EventHandler ondragend;
  23. attribute EventHandler ondragenter;
  24. attribute EventHandler ondragleave;
  25. attribute EventHandler ondragover;
  26. attribute EventHandler ondragstart;
  27. attribute EventHandler ondrop;
  28. attribute EventHandler ondurationchange;
  29. attribute EventHandler onemptied;
  30. attribute EventHandler onended;
  31. attribute OnErrorEventHandler onerror;
  32. attribute EventHandler onfocus;
  33. attribute EventHandler onformdata;
  34. attribute EventHandler oninput;
  35. attribute EventHandler oninvalid;
  36. attribute EventHandler onkeydown;
  37. attribute EventHandler onkeypress;
  38. attribute EventHandler onkeyup;
  39. attribute EventHandler onload;
  40. attribute EventHandler onloadeddata;
  41. attribute EventHandler onloadedmetadata;
  42. attribute EventHandler onloadstart;
  43. attribute EventHandler onmousedown;
  44. [LegacyLenientThis] attribute EventHandler onmouseenter;
  45. [LegacyLenientThis] attribute EventHandler onmouseleave;
  46. attribute EventHandler onmousemove;
  47. attribute EventHandler onmouseout;
  48. attribute EventHandler onmouseover;
  49. attribute EventHandler onmouseup;
  50. attribute EventHandler onpaste;
  51. attribute EventHandler onpause;
  52. attribute EventHandler onplay;
  53. attribute EventHandler onplaying;
  54. attribute EventHandler onprogress;
  55. attribute EventHandler onratechange;
  56. attribute EventHandler onreset;
  57. attribute EventHandler onresize;
  58. attribute EventHandler onscroll;
  59. attribute EventHandler onscrollend;
  60. attribute EventHandler onsecuritypolicyviolation;
  61. attribute EventHandler onseeked;
  62. attribute EventHandler onseeking;
  63. attribute EventHandler onselect;
  64. attribute EventHandler onslotchange;
  65. attribute EventHandler onstalled;
  66. attribute EventHandler onsubmit;
  67. attribute EventHandler onsuspend;
  68. attribute EventHandler ontimeupdate;
  69. attribute EventHandler ontoggle;
  70. attribute EventHandler onvolumechange;
  71. attribute EventHandler onwaiting;
  72. attribute EventHandler onwebkitanimationend;
  73. attribute EventHandler onwebkitanimationiteration;
  74. attribute EventHandler onwebkitanimationstart;
  75. attribute EventHandler onwebkittransitionend;
  76. attribute EventHandler onwheel;
  77. };
ElementContentEditable
  1. interface mixin ElementContentEditable {
  2. [CEReactions] attribute DOMString contentEditable;
  3. [CEReactions] attribute DOMString enterKeyHint;
  4. readonly attribute boolean isContentEditable;
  5. [CEReactions] attribute DOMString inputMode;
  6. };
HTMLOrSVGElement
  1. interface mixin HTMLOrSVGElement {
  2. [SameObject] readonly attribute DOMStringMap dataset;
  3. attribute DOMString nonce; // intentionally no [CEReactions]
  4.  
  5. [CEReactions] attribute boolean autofocus;
  6. [CEReactions] attribute long tabIndex;
  7. undefined focus(optional FocusOptions options = {});
  8. undefined blur();
  9. };
ARIA in HTML
暗黙的="No" ARIAロール="No" aria-* 属性="No"

暗黙的な ARIAセマンティクスがありませんが、意味はあり、この意味は、ARIA によって提供されず、ARIA のユーザーに公開されていないロール、状態、プロパティで表現される可能性があります。

作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。

記述できる aria-* 属性はありません。

レンダリング
インラインボックス
フレージングコンテンツ
  1. slot {
  2. display: contents;
  3. }

CSS を大雑把に読むと、 などになります。

説明
slot要素は、スロットを作成します。

slot要素は、（コンテンツを受け取るための）スロットを定義します。
通常は、シャドウツリー内で使用されます。
スロット要素は、割り当てられたノードがあればそれを表示し、なければ自分の内容を表示します。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>slot要素の例 - (Example of slot element) | 離珠のHTMLでしぃ！</title>
  6. <template id="itpJs001">
  7. <p>てんぷれーとのさんぷる</p>
  8. <slot name="nslJs002"></slot>
  9. </template>
  10. <script>
  11. document.addEventListener("DOMContentLoaded", function() {
  12. document.getElementById("idvJs002").attachShadow({mode:"open"}).appendChild(document.getElementById("itpJs001").content.cloneNode(true));
  13. });
  14. </script>
  15. <link rel="icon" href="../favicon.ico" type="image/vnd.microsoft.icon">
  16. </head>
  17. <body>
  18. <h1>slot要素の例</h1>
  19. <div id="idvJs002">
  20. <p slot="nslJs002">すろっとのさんぷる。</p>
  21. <p>この例の template要素は、「てんぷれーとのさんぷる」というテキストの段落を用意しています。</p>
  22. </div>
  23. </body>
  24. </html>

このサンプルへのリンクです。
(./exslot.htm)

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "slot": {
  3. "check": "2025-01-23",
  4. "group": "Scripting",
  5. "element": "- - (%Phrasing)* -- slot. (Normal elements.) [Flow|Phrasing] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "name": "CDATA #IMPLIED -- Name of shadow tree slot --",
  9. },
  10. "comment": "スロット (slot.)",
  11. "point": "スロットを作成します。",
  12. "description": [
  13. "（コンテンツを受け取るための）スロットを定義します。",
  14. "通常は、シャドウツリー内で使用されます。",
  15. "スロット要素は、割り当てられたノードがあればそれを表示し、なければ自分の内容を表示します。",
  16. ],
  17. "kind": "Normal",
  18. "categories": [
  19. "Flow",
  20. "Phrasing",
  21. ],
  22. "used": "parent %Phrasing",
  23. "contentmodel": "%Transparent",
  24. "tag": [
  25. "-",
  26. "-",
  27. ],
  28. "attributes": {"name": "シャドウツリースロットの名前"},
  29. "dominterface": "HTMLSlotElement",
  30. "rendering": "Phrasing",
  31. "reference": [
  32. {
  33. "title": "HTML Living Standard. 4.12.4 The slot element.",
  34. "href": "https://html.spec.whatwg.org/multipage/scripting.html#the-slot-element",
  35. "heading": "HTML Living Standard. 4.12.4 The slot element",
  36. "sub": "Last Updated 10 February 2025",
  37. },
  38. {
  39. "title": "HTML Living Standard. 15 Rendering 15.3.3 Flow content.",
  40. "href": "https://html.spec.whatwg.org/multipage/rendering.html#flow-content-3",
  41. "heading": "HTML Living Standard. 15 Rendering 15.3.3 Flow content",
  42. "sub": "Last Updated 10 February 2025",
  43. },
  44. {
  45. "title": "HTML 5.2 W3C Recommendation. 10.3.3. Flow content. W3C Recommendation, 14 December 2017.",
  46. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#non-replaced-elements-flow-content",
  47. "heading": "HTML 5.2 W3C 勧告. 10.3.3. Flow content",
  48. "sub": "W3C勧告、2017年12月14日",
  49. },
  50. {
  51. "title": "MDN Web Docs. HTML <slot>: The Web Component Slot element.",
  52. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/slot",
  53. "heading": "MDN Web Docs. HTML <slot>: ウェブコンポーネントのスロット要素",
  54. },
  55. ],
  56. "version": {
  57. "first": "HTML Living Standard",
  58. "latest": "HTML Living Standard",
  59. },
  60. }
  61. }

注意: 簡易に描画する為に、各項目の後ろに , を付与しています。JSON の形式では、末尾の項目の後には , は付けません。

最終確認日

2025-01-23

2.使用できるコンテキスト

slot要素は、
フレージングコンテンツを
受け入れる要素に
配置できます。

<slot>要素が使用できるコンテキスト(Context・文脈)は、フレージングコンテンツを受け入れる要素のコンテンツとしてです。ただし<slot>要素は Shadow DOM 内 (シャドールート内) で使う為のものなので、それなりの位置に配置すべきです。<template>要素はコンポーネントのマークアップを定義する為に使われる事が多いですが、<slot>要素の祖先として必須ではありません。

3.コンテンツモデル

slot要素は、
親要素の内容として
適切なコンテンツが
配置できます。

<slot>要素の子や子孫としてどのようなコンテンツ(Content・内容) が含まれなければならないかというと、「透過的」です。

別の言い方で細かく言うと、<slot>要素は、親要素のコンテンツモデルそのままで配置できるので、フレージングコンテンツを配置できます。親要素がフローコンテンツも配置できる場合は、フローコンテンツも配置できます。尚、条件付きでフローコンテンツを配置できる要素もあるので、詳細は個別の要素で確認が必要です。

コンテンツモデルで「透過的」(transparent) とは、その透明な要素のコンテンツモデルは、その透明な要素の親要素のコンテンツモデルから派生するという事です。つまり、「透明」であるコンテンツモデルの部分に必要な要素は、透明な要素が含まれる透明な要素の親のコンテンツモデルの部分に必要な要素と同じです。

<slot>要素は Shadow DOM 内 (シャドールート内) で使う為のものなので、それなりの位置に配置されます。 その子孫として配置できるかが、<slot>要素のコンテンツとして配置できるかに関わってきるので、注意が必要です。

4.コンテンツ属性

slot要素は、
グローバル属性と、
name を
設定できます。

<slot>要素に指定することができる属性は、グローバル属性とname属性を設定できます。

name属性

  1. <slot name="nslJs001">

name属性 は、シャドウツリースロットの名前を設定にします。name属性には、任意の文字列値を含める事ができます。

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

slot属性は、グローバル属性であり、slot IDL属性は、Element インターフェイスにて定義されています。

5.DOM インターフェイス

slot要素を、
直接表す
プロパティは
ありません。

<slot>要素を JavaScript などで操作するには、documentのquerySelectorAll()メソッドを用いて要素セレクタと属性セレクタでslot[name='nslJs001']などと指定して、<slot>要素のリストを取得する方法があります。この時に取得できる値の形式はHTMLSlotElement インターフェイスのリストです。

6.アクセシビリティ

slot要素は、
暗黙的な
ARIAセマンティクスは
ありません。

<slot>要素の暗黙的なARIAセマンティクスは、ありません。 ただ、意味は持っており、この意味はARIAによって提供されていないロール, ステート, プロパティで表現され、アクセシビリティAPIを介して支援技術のユーザーに公開されるかもしれません。

作成者が要素に指定できる<slot>要素のARIA の役割、状態、およびプロパティの許容範囲は、No role (役割なし) と記されており、作成者は暗黙的なARIAセマンティクスまたはHTML要素のネイティブセマンティクスを上書きしてはならないことを表していす。
また、No aria-* attributes (aria-* 属性はありません) とも記されています。(実際は、No role or aria-* attributesと纏めて記されています。)

つまり、<slot>要素の役割はなく、作成者は、ARIA ロール値と aria-* 属性を<slot>要素に指定出来ないという事です。

7.レンダリング

  1. slot {
  2. display: contents;
  3. }

<slot>要素のユーザーエージェントレベルのスタイルシートデフォルトでは、displayプロパティの値は contents であり、 要素自体はボックスを生成しませんが、 その子要素と疑似要素は通常通りボックスとテキストシーケンスを生成します。 ボックス生成とレイアウトのために、要素は要素ツリー内でその内容（ソースドキュメント内の子要素と、::before 疑似要素や ::after 疑似要素など、通常通り子要素の前後に生成される疑似要素の両方を含む）によって置き換えられたかのように扱われます。

8.気を付ける点

何故、slot要素を用いるのか
意図を理解して
記述しましょう

slot要素は、HTMLの１要素であり、HTML文書に書くものです。 その上で、スクリプトで操作するためのものなので、スクリプト側の都合も関係してきます。

当然の事ながらスクリプトを用いると、その分のデータ量が増えますし、処理時間も増えます。 slot要素の採用の意図をよく考えて、用いましょう。