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

iframe要素


1.仕様

IFRAME要素は、
ネストされた
ブラウジング
コンテキストを
表します。

iframe

インラインフレーム (inline subwindow)

種類

通常要素

コンテンツモデル
何もない

要素のコンテンツモデルが「何もない」の場合、要素にはテキストノード (要素間の空白以外) と要素ノードが含まれていてはなりません。

タグの省略

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

コンテンツ属性
グローバル属性 他
src属性
リソースのアドレス
srcdoc属性
iframe にレンダリングするドキュメント
name属性
ナビゲート可能なコンテンツの名前
sandbox属性
ネストされたコンテンツのセキュリティルール
allow属性
iframe のコンテンツに適用される権限ポリシー
allowfullscreen属性
iframe のコンテンツに requestFullscreen() の使用を許可するかどうか
width属性
水平寸法
height属性
垂直寸法
referrerpolicy属性
要素によって開始されたフェッチのリファラーポリシー
loading属性
積載延期を決定する際に使用
DOM インターフェイス
HTMLIFrameElement
  1. [Exposed=Window]
  2. interface HTMLIFrameElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute USVString src;
  6. [CEReactions] attribute (TrustedHTML or DOMString) srcdoc;
  7. [CEReactions] attribute DOMString name;
  8. [SameObject, PutForwards=value] readonly attribute DOMTokenList sandbox;
  9. [CEReactions] attribute DOMString allow;
  10. [CEReactions] attribute boolean allowFullscreen;
  11. [CEReactions] attribute DOMString width;
  12. [CEReactions] attribute DOMString height;
  13. [CEReactions] attribute DOMString referrerPolicy;
  14. [CEReactions] attribute DOMString loading;
  15. readonly attribute Document? contentDocument;
  16. readonly attribute WindowProxy? contentWindow;
  17. Document? getSVGDocument();
  18.  
  19. // also has obsolete members
  20. };
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ロール="あり" aria-* 属性="GlobalAny"

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

作成者が要素に指定してもよい ARIAロール値は、 application, document, img, image, none, presentation です。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。

レンダリング
エンベデッドコンテンツ
  1. iframe { border: 2px inset; }
  2. iframe[frameborder='0'], iframe[frameborder=no i] { border: none; }
  3. iframe[align=left i] { float: left; }
  4. iframe[align=right i] { float: right; }
  5. iframe[align=top i] { vertical-align: top; }
  6. iframe[align=baseline i] { vertical-align: baseline; }
  7. iframe[align=texttop i] { vertical-align: text-top; }
  8. iframe[align=absmiddle i], iframe[align=abscenter i] { vertical-align: middle; }
  9. iframe[align=bottom i] { vertical-align: bottom; }

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

説明
iframe要素は、そのコンテンツナビゲート可能要素を表します。

iframe要素は、src属性は、要素のコンテンツナビゲート可能要素に含まれるページの URL を指定します。属性が存在する場合、その属性は、スペースで囲まれている可能性のある、有効な空でない URL である必要があります。iframe要素で itemprop属性が指定されている場合は、src属性も指定する必要があります。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>iframe要素の例 - (Example of iframe element) | 離珠のHTMLでしぃ!</title>
  6. </head>
  7. <body>
  8. <h1>iframe要素の例</h1>
  9. <iframe src="../Html/exiframe01.htm"></iframe>
  10. </body>
  11. </html>

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

JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "iframe": {
  3. "check": "2024-09-29",
  4. "group": "Embedded",
  5. "element": "- - EMPTY -- inline subwindow. (Normal elements.) [Flow|Phrasing|Embedded|Interactive|Palpable] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "src": "%URI; #IMPLIED -- Address of the resource --",
  9. "srcdoc": "CDATA #IMPLIED -- A document to render in the iframe --",
  10. "name": "CDATA #IMPLIED -- Name of content navigable --",
  11. "sandbox": "%Sandbox #IMPLIED -- Security rules for nested content --",
  12. "allow": "%Policy #IMPLIED -- Permissions policy to be applied to the iframe's contents --",
  13. "allowfullscreen": "(allowfullscreen) #IMPLIED -- Whether to allow the iframe's contents to use requestFullscreen() --",
  14. "width": "%Length; #IMPLIED -- Horizontal dimension --",
  15. "height": "%Length; #IMPLIED -- Vertical dimension --",
  16. "referrerpolicy": "CDATA #IMPLIED -- Referrer policy for fetches initiated by the element --",
  17. "loading": "CDATA #IMPLIED -- Used when determining loading deferral --",
  18. },
  19. "comment": "インラインフレーム (inline subwindow)",
  20. "point": "そのコンテンツナビゲート可能要素を表します。",
  21. "description": "src属性は、要素のコンテンツナビゲート可能要素に含まれるページの URL を指定します。属性が存在する場合、その属性は、スペースで囲まれている可能性のある、有効な空でない URL である必要があります。iframe要素で itemprop属性が指定されている場合は、src属性も指定する必要があります。",
  22. "kind": "Normal",
  23. "categories": [
  24. "Flow",
  25. "Phrasing",
  26. "Embedded",
  27. "Interactive",
  28. "Palpable",
  29. ],
  30. "used": "parent %Embedded",
  31. "contentmodel": "%Nothing",
  32. "tag": [
  33. "-",
  34. "-",
  35. ],
  36. "attributes": {
  37. "src": "リソースのアドレス",
  38. "srcdoc": "iframe にレンダリングするドキュメント",
  39. "name": "ナビゲート可能なコンテンツの名前",
  40. "sandbox": "ネストされたコンテンツのセキュリティルール",
  41. "allow": "iframe のコンテンツに適用される権限ポリシー",
  42. "allowfullscreen": "iframe のコンテンツに requestFullscreen() の使用を許可するかどうか",
  43. "width": "水平寸法",
  44. "height": "垂直寸法",
  45. "referrerpolicy": "要素によって開始されたフェッチのリファラーポリシー",
  46. "loading": "積載延期を決定する際に使用",
  47. },
  48. "dominterface": "HTMLIFrameElement",
  49. "rendering": "Embedded",
  50. "reference": [
  51. {
  52. "title": "HTML Living Standard. 4.8.5 The iframe element",
  53. "href": "https://html.spec.whatwg.org/multipage/iframe-embed-object.html#the-iframe-element",
  54. "heading": "HTML Living Standard. 4.8.5 The iframe element",
  55. "sub": "Last Updated 27 August 2024",
  56. },
  57. {
  58. "title": "HTML Living Standard. 15 Rendering 15.4.1 Embedded content",
  59. "href": "https://html.spec.whatwg.org/multipage/rendering.html#embedded-content-rendering-rules",
  60. "heading": "HTML Living Standard. 15 Rendering 15.4.1 Embedded content",
  61. "sub": "Last Updated 27 August 2024",
  62. },
  63. {
  64. "title": "HTML 5.2 W3C Recommendation. 4.7.6. The iframe element. W3C Recommendation, 14 December 2017.",
  65. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/semantics-embedded-content.html#the-iframe-element",
  66. "heading": "HTML 5.2 W3C 勧告. 4.7.6. The iframe element",
  67. "sub": "W3C勧告、2017年12月14日",
  68. },
  69. {
  70. "title": "HTML 5.2 W3C Recommendation. 10.4.1. Embedded content. W3C Recommendation, 14 December 2017.",
  71. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#replaced-elements-embedded-content",
  72. "heading": "HTML 5.2 W3C 勧告. 10.4.1. Embedded content",
  73. "sub": "W3C勧告、2017年12月14日",
  74. },
  75. {
  76. "title": "HTML 5.1 W3C Recommendation. 4.7.6. The iframe element. W3C Recommendation, 1 November 2016.",
  77. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/semantics-embedded-content.html#the-iframe-element",
  78. "heading": "HTML 5.1 W3C 勧告. 4.7.6. The iframe element",
  79. "sub": "W3C勧告、2016年11月1日",
  80. },
  81. {
  82. "title": "HTML 5.1 W3C Recommendation. 10.4.1. Embedded content. W3C Recommendation, 1 November 2016.",
  83. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#replaced-elements-embedded-content",
  84. "heading": "HTML 5.1 W3C 勧告. 10.4.1. Embedded content",
  85. "sub": "W3C勧告、2016年11月1日",
  86. },
  87. {
  88. "title": "HTML 5 W3C Recommendation. 4.7.2 The iframe element. W3C Recommendation, 28 October 2014.",
  89. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-iframe-element",
  90. "heading": "HTML 5 W3C 勧告. 4.7.2 The iframe element",
  91. "sub": "W3C勧告、2014年10月28日",
  92. },
  93. {
  94. "title": "HTML 5 W3C Recommendation. 10.4.1 Embedded content. W3C Recommendation, 28 October 2014.",
  95. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#embedded-content-1",
  96. "heading": "HTML 5 W3C 勧告. 10.4.1 Embedded content",
  97. "sub": "W3C勧告、2014年10月28日",
  98. },
  99. {
  100. "title": "HTML 4.01 Specification W3C Recommendation. 16.5 Inline frames: the IFRAME element. W3C Recommendation 24 December 1999.",
  101. "href": "https://www.w3.org/TR/html401/present/frames.html#h-16.5",
  102. "heading": "HTML 4.01 Specification W3C 勧告. 16.5 Inline frames: the IFRAME element",
  103. "sub": "W3C勧告1999年12月24日",
  104. },
  105. {
  106. "title": "MDN Web Docs. HTML <iframe>: The Inline Frame element.",
  107. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/iframe",
  108. "heading": "MDN Web Docs. HTML <iframe>: インラインフレーム要素",
  109. },
  110. ],
  111. "version": {
  112. "first": "HTML4.01 Transitional",
  113. "latest": "HTML Living Standard",
  114. },
  115. }
  116. }

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

最終確認日

2024-09-29


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


3.コンテンツモデル


4.コンテンツ属性


5.DOM インターフェイス


6.レンダリング


7.気を付ける点

暫定

width:310px


width:320px


width:370px


width:375px


width:475px


width:480px


width:635px


width:640px



8.付記