frame 要素 (HTML)

[9] HTML の frame 要素は、枠 (フレーム) (frame) の内容と見た目を定義します。

代替

[5] 現在では iframe 要素を使うのが普通です。

仕様書

[51] HTML Standard (2015-05-06 10:42:35 +09:00 版) https://html.spec.whatwg.org/#active-frame-element

[12]

開始タグ

必須

終了タグ

禁止 (HTML 4), 必須 (XHTML 1)

出現できる文脈

frameset の子供として任意個

内容模型

空 (強制空要素)

属性

属性名	属性値	既定値	説明	状態	出典
`allowcrossdomainxhr`			非標準	Air
`application`	`on` \| `off`			非標準	HTA
`bordercolor`	`%Color`		境界線色	非標準
`class`		(なし)	級	[HTML 4] `%coreattrs`
`datafld`			データ欄	非標準
`datasrc`	`%URI`	(なし)	データ源	非標準
`documentroot`			非標準	Air
`frameborder`	`1 \| 0`	`1`	枠境界線	[HTML 4] 枠
`framespacing`			枠間隔	非標準
`id`	`ID`	(なし)	固有識別子	[HTML 4] `%coreattrs`
`longdesc`	`%URI`	(なし)	長い説明の参照	[HTML 4] 枠
`marginheight`	`%Pixels`		余白高さ	[HTML 4] 枠
`marginwidth`	`%Pixels`		余白幅	[HTML 4] 枠
`name`		(なし)	枠名	[HTML 4] 枠
`noresize`	(真偽値属性)	(偽)	寸法可変性	[HTML 4] 枠
`ondominitialize`			非標準	Air
`sandboxroot`			非標準	Air
`scrolling`		`auto`		[HTML 4] 枠
`security`			安全上の扱い	非標準	WinIE
`src`	`%URI`	(なし)	枠内容	[HTML 4] 枠
`style`		(なし)	スタイル指定	[HTML 4] `%coreattrs`
`title`	`%Text`	(なし)	注釈的題	[HTML 4] `%coreattrs`
`xmlns`	`http://www.w3.org/1999/xhtml` 固定		W3C 勧告	XHTML m12n

フレーム内容

[14] フレームの内容を直接画像とすることは望ましくありません。 (非視覚 UA 向けに) 画像の説明を記述できなくなってしまうからです。 HTML 4 16.4.2

例えば、

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
   "http://www.w3.org/TR/html4/frameset.dtd">
<HTML>
<HEAD>
<TITLE>A poorly-designed frameset document</TITLE>
</HEAD>
<FRAMESET cols="20%, 80%">
   <FRAME src="table_of_contents.html">
   <FRAME src="ostrich.gif" longdesc="ostrich-desc.html">
</FRAMESET>
</HTML>

のような場合、確かに longdesc 属性を使うことはできますが、 longdesc は本来フレームの初期内容ではなくフレーム自体を説明するべきものです。

リンクによって他の画像に替えられると、その画像の説明はなくなってしまいます。

[15] という HTML 4 仕様書にある >>14 の考え方は適当ではないと言う人もいます。曰く、画像が非視覚 UA で表示できないのは代替文を埋め込めない画像形式や画像を表示できない UA の限界で、ありとあらゆる状況で内容を得ることができるようにするのは無理なことです。

また、フレームを使わない場合でも a を使って画像にリンクすることがありますが、それも好ましくないと言うのでなければ一貫しません。そのようなリンクを行うときには、必要で可能であればリンク元に画像の説明があるはずです。フレーム内であってもそれは同じことでしょう。

また、あるフレームに表示される画像が有限なら、 longdesc 文書にすべての代替文を記述しておくのも一つの方法です。

[16] HTML 4 仕様書は、回避策として画像を埋め込んだだけのダミー文書を用意することを勧めていますけど、無駄なだけですよね。

状態

[22] 要素、閲覧文脈包含子としての状態を持ちます。

[3] 文書中にある frame 要素を、活性frame要素 (active frame element) といいます >>51。

処理

[8] 著者は frame 要素を使ってはなりませんが、利用者エージェントは frame 要素を実装しなければなりません。

[2] フレームを参照。

[65] frame 要素要素の属性に関する属性変更手順群は、新しい値を次のようにしなければなりません >>51。

[24] 要素の入れ子閲覧文脈が null 以外なら、
1. [25] 属性が src 属性なら、
  1. [26] 要素についてframe属性の処理を行います。
2. [27] 属性が name 属性なら、
  1. [28] 要素の入れ子閲覧文脈の閲覧文脈名を、 新しい値が null なら空文字列、それ以外なら新しい値に設定します。

