top-level browsing context

Edit New

最上位閲覧文脈 (Web)

[1] 最上位閲覧文脈 (top-level browsing context) は、 親閲覧文脈のない閲覧文脈です。Webブラウザーの窓やタブに相当する閲覧文脈です。

[2] これに対して、フレームに相当する閲覧文脈は最上位閲覧文脈ではありません。

[3] JavaScript では window.top 属性により最上位閲覧文脈の WindowProxy オブジェクトにアクセスできます。

[4] HTML では target 属性値 _top により最上位閲覧文脈で開くべきことを示せます。

仕様書

意味

[18] 最上位閲覧文脈は、閲覧文脈の親閲覧文脈をたどってそれ以上たどれなくなったところの閲覧文脈です。

[19] 単に「最上位閲覧文脈」といえば親閲覧文脈が null である閲覧文脈のことをいいますし、 ある閲覧文脈の最上位閲覧文脈といえばその閲覧文脈から親閲覧文脈をたどった果てを表します。

[20] 最上位閲覧文脈の最上位閲覧文脈は null です。

状態

[5] 閲覧文脈を参照。

作成

[6] 最上位閲覧文脈が作成されたら、セッション履歴イベントループを並列に実行しなければなりません。

破棄

[23] 最上位閲覧文脈は、窓やタブを利用者が閉じることによって破棄されたり、 window.close で破棄されたりします。

[7] 最上位閲覧文脈が破棄されたら、セッション履歴イベントループは停止する必要があります。

[9] 利用者エージェントは、最上位閲覧文脈への強い参照を持ちます >>8。 閲覧文脈を捨てると、この強い参照は破棄されます >>8。

Window インターフェイス top 属性

[13] window.top は、 最上位閲覧文脈を返します。 現在の窓が最上位閲覧文脈なら、その Window を返します (つまり window.top === window)。 現在の窓がそれ以外の閲覧文脈 (iframe など) なら、 最上位閲覧文脈の Window を返します。

[11] Window インターフェイスの top IDL属性の取得器は、 次のようにしなければなりません >>10。

  1. [33] 文脈オブジェクトの閲覧文脈が null の場合、
    1. [34] null を返します。
  2. [35] それ以外の場合、
    1. [36] 文脈オブジェクトの閲覧文脈の最上位閲覧文脈の WindowProxy を返します。

[17] このIDL属性は、Unforgeable です >>10。

_top

レンダリング

[27] 最上位閲覧文脈は、窓にてレンダリングされます。

関連

[16] 最上位閲覧文脈は、親閲覧文脈をたどれるところまでたどった先にあたります。

[21] 最上位閲覧文脈は、補助閲覧文脈かもしれません。

[22] 最上位閲覧文脈でないものは、入れ子閲覧文脈です。

[26] ある閲覧文脈とその祖先閲覧文脈のすべての最上位閲覧文脈は、 同じ閲覧文脈です。

歴史

[24] Be more precise about nested and discarded browsing contexts (domenic著, ) https://github.com/whatwg/html/commit/39118df640ad4a3f03f164fb5ffe0a56316297be

[31] Make Window's parent and top attributes nullable (yuyokk著, ) https://github.com/whatwg/html/commit/9149bbbdeb877f179aef95e4d1cdd418a052886f

[32] Editorial: shorten Window's top attribute's algorithm (annevk著, ) https://github.com/whatwg/html/commit/bc58c7792feb62ad82841ad80beb100a0362af91

[12] Editorial: shorten Window's top attribute's algorithm by annevk · Pull Request #4378 · whatwg/html () https://github.com/whatwg/html/pull/4378

Updated: