1.仕様
FRAME要素は、
単一フレームの
内容と外観を定義します。
FRAME - X EMPTY -- subwindow (Void elements.) [None] --
- frame
-
サブウィンドウ (subwindow)
HTML4.01 Frameset で扱われた、HTML5 で廃止の要素です。
- 種類
-
空要素
任意のコンテンツを持つことができない要素です。
- カテゴリ
-
なし
- 使用できるコンテキスト
-
frameset
要素 に 0個以上frameset
要素 に 0個以上を そのコンテンツとして、使用できます。 - コンテンツモデル
-
何もない
要素のコンテンツモデルが「何もない」の場合、要素にはテキストノード (要素間の空白以外) と要素ノードが含まれていてはなりません。
- タグの省略
-
終了タグはありません。
- コンテンツ属性
-
グローバル属性 他
- src
属性 - フレームコンテンツのソース
- name
属性 - ターゲティングするフレームの名前
- scrolling
属性 - フレーム ウィンドウのスクロール情報
- frameborder
属性 - フレーム境界に関する情報
- longdesc
属性 - 長い説明へのリンク
- noresize
属性 - ユーザーによるフレームのサイズの変更可否
- marginheight
属性 - フレームのコンテンツの上部と下部の余白の間に残すスペースの量
- marginwidth
属性 - フレームのコンテンツ間の左右の余白に残すスペースの量
- src
- DOM インターフェイス
-
HTMLFrameElement
[Exposed=Window]
interface HTMLFrameElement : HTMLElement {
[HTMLConstructor] constructor();
[CEReactions] attribute DOMString name;
[CEReactions] attribute DOMString scrolling;
[CEReactions] attribute USVString src;
[CEReactions] attribute DOMString frameBorder;
[CEReactions] attribute USVString longDesc;
[CEReactions] attribute boolean noResize;
readonly attribute Document? contentDocument;
readonly attribute WindowProxy? contentWindow;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString marginHeight;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString marginWidth;
};
HTMLElement
[Exposed=Window]
interface HTMLElement : Element {
[HTMLConstructor] constructor();
// metadata attributes
[CEReactions] attribute DOMString title;
[CEReactions] attribute DOMString lang;
[CEReactions] attribute boolean translate;
[CEReactions] attribute DOMString dir;
// user interaction
[CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
[CEReactions] attribute DOMString inert;
undefined click();
[CEReactions] attribute DOMString accessKey;
readonly attribute DOMString accessKeyLabel;
[CEReactions] attribute boolean draggable;
[CEReactions] attribute boolean spellcheck;
[CEReactions] attribute DOMString writingSuggestions;
[CEReactions] attribute DOMString autocapitalize;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
ElementInternals attachInternals();
// The popover API
undefined showPopover();
undefined hidePopover();
boolean togglePopover(optional boolean force);
[CEReactions] attribute DOMString? popover;
};
HTMLElement includes GlobalEventHandlers;
HTMLElement includes ElementContentEditable;
HTMLElement includes HTMLOrSVGElement;
Element
[Exposed=Window]
interface Element : Node {
readonly attribute DOMString? namespaceURI;
readonly attribute DOMString? prefix;
readonly attribute DOMString localName;
readonly attribute DOMString tagName;
[CEReactions] attribute DOMString id;
[CEReactions] attribute DOMString className;
[SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
[CEReactions, Unscopable] attribute DOMString slot;
boolean hasAttributes();
[SameObject] readonly attribute NamedNodeMap attributes;
sequence<DOMString> getAttributeNames();
DOMString? getAttribute(DOMString qualifiedName);
DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
[CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
[CEReactions] undefined removeAttribute(DOMString qualifiedName);
[CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
boolean hasAttribute(DOMString qualifiedName);
boolean hasAttributeNS(DOMString? namespace, DOMString localName);
Attr? getAttributeNode(DOMString qualifiedName);
Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
[CEReactions] Attr? setAttributeNode(Attr attr);
[CEReactions] Attr? setAttributeNodeNS(Attr attr);
[CEReactions] Attr removeAttributeNode(Attr attr);
ShadowRoot attachShadow(ShadowRootInit init);
readonly attribute ShadowRoot? shadowRoot;
Element? closest(DOMString selectors);
boolean matches(DOMString selectors);
boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
HTMLCollection getElementsByTagName(DOMString qualifiedName);
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
HTMLCollection getElementsByClassName(DOMString classNames);
[CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
undefined insertAdjacentText(DOMString where, DOMString data); // legacy
};
GlobalEventHandlers
interface mixin GlobalEventHandlers {
attribute EventHandler onabort;
attribute EventHandler onauxclick;
attribute EventHandler onbeforeinput;
attribute EventHandler onbeforematch;
attribute EventHandler onbeforetoggle;
attribute EventHandler onblur;
attribute EventHandler oncancel;
attribute EventHandler oncanplay;
attribute EventHandler oncanplaythrough;
attribute EventHandler onchange;
attribute EventHandler onclick;
attribute EventHandler onclose;
attribute EventHandler oncontextlost;
attribute EventHandler oncontextmenu;
attribute EventHandler oncontextrestored;
attribute EventHandler oncopy;
attribute EventHandler oncuechange;
attribute EventHandler oncut;
attribute EventHandler ondblclick;
attribute EventHandler ondrag;
attribute EventHandler ondragend;
attribute EventHandler ondragenter;
attribute EventHandler ondragleave;
attribute EventHandler ondragover;
attribute EventHandler ondragstart;
attribute EventHandler ondrop;
attribute EventHandler ondurationchange;
attribute EventHandler onemptied;
attribute EventHandler onended;
attribute OnErrorEventHandler onerror;
attribute EventHandler onfocus;
attribute EventHandler onformdata;
attribute EventHandler oninput;
attribute EventHandler oninvalid;
attribute EventHandler onkeydown;
attribute EventHandler onkeypress;
attribute EventHandler onkeyup;
attribute EventHandler onload;
attribute EventHandler onloadeddata;
attribute EventHandler onloadedmetadata;
attribute EventHandler onloadstart;
attribute EventHandler onmousedown;
[LegacyLenientThis] attribute EventHandler onmouseenter;
[LegacyLenientThis] attribute EventHandler onmouseleave;
attribute EventHandler onmousemove;
attribute EventHandler onmouseout;
attribute EventHandler onmouseover;
attribute EventHandler onmouseup;
attribute EventHandler onpaste;
attribute EventHandler onpause;
attribute EventHandler onplay;
attribute EventHandler onplaying;
attribute EventHandler onprogress;
attribute EventHandler onratechange;
attribute EventHandler onreset;
attribute EventHandler onresize;
attribute EventHandler onscroll;
attribute EventHandler onscrollend;
attribute EventHandler onsecuritypolicyviolation;
attribute EventHandler onseeked;
attribute EventHandler onseeking;
attribute EventHandler onselect;
attribute EventHandler onslotchange;
attribute EventHandler onstalled;
attribute EventHandler onsubmit;
attribute EventHandler onsuspend;
attribute EventHandler ontimeupdate;
attribute EventHandler ontoggle;
attribute EventHandler onvolumechange;
attribute EventHandler onwaiting;
attribute EventHandler onwebkitanimationend;
attribute EventHandler onwebkitanimationiteration;
attribute EventHandler onwebkitanimationstart;
attribute EventHandler onwebkittransitionend;
attribute EventHandler onwheel;
};
ElementContentEditable
interface mixin ElementContentEditable {
[CEReactions] attribute DOMString contentEditable;
[CEReactions] attribute DOMString enterKeyHint;
readonly attribute boolean isContentEditable;
[CEReactions] attribute DOMString inputMode;
};
HTMLOrSVGElement
interface mixin HTMLOrSVGElement {
[SameObject] readonly attribute DOMStringMap dataset;
attribute DOMString nonce; // intentionally no [CEReactions]
[CEReactions] attribute boolean autofocus;
[CEReactions] attribute long tabIndex;
undefined focus(optional FocusOptions options = {});
undefined blur();
};
- ARIA in HTML
-
この要素は、HTML5 では廃止された機能です。ARIA in HTML に、この要素の記述はありません。
- レンダリング
- 置換
要素 フレーム
frame {
display: block;
}
CSS を大雑把に読むと、 この要素は、内容(コンテンツ)が CSSフォーマットモデルの範囲外の置換要素です。 ブロックレベルボックスを生成します。 などになります。
- 説明
-
frame
要素 は、一つのフレームの内容と外観を表します。frame
要素 には、iframe要素 と同様にナビゲート可能なコンテンツがありますが、frameset要素 内でレンダリングされます。HTML5 では廃止された要素です。iframe
要素 とスタイルシートを用いて代用できます。<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
<html lang=
"ja"> <head>
<meta http-equiv=
"Content-Type" content= "text/html; charset=UTF-8"> <title>frame要素の例 - (Example of frame element) | 離珠のHTMLでしぃ!</title>
<link rel=
"icon" href= "../favicon.ico" type= "image/vnd.microsoft.icon"> </head>
<frameset cols=
"30%,*"> <frame src=
"./exframe01.htm"> <frameset rows=
"35%,*"> <frame src=
"./exframe02.htm"> <frame src=
"./exframe03.htm"> </frameset>
<noframes>
<body>
<h1>frame要素の例</h1>
<p>この例の frame要素は、一つのフレームの内容と外観を表しています。</p>
</body>
</noframes>
</frameset>
</html>
このサンプルへのリンクです。
(./exframe.htm, ./exframe01.htm, ./exframe02.htm, ./exframe03.htm) - 参照元
-
参照元
- HTML Living Standard. 16.2 Non-conforming features (Last Updated 27 August 2024)
- HTML Living Standard. 16.3.2 Frames (Last Updated 27 August 2024)
- HTML Living Standard. 15 Rendering 15.6 Frames and framesets (Last Updated 19 July 2024)
- HTML 5.2 W3C 勧告. 11.3.3 Frames (W3C勧告、2017年12月14日)
- HTML 5.1 W3C 勧告. 11.3.3 Frames (W3C勧告、2016年11月1日)
- HTML 5 W3C 勧告. 11.3.3 Frames (W3C勧告、2014年10月28日)
- HTML 4.01 Specification. 16 Frames in HTML documents. 16.2.2 The FRAME element (W3C勧告1999年12月24日)
- <frame> - HTML: ハイパーテキストマークアップ言語 | MDN
- JSONデータ
-
JSON形式での、データのイメージです。
{
"frame": {
"check": "2024-09-01",
"group": "Page",
"element": "- X EMPTY -- subwindow (Void elements.) [None] --",
"attlist": {
"%Global;": "",
"longdesc": "%URI; #IMPLIED -- link to long description (complements title) --",
"name": "CDATA #IMPLIED -- name of frame for targetting --",
"src": "%URI; #IMPLIED -- source of frame content --",
"frameborder": "(1|0) 1 -- request frame borders? --",
"marginwidth": "%Pixels; #IMPLIED -- margin widths in pixels --",
"marginheight": "%Pixels; #IMPLIED -- margin height in pixels --",
"noresize": "(noresize) #IMPLIED -- allow users to resize frames? --",
"scrolling": "(yes|no|auto) auto -- scrollbar or none --",
},
"comment": "サブウィンドウ (subwindow)",
"point": "一つのフレームの内容と外観を表します。",
"kind": "Void",
"categories": "None",
"used": "FRAMESET (FRAME)*",
"contentmodel": "%Nothing",
"tag": [
"-",
"X",
],
"attributes": {
"src": "フレームコンテンツのソース",
"name": "ターゲティングするフレームの名前",
"scrolling": "フレーム ウィンドウのスクロール情報",
"frameborder": "フレーム境界に関する情報",
"longdesc": "長い説明へのリンク",
"noresize": "ユーザーによるフレームのサイズの変更可否",
"marginheight": "フレームのコンテンツの上部と下部の余白の間に残すスペースの量",
"marginwidth": "フレームのコンテンツ間の左右の余白に残すスペースの量",
},
"dominterface": "HTMLFrameElement",
"rendering": "Replacedframe",
"reference": [
{
"title": "HTML Living Standard. 16.2 Non-conforming features.",
"href": "https://html.spec.whatwg.org/multipage/obsolete.html#noframes",
"heading": "HTML Living Standard. 16.2 Non-conforming features",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML Living Standard. 16.3.2 Frames.",
"href": "https://html.spec.whatwg.org/multipage/obsolete.html#frames",
"heading": "HTML Living Standard. 16.3.2 Frames",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML Living Standard. 15 Rendering 15.6 Frames and framesets.",
"href": "https://html.spec.whatwg.org/multipage/rendering.html#frames-and-framesets",
"heading": "HTML Living Standard. 15 Rendering 15.6 Frames and framesets",
"sub": "Last Updated 19 July 2024",
},
{
"title": "HTML 5.2 W3C Recommendation. 11.3.3 Frames. W3C Recommendation, 14 December 2017.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/obsolete.html#frames",
"heading": "HTML 5.2 W3C 勧告. 11.3.3 Frames",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.1 W3C Recommendation. 11.3.3 Frames. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/obsolete.html#frames",
"heading": "HTML 5.1 W3C 勧告. 11.3.3 Frames",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5 W3C Recommendation. 11.3.3 Frames. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/obsolete.html#frames",
"heading": "HTML 5 W3C 勧告. 11.3.3 Frames",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "HTML 4.01 Specification. 16 Frames in HTML documents. 16.2.2 The FRAME element.",
"href": "https://www.w3.org/TR/html401/present/frames.html#h-16.2.2",
"heading": "HTML 4.01 Specification. 16 Frames in HTML documents. 16.2.2 The FRAME element",
"sub": "W3C勧告1999年12月24日",
},
{
"title": "MDN Web Docs. HTML <frame>.",
"href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/frame",
"heading": "<frame> - HTML: ハイパーテキストマークアップ言語 | MDN",
},
],
"version": {
"first": "HTML4.01 Frameset",
"latest": "HTML4.01 Frameset",
},
}
}
注意: 簡易に描画する為に、各項目の後ろに
,
を付与しています。JSON の形式では、末尾の項目の後には,
は付けません。 - 最終確認日
-
2024-09-01
2.使用できるコンテキスト
frame要素は、
frameset要素の
コンテンツとして
使用できます。
frame
HTML5 では廃止された要素です。iframe
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
<html lang=
"ja"> <head>
<meta charset=
"utf-8"> <title>サンプル</title>
</head>
<frameset cols=
"30%, *"> <frame src=
"./menu.htm"> <frameset rows=
"20%, *"> <frame src=
"./header.htm"> <frame src=
"./body.htm"> </frameset>
<noframes>
<body>
フレームに関しての、テキストデータの表示等の例示です。
</body>
</noframes>
</frameset>
</html>
HTML4.01 Frameset でframeset
3.コンテンツモデル
frame要素は、
配置可能なコンテンツは
ありません。
frame
frame
frame
4.コンテンツ属性
frame要素は、
グローバル属性と、
src属性と
name属性と
scrolling属性と
frameborder属性と
longdesc属性と
noresize属性と
marginheight属性と
marginwidth属性を
設定できます。
frame
src属性
<frame src=
"./exframe01.htm">
src
name属性
<frame name=
"frame1" src= "./exframe01.htm">
name
scrolling属性
<frame scrolling=
"auto" src= "./exframe01.htm">
scrolling
- auto
- この値は、必要に応じてフレームウィンドウのスクロールデバイスを提供するようユーザーエージェントに指示します。これが既定値です。
- yes
- この値は、フレームウィンドウのスクロールデバイスを常に提供するようユーザーエージェントに指示します。
- no
- この値は、フレームウィンドウのスクロールデバイスを提供しないようユーザーエージェントに指示します。
frameborder属性
<frame frameborder=
"1" src= "./exframe01.htm">
frameborder
- 1
- この値は、ユーザーエージェントに、このフレームと隣接するすべてのフレームの間に区切り線を描画するように指示します。これが既定値です。
- 0
- この値は、ユーザーエージェントに、このフレームと隣接するすべてのフレームの間にセパレーターを描画しないように指示します。ただし、他のフレームによって指定されている場合は、このフレームの横にセパレーターが描画されることがあります。
longdesc属性
<frame longdesc=
"frame-desc.txt" src= "./exframe01.htm">
longdesc
noresize属性
<frame noresize src=
"./exframe01.htm">
noresize
marginheight属性
<frame marginheight=
"10" src= "./exframe01.htm">
marginheight
marginwidth属性
<frame marginwidth=
"10" src= "./exframe01.htm">
marginwidth
5.DOM インターフェイス
windowの
プロパティである
framesは、
frame要素及び
iframe要素の
配列風オブジェクトを
返します。
framewindow
のプロパティであるframes
を用います。これはあくまで、フレームのコンテンツを操作するものです。
framedocument
の querySelector()メソッド等を用いて、タイプセレクタ, 子結合子, 疑似クラスなどを組み合わせて要素を特定して、目的の要素を取得する事が考えられます。HTMLFrameElement インターフェイスの形式で取得できます。ここのcontentWindowdocument
がframe
他のフレーム内のドキュメントの操作に関しては、制限があります。
6.アクセシビリティ
frame要素は、
ARIA in HTML に、
記述はありません。
frame
案としては、フレームの名前を意味として分かり易くするくらいでしょうか。frame
そもそも論として、frame
7.レンダリング
frame {
display: block;
}
frameblock
であり、置換
frame
frame
8.気を付ける点
frame要素は、
HTML5 で
廃止されています。
frame
iframe