`HTMLFrameElement` インターフェイス

[6] frame 要素の要素インターフェイスは、 HTMLFrameElement インターフェイスです。

[7] HTMLFrameElement インターフェイスには、次のメンバーがあります。

contentDocument
contentWindow

歴史

[4] Netscape Navigator 2.0 で導入されました。

HTML4

[10] HTML 4
- 16.2.2 The FRAME element IW:HTML4:"present/frames.html#edef-FRAME"
- 16.4.2 Long descriptions of frames IW:HTML4:"present/frames.html#idx-accessibility-1"

[19] Internet Explorer Linked Pages Are Being Cached in Frame Set ( (2013-11-05 09:10:47 +09:00 版)) http://support.microsoft.com/kb/233528/en-us

[20] IE5のお気に入りにクリビツ! ( (2007-12-08 03:32:18 +09:00 版)) http://www.tohoho-web.com/lng/199904/99040069.htm

`frame` 要素 (XFrames)

[17] XFrames (2010-12-17 00:45:08 +09:00 版) http://www.w3.org/TR/2010/NOTE-xframes-20101216/#s_frame-element

[18] HTML とは違って、 URL は src 属性ではなく、 source 属性に指定します。

HTML5

[21] Web Applications 1.0 r8380 Update <frame> requirements to match legacy better ( (2014-01-07 08:46:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=8379&to=8380

他との関係

[11] HTML には、特定実装の拡張で、同名別用法の frame 要素型が存在します (>>8)。

例

[13] フレームの見た目を指定した例 HTML 4 16.2.2.2

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
   "http://www.w3.org/TR/html4/frameset.dtd">
<HTML>
<HEAD>
<TITLE>A frameset document</TITLE>
</HEAD>
<FRAMESET cols="33%,33%,33%">
  <FRAMESET rows="*,200">
      <FRAME src="contents_of_frame1.html" scrolling="no">
      <FRAME src="contents_of_frame2.gif" 
                marginwidth="10" marginheight="15"
                noresize>
  </FRAMESET>
  <FRAME src="contents_of_frame3.html" frameborder="0">
  <FRAME src="contents_of_frame4.html" frameborder="0">
</FRAMESET>
</HTML>

この例では、フレーム1は scroll できなくなります。フレーム2は画像の周りに余白が付きますし、大きさを変えることができなくなります。

フレーム3とフレーム4の間には境界線をつけません。フレーム1とフレーム2とフレーム3の間の境界線は付きます。 (フレーム2とフレーム3の間に境界線が引かれることに注意。)

[23] Be more precise about nested and discarded browsing contexts (domenic著, 2016-07-20 22:58:49 +09:00) https://github.com/whatwg/html/commit/39118df640ad4a3f03f164fb5ffe0a56316297be

[29] Editorial: Cross-reference DOM "child" where appropriate in rendering (zcorpan著, 2016-09-20 20:16:41 +09:00) https://github.com/whatwg/html/commit/e8c91c05edc8d6cdb33fdd5452e052359d40490b

[30] Make <frame> fire load synchronously with "completely loaded" (annevk著, 2018-02-22 20:11:33 +09:00) https://github.com/whatwg/html/commit/16de123059bd4b3660677fb4fdc03e2053815482

[31] frame and iframe have different load-event-firing behaviors · Issue #3492 · whatwg/html (2018-02-24 19:33:32 +09:00) https://github.com/whatwg/html/issues/3492

[32] Make <frame> fire load synchronously with "completely loaded" by annevk · Pull Request #3495 · whatwg/html (2018-02-24 19:33:52 +09:00) https://github.com/whatwg/html/pull/3495

[33] Make the default tabIndex for <frame> 0 (domenic著, 2019-08-23 04:40:17 +09:00) https://github.com/whatwg/html/commit/7952ba43a9a7c2f0295359f8dbe097e5f1bdbfd5

[34] The default tab index of frame element should be 0 · Issue #4855 · whatwg/html · GitHub (2020-07-13 12:32:11 +09:00) https://github.com/whatwg/html/issues/4855

[35] Make the default tabIndex for <frame> 0 by domenic · Pull Request #4859 · whatwg/html · GitHub (2020-07-13 12:32:33 +09:00) https://github.com/whatwg/html/pull/4859

[36] Editorial: nested browsing context is a member, not a type (annevk, 2019-11-27 02:46:03 +09:00, 2022-01-18T10:08:48.000Z) https://github.com/whatwg/html/commit/6b737bbc428facf34ec3728c0912cf9e172d0ea4