CSSOM ビューモジュール

1. 背景

この仕様で定義されている多くの機能は、長期間にわたりブラウザでサポートされてきました。本仕様の目的は、これらの機能をすべてのブラウザが相互運用可能な方法で実装できるように定義することです。また、スクロールのカスタマイズを可能にするいくつかの新しい機能も定義しています。

2. 用語

本仕様で用いられる用語は、DOM、CSSOM、HTMLからのものです。[DOM] [CSSOM] [HTML]

要素 body（これは body 要素）は、以下すべての条件が真である場合、スクロール可能性があるとみなされます：

• body に関連付けられた ボックス がある。

• body の 親要素 の overflow-x または overflow-y プロパティの計算値が visible でも clip でもない。

• body の overflow-x または overflow-y プロパティの計算値が visible でも clip でもない。

注: body 要素が スクロール可能性がある場合でも、スクロールボックスを持たない場合があります。 例えば、overflow の使用値が auto であっても、内容がそのコンテンツ領域からはみ出していない場合などです。

スクロールボックスは、ビューポートまたは要素のものであり、2つのオーバーフロー方向を持ちます。これらはそのビューポートや要素に対してのブロックエンド方向とインラインエンド方向です。 初期スクロール位置は、スクロール領域の原点に必ずしも揃うとは限りません。これは内容分布プロパティに依存するためです。詳しくはCSS ボックスアラインメント 3 § 5.3 アラインメントのオーバーフローとスクロールコンテナを参照してください。

スクロール領域とは、 ビューポートや要素のボックスであり、 ビューポートや要素の スクロールボックスの オーバーフロー方向に応じて、以下のようなエッジを持ちます。

原点とは、 スクロール領域の原点を指し、 初期包含ブロックの原点が スクロール領域が ビューポートである場合の原点です。 それ以外の場合は、要素のデフォルトスクロール位置における左上パディング端です。 x座標は右方向に増加し、y座標は下方向に増加します。

開始端とは、 ボックスや要素の特定の端集合において、以下の端を指します：

オーバーフロー方向が右方向・下方向の場合

上端および左端。

オーバーフロー方向が左方向・下方向の場合

上端および右端。

オーバーフロー方向が左方向・上方向の場合

下端および右端。

オーバーフロー方向が右方向・上方向の場合

下端および左端。

終了端とは、 ボックスや要素の特定の端集合において、以下の端を指します：

オーバーフロー方向が右方向・下方向の場合

下端および右端。

オーバーフロー方向が左方向・下方向の場合

下端および左端。

オーバーフロー方向が左方向・上方向の場合

上端および左端。

オーバーフロー方向が右方向・上方向の場合

上端および右端。

ビジュアルビューポートは、 ビューポートの一種であり、その スクロール領域は別の ビューポートとなり、 それを レイアウトビューポートと呼びます。

スクロールに加えて、ビジュアルビューポートは レイアウトビューポートにスケール変換も適用する場合があります。 この変換は レイアウトビューポートの キャンバスに適用され、 内部座標空間には影響しません。

注: ビジュアルビューポートのスケール変換は、一般的に「ピンチズーム」と呼ばれます。概念的には、この変換は CSS の 基準ピクセルのサイズを変更しますが、レイアウトビューポートのサイズも比例的に変更されるため、ページ内容のリフローを引き起こしません。

このスケール変換の大きさは、ビジュアルビューポートの スケールファクターと呼ばれます。

VisualViewport オブジェクトには 関連付けられた文書 があり、これは Document オブジェクトである。 これは、Window の 関連付けられた文書 であり、 VisualViewport の所有者である。 レイアウトビューポートは、 所有者 Window の ビューポート である。

この仕様の要件において、 display プロパティの算出値が table-column または table-column-group である要素は、 関連付けられた ボックス （それぞれカラムまたはカラムグループ）を持つものとして扱わなければならない。

SVG レイアウトボックス とは、SVG 要素によって生成され、 CSS で定義された display 型に対応しない ボックス を指す。 （例えば、rect 要素によって生成される ボックス など。）

変形（transforms） とは、 SVG 変形および CSS 変形を指す。[SVG11] [CSS-TRANSFORMS-1]

あるメソッドや属性が他のメソッドや属性を呼び出すと言われた場合、ユーザーエージェントはその属性やメソッドの内部 API を実行しなければならない。 例えば、著者が ECMAScript で属性やメソッドをカスタムプロパティや関数で上書きしても挙動を変更できないようにするためである。

特に明記がない限り、すべての文字列比較は is を用いる。

2.1. CSS ピクセル

この仕様で定義される API のすべての座標や寸法は、特に記載がない限り CSS ピクセル で表される。[CSS-VALUES]

注: これは、例えば matchMedia() など、単位が明示的に指定されている場合には適用されない。

2.2. ズーム

ズームには2種類あり、初期ビューポートのサイズに影響する ページズーム、 および初期ビューポートや実際のビューポートには影響せず虫眼鏡のように作用する ビジュアルビューポートの スケールファクター がある。 [CSS-DEVICE-ADAPT]

注: 「スケールファクター」は「ピンチズーム」と呼ばれることが多いが、 ピンチズーム以外でも影響を受ける場合がある。例: ユーザーエージェントがフォーカスされた入力要素を拡大表示して判読しやすくするためにズームすることがある。

2.3. Web に公開されるスクリーン情報

ユーザーのプライバシーを守るため、ユーザーエージェントは出力デバイスのスクリーン情報を隠すことを選択できる。 API 間で一貫した方法でこれを行うため、この仕様では以下の用語を定義する。 それぞれ幅・高さを持ち、原点は左上隅、x座標とy座標はそれぞれ右方向と下方向に増加する。

Web に公開されるスクリーン領域 は以下のいずれかである：

• 出力デバイスの領域（CSS ピクセル単位）

• ビューポートの領域（CSS ピクセル単位）

Web に公開される利用可能スクリーン領域 は以下のいずれかである：

• 出力デバイスのレンダリングサーフェスの利用可能領域（CSS ピクセル単位）

• 出力デバイスの領域（CSS ピクセル単位）

• ビューポートの領域（CSS ピクセル単位）

3. 共通インフラストラクチャ

この仕様は WHATWG Infra 標準に依存する。[INFRA]

3.1. スクロール

スクロールは、スクロール位置に保留中の更新や変換がなくなり、ユーザーがジェスチャーを完了したときに 完了する。 スクロール位置の更新にはスムーズまたは即時のマウスホイールスクロール、キーボードスクロール、スクロールスナップイベント、その他スクロール位置を更新・補間する API やジェスチャが含まれる。 タッチパンやトラックパッドスクロールなどのユーザー操作は、ポインタやキーが解放されるまで完了しない。

ユーザーエージェントが スクロールボックス box を position へ スムーズスクロール する場合、 box のスクロール位置をユーザーエージェント独自の方法で一定時間かけて更新する。 スクロールが 完了したら、 box のスクロール位置は position になっている必要がある。 スクロールはアルゴリズムやユーザーによって 中断されることもある。

ユーザーエージェントが スクロールボックス box を position へ 即時スクロールする場合、box のスクロール位置を position に更新する。

文書 document で 文書の先頭へスクロールするには、次の手順を実行する：

1. viewport を document に関連付けられたビューポートとする。
2. position を viewport の スクロール領域の 始端 を viewport の 始端 に合わせたときのスクロール位置とする。
3. position が viewport の現在のスクロール位置と同じで、かつ viewport に進行中の スムーズスクロール がなければ、これらの手順を中断する。
4. スクロールを実行：viewport を position へ、 document の ルート要素があればそれ、なければ null を関連付け要素として実行。

注: このアルゴリズムは HTML で定義される #top フラグメント識別子へのナビゲーション時に使用される。[HTML]

3.2. WebIDL 値

非有限値を正規化するよう要求されたとき、値 x が 3つの特別な浮動小数点リテラル値のいずれか（Infinity, -Infinity, NaN） であれば、x は 0 に変更されなければならない。 [WEBIDL]

4. Window インターフェイスへの拡張

enum ScrollBehavior { "auto", "instant", "smooth" };

dictionary ScrollOptions {
    ScrollBehavior behavior = "auto";
};
dictionary ScrollToOptions : ScrollOptions {
    unrestricted double left;
    unrestricted double top;
};

partial interface Window {
    [NewObject] MediaQueryList matchMedia(CSSOMString query);
    [SameObject, Replaceable] readonly attribute Screen screen;
    [SameObject, Replaceable] readonly attribute VisualViewport? visualViewport;

    // browsing context
    undefined moveTo(long x, long y);
    undefined moveBy(long x, long y);
    undefined resizeTo(long width, long height);
    undefined resizeBy(long x, long y);

    // viewport
    [Replaceable] readonly attribute long innerWidth;
    [Replaceable] readonly attribute long innerHeight;

    // viewport scrolling
    [Replaceable] readonly attribute double scrollX;
    [Replaceable] readonly attribute double pageXOffset;
    [Replaceable] readonly attribute double scrollY;
    [Replaceable] readonly attribute double pageYOffset;
    undefined scroll(optional ScrollToOptions options = {});
    undefined scroll(unrestricted double x, unrestricted double y);
    undefined scrollTo(optional ScrollToOptions options = {});
    undefined scrollTo(unrestricted double x, unrestricted double y);
    undefined scrollBy(optional ScrollToOptions options = {});
    undefined scrollBy(unrestricted double x, unrestricted double y);

    // client
    [Replaceable] readonly attribute long screenX;
    [Replaceable] readonly attribute long screenLeft;
    [Replaceable] readonly attribute long screenY;
    [Replaceable] readonly attribute long screenTop;
    [Replaceable] readonly attribute long outerWidth;
    [Replaceable] readonly attribute long outerHeight;
    [Replaceable] readonly attribute double devicePixelRatio;
};

メソッド matchMedia(query) が呼び出されたとき、次の手順を実行しなければならない：

1. Let parsed media query list be the result of parsing query.
2. 新しい MediaQueryList オブジェクトを返す。this の 関連付けられた Document をその document とし、 parsed media query list をその関連付けられた media query list とする。

screen 属性は、その Screen オブジェクトを 当該 Window オブジェクトに関連付けられたものとして返さなければならない。

注: screen に WindowProxy 経由でアクセスすると、Document がナビゲーションされたときに異なる結果を返す場合がある。

関連付けられた document が fully active であれば、visualViewport 属性は当該 VisualViewport オブジェクトを、当該 Window オブジェクトの 関連付けられた文書 に関連付けられたものとして返さなければならない。そうでなければ null を返す。

注: VisualViewport オブジェクトは、その Document が現在表示されているウィンドウに対してのみ返され有用である。 関連付けられた Document が現在表示されていない VisualViewport への参照が保持されている場合、その VisualViewport の値はブラウジングコンテキストに関する情報を明らかにしてはならない。

moveTo(x, y) メソッドは次の手順に従わなければならない：

1. 任意で、返す。

2. target を this の relevant global object の browsing context とする。

3. target がスクリプトによって作成された auxiliary browsing context でない場合（ユーザーの操作によって作成された場合など）、返す。

4. 任意で、ウィンドウが利用可能領域の外に移動しないように x と y をユーザーエージェント定義の方法でクランプする。

5. target のウィンドウの左上隅が出力デバイスの左上隅に対して座標 (x, y) になるようにウィンドウを移動させる。測定単位は CSS pixels で、正の軸は右方向と下方向である。

moveBy(x, y) メソッドは次の手順に従わなければならない：

1. 任意で、返す。

2. target を this の relevant global object の browsing context とする。

3. target がスクリプトによって作成された auxiliary browsing context でない場合、返す。

4. 任意で、ウィンドウが利用可能領域の外に移動しないように x と y をユーザーエージェント定義の方法でクランプする。

5. target のウィンドウを x だけ右方向に、y だけ下方向に移動する。単位は CSS pixels である。

resizeTo(width, height) メソッドは次の手順に従わなければならない：

1. 任意で、返す。

2. target を this の relevant global object の browsing context とする。

3. target がスクリプトによって作成された auxiliary browsing context でない場合、返す。

4. 任意で、ウィンドウが小さくなりすぎたり利用可能領域を超えたりしないように width と height をユーザーエージェント定義の方法でクランプする。

5. ビューポートの左端と右端の間の距離が width（CSS pixels）になり、上端と下端の間の距離が height（CSS pixels）になるように、右端と下端を動かして target のウィンドウをリサイズする。

6. 任意で、ウィンドウが利用可能領域の外に広がらないように移動するなどの処理をユーザーエージェント定義の方法で行う。

resizeBy(x, y) メソッドは次の手順に従わなければならない：

1. 任意で、返す。

2. target を this の relevant global object の browsing context とする。

3. target がスクリプトによって作成された auxiliary browsing context でない場合、返す。

4. 任意で、ウィンドウが小さくなりすぎたり利用可能領域を超えたりしないように x と y をユーザーエージェント定義の方法でクランプする。

5. target のウィンドウをリサイズする：右端を x（CSS pixels）だけ右方向に、下端を y（CSS pixels）だけ下方向に動かす。

6. 任意で、ウィンドウが利用可能領域の外に広がらないように移動するなどの処理をユーザーエージェント定義の方法で行う。

innerWidth 属性は、レンダリングされたスクロールバー（存在する場合）のサイズを含む ビューポート の幅を返さなければならない。ビューポートが存在しない場合はゼロを返す。

var viewportWidth = innerWidth

innerHeight 属性は、レンダリングされたスクロールバー（存在する場合）のサイズを含む ビューポート の高さを返さなければならない。ビューポートが存在しない場合はゼロを返す。

scrollX 属性は、初期包含ブロックの原点に対する x 座標で表した、initial containing block 原点を基準としたビューポートの左端の位置を返す。ビューポートが存在しない場合はゼロを返す。

pageXOffset 属性は、scrollX 属性が返す値を返さなければならない。

scrollY 属性は、初期包含ブロックの原点に対する y 座標で表した、initial containing block 原点を基準としたビューポートの上端の位置を返す。ビューポートが存在しない場合はゼロを返す。

pageYOffset 属性は、scrollY 属性が返す値を返さなければならない。

メソッド scroll() が呼び出されたとき、次の手順を実行しなければならない：

1. 引数が1つで呼び出された場合、次のサブステップに従う：

   1. options をその引数とする。

   2. x を、引数 options の left 辞書メンバーの値（存在する場合）とする。存在しない場合はビューポートの現在の x 軸方向のスクロール位置とする。

   3. y を、引数 options の top 辞書メンバーの値（存在する場合）とする。存在しない場合はビューポートの現在の y 軸方向のスクロール位置とする。

2. 引数が2つで呼び出された場合、次のサブステップに従う：

   1. options を null を 変換して ScrollToOptions 辞書とする。 [WEBIDL]

   2. x と y をそれぞれ引数とする。

3. 非有限値を正規化する を x と y に対して行う。

4. ビューポートが存在しない場合、これらの手順を中止する。

5. viewport width を、スクロールバーの幅（存在する場合）を除いたビューポートの幅とする。

6. viewport height を、スクロールバーの高さ（存在する場合）を除いたビューポートの高さとする。

7. ビューポートのオーバーフロード方向が右方向である場合

   x を max(0, min(x, ビューポートのスクロール領域幅 - viewport width)) にする。

   ビューポートのオーバーフロード方向が左方向である場合

   x を min(0, max(x, viewport width - ビューポートのスクロール領域幅)) にする。

8. ビューポートのオーバーフロード方向が下方向である場合

   y を max(0, min(y, ビューポートのスクロール領域高さ - viewport height)) にする。

   ビューポートのオーバーフロード方向が上方向である場合

   y を min(0, max(y, viewport height - ビューポートのスクロール領域高さ)) にする。

9. position を、ビューポートのスクロール領域の x 座標 x をビューポートの左に、y 座標 y をビューポートの上に合わせたときにビューポートが持つであろうスクロール位置とする。

10. position がビューポートの現在のスクロール位置と同じであり、かつビューポートに進行中の スムーズスクロール がなければ、これらの手順を中止する。

11. document をビューポートに関連付けられた Document とする。

12. スクロールを実行：ビューポートを position へ、 document の ルート要素 を関連付け要素（存在する場合）として、options の behavior 辞書メンバーの値をスクロール挙動として行う。

    ユーザーエージェント間で、この処理が（協調された）viewport の perform a scroll を使うべきか、あるいはレイアウトビューポートのスクロールボックスに対して perform a scroll を使うべきかで合意が得られていない。

メソッド scrollTo() が呼び出された場合、ユーザーエージェントは同じ引数で scroll() が呼び出されたかのように振る舞わなければならない。

メソッド scrollBy() が呼び出されたとき、ユーザーエージェントは次の手順を実行しなければならない：

1. 引数が2つで呼び出された場合、次のサブステップに従う：

   1. options を null を 変換して ScrollToOptions 辞書とする。 [WEBIDL]

   2. x と y をそれぞれ引数とする。

   3. options の left 辞書メンバーに値 x を設定する。

   4. options の top 辞書メンバーに値 y を設定する。

2. 非有限値を正規化する を left と top 辞書メンバーに対して行う。

3. scrollX の値を left 辞書メンバーに加える。

4. scrollY の値を top 辞書メンバーに加える。

5. その後、scroll() メソッドが options を唯一の引数として呼び出されたかのように振る舞う。

screenX および screenLeft 属性は、クライアントウィンドウの左端の位置を Web に公開されるスクリーン領域 の原点に対する x 座標として返さなければならない。単位は CSS pixels で、存在しない場合はゼロを返す。

screenY および screenTop 属性は、クライアントウィンドウの上端の位置を Web に公開されるスクリーン領域 の原点に対する y 座標として返さなければならない。単位は CSS pixels で、存在しない場合はゼロを返す。

outerWidth 属性はクライアントウィンドウの幅を返さなければならない。 クライアントウィンドウが存在しない場合はゼロを返す。

outerHeight 属性はクライアントウィンドウの高さを返さなければならない。 クライアントウィンドウが存在しない場合はゼロを返す。

devicePixelRatio 属性は、次の determine the device pixel ratio アルゴリズムの結果を返さなければならない：

1. 出力デバイスが存在しない場合、1 を返して手順を中止する。

2. CSS pixel size を、現在の page zoom での CSS pixel のサイズ（scale factor を 1.0 とした場合）とする。

3. device pixel size を、出力デバイスの垂直方向のデバイスピクセルのサイズとする。

4. CSS pixel size を device pixel size で割った結果を返す。

4.1. features 引数 — open() メソッドへの指定

HTML は open() メソッドを定義する。この節は features 引数で指定された位置およびサイズに関する振る舞いを定義する。[HTML]

ブラウジングコンテキスト機能を設定するには、 map 型の tokenizedFeatures が与えられたとき、ターゲットとなるブラウジングコンテキスト target に対して次を行う：

1. x を null にする。

2. y を null にする。

3. width を null にする。

4. height を null にする。

5. もし tokenizedFeatures["left"] が 存在するならば：

   1. x を tokenizedFeatures["left"] に対して 整数パース規則 を適用した結果に設定する。

   2. もし x がエラーなら、x を 0 に設定する。

   3. 任意で、ウィンドウが Web に公開される利用可能スクリーン領域 の外に移動しないように、 ユーザーエージェント定義の方法で x をクランプする。

   4. 任意で、target のウィンドウを移動し、ウィンドウの左端が Web に公開されるスクリーン領域 の左端に対して 水平座標 x に来るようにする。測定単位は CSS ピクセル（target の基準）である。正の軸は右方向である。

6. もし tokenizedFeatures["top"] が 存在するならば：

   1. y を tokenizedFeatures["top"] に対して 整数パース規則 を適用した結果に設定する。

   2. もし y がエラーなら、y を 0 に設定する。

   3. 任意で、ウィンドウが Web に公開される利用可能スクリーン領域 の外に移動しないように、 ユーザーエージェント定義の方法で y をクランプする。

   4. 任意で、target のウィンドウを移動し、ウィンドウの上端が Web に公開されるスクリーン領域 の上端に対して 垂直座標 y に来るようにする。測定単位は CSS ピクセル（target の基準）である。正の軸は下方向である。

7. もし tokenizedFeatures["width"] が 存在するならば：

   1. width を tokenizedFeatures["width"] に対して 整数パース規則 を適用した結果に設定する。

   2. もし width がエラーなら、width を 0 に設定する。

   3. もし width が 0 でないなら：

      1. 任意で、ウィンドウが小さくなりすぎたり Web に公開される利用可能スクリーン領域 より大きくならないように、 ユーザーエージェント定義の方法で width をクランプする。

      2. 任意で、target のウィンドウの右端を移動させ、ビューポートの左右端の間の距離が width CSS ピクセル になるようにウィンドウをサイズ変更する（target 基準）。

      3. 任意で、target のウィンドウが Web に公開される利用可能スクリーン領域 の外に広がらないようにユーザーエージェント定義の方法で移動する。

8. もし tokenizedFeatures["height"] が 存在するならば：

   1. height を tokenizedFeatures["height"] に対して 整数パース規則 を適用した結果に設定する。

   2. もし height がエラーなら、height を 0 に設定する。

   3. もし height が 0 でないなら：

      1. 任意で、ウィンドウが小さくなりすぎたり Web に公開される利用可能スクリーン領域 より大きくならないように、 ユーザーエージェント定義の方法で height をクランプする。

      2. 任意で、target のウィンドウの下端を移動させ、ビューポートの上下端の間の距離が height CSS ピクセル になるようにウィンドウをサイズ変更する（target 基準）。

      3. 任意で、target のウィンドウが Web に公開される利用可能スクリーン領域 の外に広がらないようにユーザーエージェント定義の方法で移動する。

サポートされる open() の機能名 は次のいずれかである：

width

ビューポートの幅。

height

ビューポートの高さ。

left

ウィンドウの左位置。

top

ウィンドウの上位置。

4.2. MediaQueryList インターフェイス

この節は HTML で定義される イベントループ と統合される。[HTML]

MediaQueryList オブジェクトは作成時に関連付けられた media query list と関連付けられた document を持つ。

MediaQueryList オブジェクトは関連付けられた media の 直列化 形式である media を持つ。

MediaQueryList オブジェクトは関連付けられた media query list がドキュメントの状態に一致するかどうかを示す matches state を持つ。 一致していれば true、そうでなければ false である。

メディアクエリを評価して変更を報告するよう要求されたとき、 ドキュメント Document doc について次の手順を実行する：

1. MediaQueryList オブジェクト target を、doc をその document として持つものすべてについて、 作成された順序（古い順）で、それぞれ次のサブステップを実行する：

   1. もし target の matches state が前回この手順を実行した時から変化しているなら、 イベントを発火する。 発火するイベント名は change で、対象は target、 使用するイベントは MediaQueryListEvent である。 その際、isTrusted 属性は true に初期化され、media 属性は target の media に、 matches 属性は target の matches state に初期化される。

function handleOrientationChange(event) {
    if(event.matches) // landscape
        …
    else
        …
}
var mql = matchMedia("(orientation:landscape)");
mql.onchange = handleOrientationChange;

[Exposed=Window]
interface MediaQueryList : EventTarget {
  readonly attribute CSSOMString media;
  readonly attribute boolean matches;
  undefined addListener(EventListener? callback);
  undefined removeListener(EventListener? callback);
           attribute EventHandler onchange;
};

media 属性は関連付けられた media を返さなければならない。

matches 属性は関連付けられた matches state を返さなければならない。

addListener(callback) メソッドが呼ばれたとき、 次の手順を実行しなければならない：

1. イベントリスナーを追加する：this を対象とし、タイプが change の イベントリスナー を追加し、そのコールバックに callback を使う。

removeListener(callback) メソッドが呼ばれたとき、 次の手順を実行しなければならない：

1. もし this の イベントリスナー一覧 が、タイプが change、 コールバックが callback、capture が false の イベントリスナー を含んでいるなら、 そのイベントリスナーを削除する（remove an event listener）。

注: 本仕様は当初、addListener() と removeListener() の専用コールバック機構を持ち、コールバックは関連付けられた MediaQueryList を引数として呼ばれていた。 現在は通常のイベント機構が使われる。 後方互換のため、addListener() および removeListener() はそれぞれ addEventListener() と removeEventListener() のエイリアスのように振る舞い、change イベントは MediaQueryList として偽装される。

次に示すのは イベントハンドラ（および対応する イベントハンドライベントタイプ）で、MediaQueryList インターフェイスを実装するすべてのオブジェクトが イベントハンドラ IDL 属性 としてサポートしなければならないものを示す：

[Exposed=Window]
interface MediaQueryListEvent : Event {
  constructor(CSSOMString type, optional MediaQueryListEventInit eventInitDict = {});
  readonly attribute CSSOMString media;
  readonly attribute boolean matches;
};

dictionary MediaQueryListEventInit : EventInit {
  CSSOMString media = "";
  boolean matches = false;
};

media 属性は初期化された値を返さなければならない。

matches 属性は初期化された値を返さなければならない。

4.2.1. イベント概要

この節は非規範的である。

4.3. Screen インターフェイス

名前が示すとおり、Screen インターフェイスは 出力デバイスのスクリーンに関する情報を表す。

[Exposed=Window]
interface Screen {
  readonly attribute long availWidth;
  readonly attribute long availHeight;
  readonly attribute long width;
  readonly attribute long height;
  readonly attribute unsigned long colorDepth;
  readonly attribute unsigned long pixelDepth;
};

availWidth 属性は Web に公開される利用可能スクリーン領域 の幅を返さなければならない。

availHeight 属性は Web に公開される利用可能スクリーン領域 の高さを返さなければならない。

width 属性は Web に公開されるスクリーン領域 の幅を返さなければならない。

height 属性は Web に公開されるスクリーン領域 の高さを返さなければならない。

colorDepth および pixelDepth 属性は、出力デバイスのピクセル当たりの色（アルファチャネルを除く）に割り当てられたビット数を返すべきである。 ユーザーエージェントが出力デバイスのビット数を返せない場合、フレームバッファや内部表現など、出力デバイスに最も近い推定値を返すべきである。 ユーザーエージェントはこれらの属性に対して、少なくとも color メディア機能の値を三倍した値以上を返さなければならない。 もし色の各成分が同じビット数で表現されていない場合、返される値は color メディア機能の三倍以上になることがあり得る。 プライバシー上の理由などで色深度を返せない場合、24 を返すべきである。

注: 互換性のために colorDepth と pixelDepth は同じ値を返す。

注: 一部の非準拠実装では 24 の代わりに 32 を返すことが知られている。

5. Document インターフェイスへの拡張

partial interface Document {
  Element? elementFromPoint(double x, double y);
  sequence<Element> elementsFromPoint(double x, double y);
  CaretPosition? caretPositionFromPoint(double x, double y, optional CaretPositionFromPointOptions options = {});
  readonly attribute Element? scrollingElement;
};

dictionary CaretPositionFromPointOptions {
  sequence<ShadowRoot> shadowRoots = [];
};

elementFromPoint(x, y) メソッドは以下の手順に従う必要があります：

1. いずれかの引数が負の場合、x がビューポートの幅（表示されたスクロールバーのサイズを除く）より大きい場合、または y が ビューポートの高さ（表示されたスクロールバーのサイズを除く）より大きい場合、または文書に関連付けられた ビューポート が存在しない場合は、null を返してこれらの手順を終了する。

2. ボックスが ビューポート内にあり、座標 x,y でヒットテストのターゲットとなる場合、 descendants of the ビューポート に適用される変形 を適用したときに、関連付けられた要素を返してこれらの手順を終了する。

3. 文書が ルート要素 を持つ場合は、ルート要素 を返してこれらの手順を終了する。

4. null を返す。

注: elementFromPoint() メソッドは必ずしも最上位に描画された要素を返すとは限りません。 例えば、pointer-events CSSプロパティを使うことで、要素がヒットテストのターゲットから除外されることがあります。

elementsFromPoint(x, y) メソッドは以下の手順に従う必要があります：

1. sequence を新しい空のシーケンスとして作成する。

2. いずれかの引数が負の場合、x が ビューポートの幅（表示されたスクロールバーのサイズを除く）より大きい場合、または y が ビューポートの高さ（表示されたスクロールバーのサイズを除く）より大きい場合、または文書に関連付けられた ビューポート が存在しない場合は、 sequence を返してこれらの手順を終了する。

3. ボックスごとに ビューポート内で、ペイント順で最上位から、座標 x,y で何も重なっていなくてもヒットテストのターゲットとなる場合、descendants of the ビューポート に適用される変形 を適用したときに、関連付けられた要素を sequence に追加する。

4. 文書が ルート要素 を持ち、sequence の最後の項目が ルート要素 でない場合、ルート要素 を sequence に追加する。

5. sequence を返す。

caretPositionFromPoint(x, y, options) メソッドは以下の手順を実行した結果を返す必要があります：

1. 文書に関連付けられた ビューポート が存在しない場合、null を返す。

2. いずれかの引数が負の場合、x が ビューポートの幅（表示されたスクロールバーのサイズを除く）より大きい場合、y が ビューポートの高さ（表示されたスクロールバーのサイズを除く）より大きい場合は null を返す。

3. 座標 x,y の ビューポートで、descendants of the ビューポート に適用される 変形 を適用したときに、テキスト挿入ポイントインジケーターが挿入されない場合、null を返す。

4. 座標 x,y の ビューポートで、テキスト挿入ポイントインジケーターがテキスト入力ウィジェット（かつ置換要素でもある）に挿入される場合、descendants of the ビューポート に適用される 変形 を適用したとき、以下のプロパティを設定した キャレット位置 を返す：

   キャレットノード

   テキスト入力ウィジェットに対応するノード。

   キャレットオフセット

   テキスト挿入ポイントインジケーターが挿入される位置の左側の16ビット単位の数。

5. それ以外の場合：

   1. caretPosition を、タプルとし、caretPositionNode（ノード）および caretPositionOffset（非負整数）から構成されます。これは、テキスト挿入ポイントインジケーターが transform を ビューポート の子孫に適用した場合に挿入される位置を示します。

   2. startNode を caretPosition の caretPositionNode に、startOffset を caretPosition の caretPositionOffset に設定する。

   3. startNode がノードであり、startNode の ルートがシャドウルートであり、さらに startNode の ルート が shadow-including inclusive ancestor でない場合、options["shadowRoots"] のいずれかについて、以下の手順を繰り返す：

      1. startOffset を index に、startNode の ルート の ホストに設定する。

      2. startNode を startNode の ルート の ホスト の 親に設定する。

   4. 以下のプロパティを設定した キャレット位置 を返す：

      1. キャレットノード を startNode に設定する。

      2. キャレットオフセット を startOffset に設定する。

注: この キャレット位置はライブではありません。

注: ヒットテストの詳細はこの仕様の範囲外であり、したがって elementFromPoint() や caretPositionFromPoint() の正確な詳細も範囲外です。ヒットテストは今後 CSS または HTML の改訂で定義される予定です。

scrollingElement 属性は、取得時に以下の手順を実行する必要があります：

1. Document が quirks モードの場合、以下のサブステップに従う：

   1. body 要素が存在し、かつ potentially scrollable でない場合、body 要素を返し、これらのステップを中止する。

      この目的のために、body 要素の親要素に overflow:clip が指定されている場合は、overflow:hidden として扱わなければならない。

   2. null を返し、これらのステップを中止する。

2. root 要素が存在する場合、root 要素を返し、これらのステップを中止する。

3. null を返す。

注記: scrollTop および scrollLeft に対して常に quirks モードの挙動を使用する非準拠なユーザーエージェントの場合、scrollingElement 属性も常に body 要素（存在しなければ null）を返すことが期待される。 この API は、Web 開発者が特定のユーザーエージェントの挙動を推測せずに、スクロール API に使うべき要素を取得できるように、またどの要素がビューポートをスクロールするかを判定するためにスクロールを発生させる必要がないように存在している。

注記: body 要素は HTML の document.body とは異なり、後者は frameset 要素を返す場合がある。

5.1. CaretPosition インターフェイス

caret positionは、テキスト挿入ポイントインジケーターの位置を表します。常に関連付けられたcaret nodeとcaret offsetを持ちます。これはCaretPosition オブジェクトによって表現されます。

[Exposed=Window]
interface CaretPosition {
  readonly attribute Node offsetNode;
  readonly attribute unsigned long offset;
  [NewObject] DOMRect? getClientRect();
};

offsetNode 属性は、caret nodeを返さなければならない。

offset 属性は、caret offsetを返さなければならない。

getClientRect() メソッドは、以下のステップに従い、最初に値を返すステップで中止する：

1. caret nodeが置換要素であるテキスト入力ウィジェットであり、かつそれがドキュメント内に存在する場合、ウィジェット内のキャレットに対応するscaled DOMRect オブジェクトをcaret offset値で返す。要素およびその祖先に適用されるtransformsを適用する。

2. それ以外の場合：

   1. caretRange を、start nodeおよびend nodeがcaret node、start offsetおよびend offsetがcaret offsetに設定された、collapsedな Range オブジェクトとする。

   2. caretRange に対して DOMRect オブジェクトを、getBoundingClientRect() メソッドを呼び出して返す。

注記: この DOMRect オブジェクトは live ではない。

6. Element インターフェイスの拡張

enum ScrollLogicalPosition { "start", "center", "end", "nearest" };
dictionary ScrollIntoViewOptions : ScrollOptions {
  ScrollLogicalPosition block = "start";
  ScrollLogicalPosition inline = "nearest";
  ScrollIntoViewContainer container = "all";
};

enum ScrollIntoViewContainer { "all", "nearest" };

dictionary CheckVisibilityOptions {
    boolean checkOpacity = false;
    boolean checkVisibilityCSS = false;
    boolean contentVisibilityAuto = false;
    boolean opacityProperty = false;
    boolean visibilityProperty = false;
};

partial interface Element {
  DOMRectList getClientRects();
  [NewObject] DOMRect getBoundingClientRect();

  boolean checkVisibility(optional CheckVisibilityOptions options = {});

  undefined scrollIntoView(optional (boolean or ScrollIntoViewOptions) arg = {});
  undefined scroll(optional ScrollToOptions options = {});
  undefined scroll(unrestricted double x, unrestricted double y);
  undefined scrollTo(optional ScrollToOptions options = {});
  undefined scrollTo(unrestricted double x, unrestricted double y);
  undefined scrollBy(optional ScrollToOptions options = {});
  undefined scrollBy(unrestricted double x, unrestricted double y);
  attribute unrestricted double scrollTop;
  attribute unrestricted double scrollLeft;
  readonly attribute long scrollWidth;
  readonly attribute long scrollHeight;
  readonly attribute long clientTop;
  readonly attribute long clientLeft;
  readonly attribute long clientWidth;
  readonly attribute long clientHeight;
  readonly attribute double currentCSSZoom;
};

注記: checkOpacity および checkVisibilityCSS プロパティは歴史的な名称です。これらのプロパティには新しい命名規則に合わせたエイリアスがあり、opacityProperty および visibilityProperty です。

getClientRects() メソッドが呼び出されたとき、以下のアルゴリズムの結果を返さなければならない：

1. 呼び出された要素に関連付けられたboxがない場合、空の DOMRectList オブジェクトを返し、このアルゴリズムを終了する。

2. 要素が関連付けられたSVGレイアウトボックスを持っている場合、SVG仕様で定義されるバウンディングボックスを記述する scaled DOMRectList オブジェクトを返す。このとき、要素および祖先に適用されるtransformsを適用する。

3. DOMRectList オブジェクトを返し、DOMRect オブジェクトをコンテンツ順で含める。各ボックスフラグメントごとに、そのborder領域（高さまたは幅が0の場合も含む）を記述し、以下の制約を適用する：

   • 要素および祖先に適用されるtransformsを適用する。

   • 呼び出された要素の display プロパティの算出値が table または inline-table の場合、テーブルボックスとキャプションボックス（存在する場合）を含め、匿名コンテナボックスは含めない。

   • 各匿名 ブロックボックスをその子ボックスで置き換え、最終リストに匿名ブロックボックスがなくなるまで繰り返す。

注記: DOMRect オブジェクトは getClientRects() によって返された場合、live ではない。

getBoundingClientRect() メソッドは、 要素 element 上で呼び出された場合、バウンディングボックスの取得 を element に対して実行した結果を返さなければならない。

注記: DOMRect オブジェクトは getBoundingClientRect() で返された場合、ライブ ではない。

var example = document.getElementsByTagName("div")[0].getBoundingClientRect();
var exampleWidth = example.width;
var exampleHeight = example.height;

scrollIntoView(arg) メソッドは、以下のステップを実行しなければならない：

1. behavior を "auto" にする。

2. block を "start" にする。

3. inline を "nearest" にする。

4. container を null にする。

5. arg が ScrollIntoViewOptions 辞書の場合、次を行う：

   1. behavior を options の behavior に設定する。

   2. block を options の block に設定する。

   3. inline を options の inline に設定する。

   4. options の container が "nearest" の場合、container をその要素に設定する。

6. それ以外で arg が false の場合、block を "end" に設定する。

7. 要素に関連する ボックス がない場合、 またはユーザーエージェントの機能で利用できない場合、何もせず return する。

8. 要素をビュー内へスクロール を behavior, block, inline, container で行う。

9. 必要に応じて、ユーザーの注意を引くための追加動作を行ってもよい。

<style>
    .scroller { overflow: auto; scroll-padding: 8px; }
    .slide { scroll-margin: 16px; scroll-snap-align: center; }
</style>
<div class="carousel">
    <div class="slides scroller">
        <div id="s1" class="slide">
        <div id="s2" class="slide">
        <div id="s3" class="slide">
    </div>
    <div class="markers">
        <button data-target="s1">1</button>
        <button data-target="s2">2</button>
        <button data-target="s3">3</button>
    </div>
</div>
<script>
    document.querySelector('.markers').addEventListener('click', (evt) => {
        const target = document.getElementById(evt.target.dataset.target);
        if (!target) return;
        // scrollIntoView は scroll-snap-align、scroll-margin、スクロールコンテナの scroll-padding を尊重してターゲット要素を正しく配置します。
        target.scrollIntoView({
            // 最も近いスクロールコンテナだけをスクロールします。
            container: 'nearest',
            behavior: 'smooth'
        });
    });
</script>

scroll() メソッドは次の手順を実行しなければならない：

1. 引数が1つの場合、以下のサブステップに従う：

   1. options を引数とする。

   2. options の left と top 辞書メンバー（存在する場合）に対して 非有限値の正規化 を行う。

   3. x を options の left 辞書メンバーの値（存在する場合）、 それ以外は要素の現在の x 軸スクロール位置とする。

   4. y を options の top 辞書メンバーの値（存在する場合）、 それ以外は要素の現在の y 軸スクロール位置とする。

2. 引数が2つの場合、以下のサブステップに従う：

   1. options を null 変換した ScrollToOptions 辞書とする。

   2. x、y をそれぞれ引数とする。

   3. x と y に対して 非有限値の正規化 を行う。

   4. options の left 辞書メンバーに x を設定する。

   5. options の top 辞書メンバーに y を設定する。

3. document を要素の ノード文書とする。

4. document が アクティブ文書でない場合、これらの手順を終了する。

5. window を document の defaultView 属性の値とする。

6. window が null の場合、これらの手順を終了する。

7. 要素が root 要素 かつ document が quirks モードの場合、これらの手順を終了する。

8. 要素が root 要素 の場合、window 上で scroll() を scrollX（第1引数）と y（第2引数）で呼び出し、これらの手順を終了する。

9. 要素が body 要素 かつ document が quirks モードかつ要素が potentially scrollable でない場合、window 上で scroll() を options を引数として呼び出し、これらの手順を終了する。

10. 要素に関連付けられた box がない場合、要素に関連付けられた scrolling box がない場合、または要素にオーバーフローがない場合、これらの手順を終了する。

11. 要素をスクロールし、x,y に移動する。スクロールの挙動は options の behavior 辞書メンバーの値とする。

scrollTo() メソッドが呼び出された場合、ユーザーエージェントは scroll() メソッドが同じ引数で呼び出されたかのように動作しなければならない。

scrollBy() メソッドが呼び出された場合、ユーザーエージェントは次の手順を実行しなければならない：

1. 引数が1つの場合、以下のサブステップに従う：

   1. options を引数とする。

   2. options の left と top 辞書メンバー（存在する場合）に対して 非有限値の正規化 を行う。

2. 引数が2つの場合、以下のサブステップに従う：

   1. options を null 変換した ScrollToOptions 辞書とする。

   2. x、y をそれぞれ引数とする。

   3. x と y に対して 非有限値の正規化 を行う。

   4. options の left 辞書メンバーに x を設定する。

   5. options の top 辞書メンバーに y を設定する。

3. scrollLeft の値を left 辞書メンバーに加算する。

4. scrollTop の値を top 辞書メンバーに加算する。

5. scroll() メソッドが options を唯一の引数として呼び出されたかのように動作する。

scrollTop 属性は、取得時に次の手順を実行した結果を返さなければならない：

1. document を要素の ノード文書とする。

2. document が アクティブ文書でない場合、0 を返しこれらの手順を終了する。

3. window を document の defaultView 属性の値とする。

4. window が null の場合、0 を返しこれらの手順を終了する。

5. 要素が root 要素 かつ document が quirks モード の場合、0 を返しこれらの手順を終了する。

6. 要素が root 要素 の場合、window の scrollY の値を返す。

7. 要素が body 要素 かつ document が quirks モード、かつ要素が potentially scrollable でない場合、window の scrollY の値を返す。

8. 要素に関連付けられた box がない場合、0 を返しこれらの手順を終了する。

9. 要素の scrolling area の y 座標（要素の padding edge の上端との揃え位置）を返す。

scrollTop 属性を設定する場合、次の手順を実行しなければならない：

1. y を与えられた値とする。

2. y に対して 非有限値の正規化 を行う。

3. document を要素の ノード文書とする。

4. document が アクティブ文書 でない場合、これらの手順を終了する。

5. window を document の defaultView 属性の値とする。

6. window が null の場合、これらの手順を終了する。

7. 要素が root 要素 かつ document が quirks モード の場合、これらの手順を終了する。

8. 要素が root 要素 の場合、window 上で scroll() を scrollX（第1引数）と y（第2引数）で呼び出し、これらの手順を終了する。

9. 要素が body 要素 かつ document が quirks モード、かつ要素が potentially scrollable でない場合、window 上で scroll() を scrollX（第1引数）と y（第2引数）で呼び出し、これらの手順を終了する。

10. 要素に関連付けられた box がない場合、要素に関連付けられた scrolling box がない場合、または要素にオーバーフローがない場合、これらの手順を終了する。

11. 要素をスクロールし、scrollLeft,y に移動する。スクロールの挙動は "auto" とする。

scrollLeft 属性は、取得時に以下の手順を実行した結果を返さなければならない：

1. document を要素の ノード文書とする。

2. document が アクティブ文書でない場合、0 を返してこれらの手順を終了する。

3. window を document の defaultView 属性の値とする。

4. window が null の場合、0 を返してこれらの手順を終了する。

5. 要素が root 要素 かつ document が quirks モードの場合、0 を返してこれらの手順を終了する。

6. 要素が root 要素 の場合、window の scrollX の値を返す。

7. 要素が body 要素であり、document が quirks モード、かつ要素が potentially scrollable でない場合、window の scrollX の値を返す。

8. 要素に関連付けられた box がない場合、0 を返してこれらの手順を終了する。

9. 要素の scrolling area の x 座標（要素の padding edge の左端との揃え位置）を返す。

scrollLeft 属性を設定する場合は、以下の手順を実行しなければならない：

1. x を与えられた値とする。

2. x に対して 非有限値の正規化 を行う。

3. document を要素の ノード文書とする。

4. document が アクティブ文書でない場合、これらの手順を終了する。

5. window を document の defaultView 属性の値とする。

6. window が null の場合、これらの手順を終了する。

7. 要素が root 要素 かつ document が quirks モードの場合、これらの手順を終了する。

8. 要素が root 要素 の場合、window 上で scroll() を第1引数 x、第2引数 window の scrollY の値で呼び出し、これらの手順を終了する。

9. 要素が body 要素であり、document が quirks モード、かつ要素が potentially scrollable でない場合、window 上で scroll() を第1引数 x、第2引数 window の scrollY の値で呼び出し、これらの手順を終了する。

10. 要素に関連付けられた box がない場合、要素に関連付けられた scrolling box がない場合、または要素にオーバーフローがない場合、これらの手順を終了する。

11. 要素をスクロールし、x,scrollTop に移動する。スクロールの挙動は "auto" とする。

scrollWidth 属性は、以下の手順を実行した結果を返さなければならない：

1. document を要素の ノード文書とする。

2. document が アクティブ文書でない場合、0 を返してこれらの手順を終了する。

3. viewport width を viewport の幅（スクロールバーの幅を除く。なければ0）とし、viewport がなければ0とする。

4. 要素が root 要素 かつ document が quirks モードでない場合、max(viewport の scrolling area の幅, viewport width) を返す。

5. 要素が body 要素であり、document が quirks モード、かつ要素が potentially scrollable でない場合、max(viewport の scrolling area の幅, viewport width) を返す。

6. 要素に関連付けられた box がない場合、0 を返してこれらの手順を終了する。

7. 要素の scrolling area の幅を返す。

scrollHeight 属性は、以下の手順を実行した結果を返さなければならない：

1. document を要素の ノード文書とする。

2. document が アクティブ文書でない場合、0 を返してこれらの手順を終了する。

3. viewport height を viewport の高さ（スクロールバーの高さを除く。なければ0）とし、viewport がなければ0とする。

4. 要素が root 要素 かつ document が quirks モードでない場合、max(viewport の scrolling area の高さ, viewport height) を返す。

5. 要素が body 要素であり、document が quirks モード、かつ要素が potentially scrollable でない場合、max(viewport の scrolling area の高さ, viewport height) を返す。

6. 要素に関連付けられた box がない場合、0 を返してこれらの手順を終了する。

7. 要素の scrolling area の高さを返す。

clientTop 属性は、以下の手順を実行しなければならない：

1. 要素に関連付けられた box がない、または box がインラインの場合、0 を返す。

2. unscaled な border-top-width プロパティの算出値に、上側の padding edge と上側の border edge の間にレンダリングされたスクロールバーの高さを加算した値を返す。要素および祖先に適用される transforms は無視する。

clientLeft 属性は、以下の手順を実行しなければならない：

1. 要素に関連付けられた box がない、または box がインラインの場合、0 を返す。

2. unscaled な border-left-width プロパティの算出値に、左側の padding edge と左側の border edge の間にレンダリングされたスクロールバーの幅を加算した値を返す。要素および祖先に適用される transforms は無視する。

clientWidth 属性は、以下の手順を実行しなければならない：

1. 要素に関連付けられた box がない、または box がインラインの場合、0 を返す。

2. 要素が root 要素 かつ要素の ノード文書 が quirks モードでない場合、または要素が body 要素であり、要素の ノード文書が quirks モードの場合、viewport の幅（スクロールバーのサイズを除く）を返す。

3. unscaled な padding edge の幅から、padding edge と border edge の間にレンダリングされたスクロールバーの幅を除いた値を返す。要素および祖先に適用される transforms は無視する。

clientHeight 属性は、以下の手順を実行しなければならない：

1. 要素に関連付けられた box がない、または box がインラインの場合、0 を返す。

2. 要素が root 要素 かつ要素の ノード文書 が quirks モードでない場合、または要素が body 要素であり、要素の ノード文書が quirks モードの場合、viewport の高さ（スクロールバーのサイズを除く）を返す。

3. unscaled な padding edge の高さから、padding edge と border edge の間にレンダリングされたスクロールバーの高さを除いた値を返す。要素および祖先に適用される transforms は無視する。

currentCSSZoom 属性は、要素の effective zoom を返す。要素が being rendered でない場合は 1.0 を返す。

6.1. Element スクロール関連メンバー

7. HTMLElement インターフェイスへの拡張

partial interface HTMLElement {
  readonly attribute Element? scrollParent;
  readonly attribute Element? offsetParent;
  readonly attribute long offsetTop;
  readonly attribute long offsetLeft;
  readonly attribute long offsetWidth;
  readonly attribute long offsetHeight;
};

scrollParent 属性は、以下の手順を実行した結果を返さなければならない：

1. 以下のいずれかに該当する場合、null を返し、このアルゴリズムを終了する：

   • 要素に関連付けられた box がない。

   • 要素が root 要素 である。

   • 要素が body 要素 である。

   • 要素の position プロパティの算出値が fixed であり、いずれの祖先も fixed 位置の containing block を確立しない場合。

2. ancestor を要素の containing block（フラットツリー内）とし、以下のサブステップを繰り返す：

   1. ancestor が 初期 containing block の場合、要素の文書の scrollingElement を返す。ただし、要素から closed-shadow-hidden であれば null を返す。

   2. ancestor が要素から closed-shadow-hidden でなく、かつ スクロールコンテナ である場合、このアルゴリズムを終了し ancestor を返す。

   3. ancestor の position プロパティの算出値が fixed であり、いずれの祖先も fixed 位置の containing block を確立しない場合、このアルゴリズムを終了し null を返す。

   4. ancestor を containing block（フラットツリー内）の ancestor とする。

offsetParent 属性は、以下の手順を実行した結果を返さなければならない：

1. 以下のいずれかに該当する場合、null を返し、このアルゴリズムを終了する：

   • 要素に関連付けられた box がない。

   • 要素が root 要素 である。

   • 要素が body 要素 である。

   • 要素の position プロパティの算出値が fixed であり、いずれの祖先も fixed 位置の containing block を確立しない場合。

2. ancestor を要素の フラットツリー内の親要素とし、以下のサブステップを繰り返す：

   1. ancestor が要素から closed-shadow-hidden であり、ancestor の position プロパティの算出値が fixed で、いずれの祖先も fixed 位置の containing block を確立しない場合、このアルゴリズムを終了し null を返す。

   2. ancestor が要素から closed-shadow-hidden でなく、かつ以下のいずれかを満たす場合、このアルゴリズムを終了し ancestor を返す。

      • 要素が fixed 位置の containing block 内にあり、ancestor が fixed 位置の子孫の containing block である。

      • 要素が fixed 位置の containing block 内にない場合、以下のいずれか：

        • ancestor が絶対位置の子孫の containing block である（絶対位置の子孫がいるかは問わない）。

        • ancestor が body 要素 である。

        • 要素の position プロパティの算出値が static であり、ancestor が次のいずれかの HTML 要素：td、th、または table。

      • 要素の effective zoom が ancestor と異なる。

   3. ancestor に フラットツリー内の親要素がもうない場合、このアルゴリズムを終了し null を返す。

   4. ancestor を フラットツリー内の ancestor の親要素とする。

offsetTop 属性は、以下の手順を実行した結果を返さなければならない：

1. 要素が body 要素であるか、関連付けられた box がない場合は 0 を返し、このアルゴリズムを終了する。

2. 要素の offsetParent が null の場合、要素に関連付けられた最初の border edge の y 座標（初期 containing block の原点に対する値、要素および祖先に適用される transforms を無視）を返し、このアルゴリズムを終了する。

3. 要素に関連付けられた最初の border edge の y 座標から、 offsetParent に関連付けられた最初の padding edge の y 座標を減算した unscaled な値を返す（初期 containing block の原点に対する値、要素および祖先に適用される transforms を無視）。

   注記: 複数の line box からなるインライン要素の場合、最初の box のみが考慮される。

offsetLeft 属性は、次の手順を実行した結果を返さなければならない：

1. 要素が body 要素であるか、関連付けられた box がなければ、0 を返してこのアルゴリズムを終了する。

2. 要素の offsetParent が null の場合、要素に関連付けられた最初の border edge の x 座標（初期 containing block の原点に対する値、要素および祖先に適用される transforms を無視）を返し、このアルゴリズムを終了する。

3. 要素に関連付けられた最初の border edge の x 座標から、 offsetParent に関連付けられた最初の padding edge の x 座標を減算した unscaled な値を返す（初期 containing block の原点に対する値、要素および祖先に適用される transforms を無視）。

offsetWidth 属性は、次の手順を実行した結果を返さなければならない：

1. 要素に関連付けられた box がなければ、0 を返してこのアルゴリズムを終了する。

2. 要素の principal box によって生成されたすべてのフラグメントの border box の軸揃えバウンディングボックスの unscaled な幅を返す。要素および祖先に適用される transforms は無視する。

   要素の principal box が inline-level box であり、block-level の子孫によって「分割」された場合、 block-level 子孫によって生成されたフラグメントも（幅または高さがゼロでない限り）含める。

offsetHeight 属性は、次の手順を実行した結果を返さなければならない：

1. 要素に関連付けられた box がなければ、0 を返してこのアルゴリズムを終了する。

2. 要素の principal box によって生成されたすべてのフラグメントの border box の軸揃えバウンディングボックスの unscaled な高さを返す。要素および祖先に適用される transforms は無視する。

   要素の principal box が inline-level box であり、block-level の子孫によって「分割」された場合、 block-level 子孫によって生成されたフラグメントも（幅または高さがゼロでない限り）含める。

8. HTMLImageElement インターフェイスへの拡張

partial interface HTMLImageElement {
  readonly attribute long x;
  readonly attribute long y;
};

x 属性は、取得時に、要素に関連付けられた最初の border edge の左端の scaled x 座標（初期 containing block の原点に対する値、要素および祖先に適用される transforms を無視）、または box がなければ 0 を返す。

y 属性は、取得時に、要素に関連付けられた最初の border edge の上端の scaled y 座標（初期 containing block の原点に対する値、要素および祖先に適用される transforms を無視）、または box がなければ 0 を返す。

9. Range インターフェイスへの拡張

partial interface Range {
  DOMRectList getClientRects();
  [NewObject] DOMRect getBoundingClientRect();
};

getClientRects() メソッドは、呼び出された場合、範囲が文書内にない場合は空の DOMRectList オブジェクトを返し、それ以外の場合は、以下の制約を満たす DOMRectList オブジェクト（内容順の DOMRect オブジェクトのリストを含む）を返す：

• 範囲で選択された各要素で、その親が範囲で選択されていない場合は、要素に対して getClientRects() を呼び出して返される border 領域を含める。

• 範囲で選択または部分選択された Text ノード（境界点が同じ場合も含む）については、選択された部分（行ボックス全体ではなく）のための scaled DOMRect オブジェクトを含める。これらの DOMRect オブジェクトの境界はフォントメトリクスを用いて算出される。つまり、水平書字の場合、各ボックスの垂直寸法はフォントのアセント・ディセントで、水平寸法はテキストの進行幅による。範囲が部分的な typographic character unit（例：サロゲートペアの半分やグラフクラスタの一部）を含む場合、対象となる typographic character unit 全体を境界算出に含めなければならない。[CSS-TEXT-3] 先祖に適用される transforms は適用される。

注記: DOMRect オブジェクトは getClientRects() で返された場合、ライブではない。

getBoundingClientRect() メソッドは、呼び出された場合、次のアルゴリズムの結果を返さなければならない：

1. list を、同じ範囲に対して getClientRects() を呼び出した結果とする。

2. list が空の場合、DOMRect オブジェクトを返す。その x、y、width、height メンバーは全てゼロとする。

3. list 内のすべての矩形が幅または高さがゼロの場合、list の最初の矩形を返す。

4. それ以外の場合、list 内の高さまたは幅がゼロでないすべての矩形を包含する最小の矩形を表す DOMRect オブジェクトを返す。

注記: DOMRect オブジェクトは getBoundingClientRect() で返された場合、ライブではない。

10. MouseEvent インターフェイスへの拡張

オブジェクト IDL フラグメントがいくつかのメンバーを再定義しています。これを何とか解決できないでしょうか？

partial interface MouseEvent {
  readonly attribute double screenX;
  readonly attribute double screenY;
  readonly attribute double pageX;
  readonly attribute double pageY;
  readonly attribute double clientX;
  readonly attribute double clientY;
  readonly attribute double x;
  readonly attribute double y;
  readonly attribute double offsetX;
  readonly attribute double offsetY;
};

partial dictionary MouseEventInit {
  double screenX = 0.0;
  double screenY = 0.0;
  double clientX = 0.0;
  double clientY = 0.0;
};

screenX 属性は、イベントが発生した位置の x 座標（Web-exposed screen area の原点に対する値）を返さなければならない。

screenY 属性は、イベントが発生した位置の y 座標（Web-exposed screen area の原点に対する値）を返さなければならない。

pageX 属性は、次の手順に従う：

1. イベントの dispatch flag が設定されている場合、イベント発生位置の水平方向座標（初期 containing block の原点に対する値）を返し、これらの手順を終了する。

2. offset をイベントの関連付けられた scrollX 属性の値（Window オブジェクトがあればその値、なければ 0）とする。

3. offset とイベントの clientX 属性の値の合計を返す。

pageY 属性は、次の手順に従う：

1. イベントの dispatch flag が設定されている場合、イベント発生位置の垂直方向座標（初期 containing block の原点に対する値）を返し、これらの手順を終了する。

2. offset をイベントの関連付けられた scrollY 属性の値（Window オブジェクトがあればその値、なければ 0）とする。

3. offset とイベントの clientY 属性の値の合計を返す。

clientX 属性は、イベントが発生した位置の x 座標（viewport の原点に対する値）を返す。

clientY 属性は、イベントが発生した位置の y 座標（viewport の原点に対する値）を返す。

x 属性は、clientX の値を返す。

y 属性は、clientY の値を返す。

offsetX 属性は、次の手順に従う：

1. イベントの dispatch flag が設定されている場合、イベント発生位置の x 座標（ターゲットノードの padding edge の原点に対する値、要素および祖先に適用される transforms を無視）を返し、これらの手順を終了する。

2. イベントの pageX 属性の値を返す。

offsetY 属性は、次の手順に従う：

1. イベントの dispatch flag が設定されている場合、イベント発生位置の y 座標（ターゲットノードの padding edge の原点に対する値、要素および祖先に適用される transforms を無視）を返し、これらの手順を終了する。

2. イベントの pageY 属性の値を返す。

11. ジオメトリ

11.1. GeometryUtils インターフェイス

enum CSSBoxType { "margin", "border", "padding", "content" };
dictionary BoxQuadOptions {
  CSSBoxType box = "border";
  GeometryNode relativeTo; // XXX default document (i.e. viewport)
};

dictionary ConvertCoordinateOptions {
  CSSBoxType fromBox = "border";
  CSSBoxType toBox = "border";
};

interface mixin GeometryUtils {
  sequence<DOMQuad> getBoxQuads(optional BoxQuadOptions options = {});
  DOMQuad convertQuadFromNode(DOMQuadInit quad, GeometryNode from, optional ConvertCoordinateOptions options = {});
  DOMQuad convertRectFromNode(DOMRectReadOnly rect, GeometryNode from, optional ConvertCoordinateOptions options = {});
  DOMPoint convertPointFromNode(DOMPointInit point, GeometryNode from, optional ConvertCoordinateOptions options = {}); // XXX z,w turns into 0
};

Text includes GeometryUtils; // like Range
Element includes GeometryUtils;
CSSPseudoElement includes GeometryUtils;
Document includes GeometryUtils;

typedef (Text or Element or CSSPseudoElement or Document) GeometryNode;

getBoxQuads(options) メソッドは、以下の手順を実行しなければならない：

1. DOM順序

   p1 = 常に左上（RTLでも）

   scaleが0の場合はゼロ除算となり、0x0を返す

   クロスフレームは禁止、WrongDocumentErrorを投げる？

   点は平坦化される（3D変換）、z=0。getClientRectと同様

   インライン内のブロックテスト

   疑似要素のbefore/afterは要素の子になる

   ビューポートボックスはすべて同じ

convertQuadFromNode(quad, from, options) メソッドは、以下の手順を実行しなければならない：

1. ...

convertRectFromNode(rect, from, options) メソッドは、以下の手順を実行しなければならない：

1. ...

convertPointFromNode(point, from, options) メソッドは、以下の手順を実行しなければならない：

1. ...

12. VisualViewport

12.1. VisualViewport インターフェイス

[Exposed=Window]
interface VisualViewport : EventTarget {
  readonly attribute double offsetLeft;
  readonly attribute double offsetTop;

  readonly attribute double pageLeft;
  readonly attribute double pageTop;

  readonly attribute double width;
  readonly attribute double height;

  readonly attribute double scale;

  attribute EventHandler onresize;
  attribute EventHandler onscroll;
  attribute EventHandler onscrollend;
};

offsetLeft 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返す。

2. それ以外の場合、visual viewport の左端が layout viewport の左端からどれだけずれているかを返す。

offsetTop 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返す。

2. それ以外の場合、visual viewport の上端が layout viewport の上端からどれだけずれているかを返す。

pageLeft 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返す。

2. それ以外の場合、visual viewport の左端が 初期 containing block（layout viewport の document）の左端からどれだけずれているかを返す。

pageTop 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返す。

2. それ以外の場合、visual viewport の上端が 初期 containing block（layout viewport の document）の上端からどれだけずれているかを返す。

width 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返す。

2. それ以外の場合、visual viewport の幅（視覚ビューポートに固定された縦方向の クラシックスクロールバー の幅を除いた値）を返す。

注記: この値はCSSピクセル単位で返されるため、ページズームやスケールファクターを上げると値の大きさは減少する。

注記: 視覚ビューポートに固定されたスクロールバーは、ズームやパンをしてもサイズや位置が変わらないものを指す。この値はCSSピクセル単位のため、スクロールバー幅を除外する際、UAはCSSピクセルで測定されるスクロールバーの大きさを考慮する必要がある。つまり、ズームイン時には除かれる量が減り、ズームアウト時には増える。

height 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返す。

2. それ以外の場合、visual viewport の高さ（視覚ビューポートに固定された横方向の クラシックスクロールバー の高さを除いた値）を返す。

scale 属性は、以下の手順を実行しなければならない：

1. visual viewport の 関連文書 が 完全にアクティブでない場合、0 を返し、これらの手順を中断する。

2. 出力デバイスがない場合、1 を返し、これらの手順を中断する。

3. それ以外の場合、visual viewport の スケールファクター を返す。

onresize は、イベントハンドラーIDL属性であり、resize イベント用である。

onscroll は、イベントハンドラーIDL属性であり、scroll イベント用である。

onscrollend は、イベントハンドラーIDL属性であり、scrollend イベント用である。

13. イベント

13.1. ビューポートのリサイズ

この節は、HTMLで定義されている イベントループ と統合される。[HTML]

Document doc に対して resize 手順を実行するよう求められた場合、以下の手順を実行する：

1. doc の viewport の幅または高さが前回これらの手順が実行された時点から変更された場合 （例：ユーザーがブラウザーウィンドウのサイズを変更した場合、 ページズームを変更した場合、 iframe 要素の寸法が変更された場合など）、 doc に関連付けられている Window オブジェクトで resize という名前のイベントを発火する。

2. doc に関連付けられている VisualViewport の scale、width、または height プロパティのいずれかが 前回これらの手順が実行された時点から変更された場合、 VisualViewport で resize という名前のイベントを発火する。

13.2. スクロール

このセクションは、HTML で定義されている イベントループ と統合されます。[HTML]

各 Document には、空の 保留中スクロールイベントターゲット のリストが関連付けられています（初期値は空）。

各 Document には、空の 保留中スクロールエンドイベントターゲット のリストが関連付けられています（初期値は空）。

ビューポートがスクロールされたとき（ユーザー操作または API により）、ユーザーエージェントは以下の手順を実行しなければなりません：

1. doc を ビューポート に関連付けられた Document とします。

2. doc が スナップコンテナ の場合、 doc の eventual snap target（ブロック軸を newBlockTarget、インライン軸を newInlineTarget）で scrollsnapchanging ターゲットの更新手順を実行する。

3. doc がすでに自身の 保留中スクロールイベントターゲット に含まれていたら、これらの手順を中止する。

4. doc を自身の 保留中スクロールイベントターゲット に追加する。

要素がスクロールされたとき（ユーザー操作または API により）、ユーザーエージェントは以下の手順を実行しなければなりません：

1. doc を要素の ノード文書 とします。

2. 要素が スナップコンテナ の場合、 要素の eventual snap target（ブロック軸を newBlockTarget、インライン軸を newInlineTarget）で scrollsnapchanging ターゲットの更新手順を実行する。

3. 要素がすでに doc の 保留中スクロールイベントターゲット に含まれていたら、これらの手順を中止する。

4. 要素を doc の 保留中スクロールイベントターゲット に追加する。

VisualViewport がスクロールされたとき（ユーザー操作または API により）、ユーザーエージェントは以下の手順を実行しなければなりません：

1. vv をスクロールされた VisualViewport オブジェクトとします。

2. doc を vv の 関連付けられている文書 とします。

3. vv がすでに doc の 保留中スクロールイベントターゲット に含まれていたら、これらの手順を中止する。

4. vv を doc の 保留中スクロールイベントターゲット に追加する。

スクロール手順を実行するために Document doc に対して、以下の手順を実行する：

1. 保留中の scrollsnapchanging イベントの dispatch 手順 を doc に対して実行する。

2. doc の 保留中スクロールイベントターゲット の各アイテム target について、追加順に次のサブステップを実行する：

   1. target が Document の場合、 スクロール（scroll）イベントを target でバブルさせて発火する。

   2. それ以外の場合、スクロール（scroll）イベントを target で発火する。

3. doc の 保留中スクロールイベントターゲット を空にする。

4. 保留中の scrollsnapchange イベントの dispatch 手順 を doc に対して実行する。

スクロールが 完了したとき、ユーザーエージェントは以下の手順を実行しなければなりません：

scrollend イベントはどの順序で dispatch されるか？スクロール開始順か、完了順か？

1. スクロールされた各スクロールボックス box について：

   1. box が ビューポート に属する場合は、 doc を ビューポート に関連付けられる Document、 target を ビューポートとする。 box が VisualViewport に属する場合は、 doc を VisualViewport の 関連付けられている文書、 target を VisualViewport とする。 それ以外の場合、box は要素に属するので doc を要素の ノード文書、target をその要素とする。

   2. box が スナップコンテナ snapcontainer に属する場合は、 snapcontainer に対して scrollsnapchange ターゲットの更新手順を実行する。

   3. target が doc の 保留中スクロールエンドイベントターゲット にすでに含まれていたら、これらの手順を中止する。

   4. target を doc の 保留中スクロールエンドイベントターゲット に追加する。

2. doc に対して 保留中 scrollsnapchange ターゲットの dispatch 手順 を実行する。

3. doc の 保留中スクロールエンドイベントターゲット の各アイテム target について、追加順に次のサブステップを実行する：

   1. target が Document の場合、 scrollend（スクロールエンド）イベントを target でバブルさせて発火する。

   2. それ以外の場合、scrollend（スクロールエンド）イベントを target で発火する。

4. doc の 保留中スクロールエンドイベントターゲット を空にする。

13.3. イベントサマリー

このセクションは規範的ではありません。

14. レイアウト後の状態スナップショット

一部の CSS 機能は、スクロール位置などのレイアウト後の状態を次のスタイルやレイアウトの更新の入力として利用します。

レイアウト後の状態スナップショット手順を実行するために Document doc に対して、以下の手順を実行する：

1. レイアウト後の状態をスナップショットする必要がある各 CSS 機能について、doc の関連する状態のスナップショットを取得する。

スナップショットされる状態は他の仕様で定義されています。これらの手順は doc や他の Document に対して、他のレイアウト後スナップショット手順がスナップショットが行われたことを検知できるような無効化をしてはなりません。つまり、スナップショットの順序は問題になりません。

15. プライバシーに関する考慮事項

Screen インターフェイスはユーザーのディスプレイ構成情報を公開します。これはフィンガープリントアルゴリズムへの入力として使われる可能性があります。ユーザーエージェントは、ユーザーのプライバシーを保護するために、画面サイズや構成の情報を隠したり量子化したりすることを選択できます。

MouseEvent は、イベントのスクリーン相対座標の情報を含みます。ユーザーエージェントは、ユーザーのプライバシー保護のために、これらのプロパティに実際のスクリーン位置を隠す値を設定することがあります。

16. セキュリティに関する考慮事項

この仕様に関して新たなセキュリティ上の考慮事項は報告されていません。

17. 変更履歴

このセクションでは本仕様の版間の主な変更点を記載します。網羅的な内容ではありません。バグ修正や編集上の変更は通常記載されません。

2016年3月17日作業草案 からの変更点

• Simon Fraser と Emilio Cobos Álvarez を現編集者に追加し、Simon Pieters を前編集者へ移動しました。

• getClientRects() で 組版文字単位の扱いを明確化しました。

• getBoundingClientRect() （Element 用）および getBoundingClientRect() （Range 用）が空矩形をどう扱うか変更しました。

• Shadow DOM に対する offsetParent の定義を変更しました。

• プライバシー保護のため Screen のプロパティについてUAが偽装できることを認めました。

• colorDepth と pixelDepth が実値を返すよう変更しました。

• 「CSSピクセル」を [CSS-VALUES] に準拠させました。

• ScrollIntoViewOptions のデフォルト値を start と nearest に変更し、scrollIntoView() の挙動も微調整しました。

• screenLeft と screenTop を screenX および screenY のエイリアスとして追加しました。

• オーバーフロー方向の定義を block-end および inline-end に基づいて行うよう変更しました。

• resizeTo() の引数名を width と height に変更しました。

• スクリプトによる scroll-snap を scroll-behavior の影響を受けるスクロールの一覧に追加しました。

• 用語セクションの論理的な誤りを修正しました。

• 「セキュリティに関する考慮事項」と「プライバシーに関する考慮事項」セクションを追加しました。

• scroll-behavior プロパティを [CSS-OVERFLOW-3] に移動しました。

• offsetWidth と offsetHeight のアルゴリズムを調整しました。

• checkVisibility() メソッドを Element に追加しました。

• scrollend イベントを WICG overscroll-scrollend-events から [CSSOM-VIEW-1] に移動し、ハンドリングの詳細を追加しました。

• getBoundingClientRect() に「バウンディングボックス取得」アルゴリズムを追加しました。

• VisualViewport API と関連概念を導入しました。

• scroll into view のアルゴリズムを Range にも対応させました。

• 各 API が zoom プロパティに関連して、スケール値か非スケール値かを明確化しました。

• 各種スクロールAPIでスクロールスナップとスクロールターゲットを考慮するようにしました。

• currentCSSZoom 属性を Element に追加しました。

• caretPositionFromPoint() メソッドに options パラメータを追加しました。

• CaretPosition インターフェイスからキャレット範囲の概念を削除しました。

• レイアウト後スナップショットを定義しました。

• 各種スクロールアルゴリズムで疑似要素も受け付けるようにしました。

• container オプションを ScrollIntoViewOptions に追加しました。

• scrollParent 属性を追加しました。

• ピンチズームを scale factor に名称変更しました。

2013年12月17日作業草案 からの変更点

• scrollIntoView() メソッドが Element で変更・拡張されました。

• scrollTop および scrollLeft 属性がオブジェクトを受け取らなくなりました。代わりに scroll()、 scrollTo()、 scrollBy() メソッドが追加されました。

• scrollWidth、 scrollHeight、 clientTop、 clientLeft、 clientWidth、 clientHeight 属性が Element で再び整数値を返すようになりました。

• DOMRectList インターフェイスが削除されました。

• scrollingElement 属性が Document に追加されました。

• Window の一部 readonly 属性に [Replaceable] IDL 拡張属性が付与されました。

• MediaQueryList、 scroll イベント、 resize イベントが HTML の イベントループ と統合され、アニメーションフレームと同期されるようになりました。

• scroll-behavior の instant 値が auto に名称変更されました。

• scrollLeft の原点（RTL対応）が変更されました。

• scrollIntoView() （Element）や scroll()、 scrollTo()、 scrollBy() メソッド（Window 用）が関連辞書を第1引数として受け取るようになりました。

• MediaQueryList インターフェイスが通常のイベントAPIを使用し、addListener() の定義がそれに基づくものへ変更されました。

• 「変更履歴」セクションを追加しました。

• Glenn Adams を前編集者へ移動しました。

2011年8月4日作業草案以降の変更点 （英語原文）

• Simon Pieters と Glenn Adams を編集者として追加し、Anne van Kesteren を前編集者に移動しました。

• scroll-behavior CSSプロパティを導入しました。

• ブロックフロー方向 と インライン基底方向（[CSS-WRITING-MODES-3]）を用語集に追加しました。

• ズームに関するセクションを追加しました。

• moveTo()、 moveBy()、 resizeTo()、 resizeBy() を Window インターフェイスに追加しました。

• devicePixelRatio 属性を Window インターフェイスに追加しました。

• ScrollOptions 辞書を導入し、スクロールメソッドに options パラメータを追加しました。

• devicePixelRatio 属性を Window インターフェイスに追加しました。

• open() メソッドに features パラメータを追加しました。

• elementsFromPoint() メソッドを Document インターフェイスに追加しました。

• getClientRect() メソッドを CaretPosition インターフェイスに追加しました。

• GeometryUtils インターフェイスの初期ドラフトを導入しました。

• innerWidth、 innerHeight などで double 型を使うようにしました。

• CSS transform を正式に認識しました。

• ClientRect を DOMRect に置き換えました。

• scroll および resize イベントの発火挙動を定義しました。

• colorDepth と pixelDepth が常に 24 を返すように変更しました。

2009年8月4日作業草案以降の変更点 （英語原文）

• 他仕様の用語定義の重複を削除し、単位（CSSピクセルなど）や内容／文書内容の区別を明示的に定義しました。

• MediaQueryList インターフェイスを導入しました。

• Media の matchMedium() メソッドを Window インターフェイスに移動し、matchMedia() に名称変更、戻り値型を MediaQueryList に変更しました。

• AbstractView と Media インターフェイスを削除しました。

• DocumentView インターフェイスを削除し、elementFromPoint() メソッドと caretRangeFromPoint() メソッドを Document インターフェイスへ移動しました。

• caretRangeFromPoint() メソッドの名称を caretPositionFromPoint() に変更しました。

• CaretPosition インターフェイスを導入し、caretPositionFromPoint() の戻り値型を CaretPosition に変更しました。

• scrollIntoView() メソッドを Element インターフェイスに追加しました。

2008年2月22日作業草案以降の変更点 （英語原文）

• WindowView インターフェイスを削除し、その属性とメソッドを AbstractView と継承する ScreenView インターフェイスに移動しました。

• AbstractView に document IDL属性を追加しました。

• scroll()、 scrollTo()、 scrollBy() メソッドを ScreenView インターフェイスに追加しました。

• ElementView インターフェイスを削除し、その属性とメソッドを Element および HTMLElement インターフェイスに移動しました。

• defaultView IDL属性と caretRangeFromPoint() メソッドを DocumentView インターフェイスに追加しました。

• RangeView インターフェイスを削除し、代わりに Range インターフェイスを直接拡張しました。

• MouseEventView インターフェイスを削除し、代わりに MouseEvent インターフェイスを直接拡張しました。

• TextRectangleList インターフェイスを ClientRectList に名称変更し、item() メソッドをインデックスゲッターにしました。

• TextRectangle インターフェイスを ClientRect に名称変更し、width および height 属性を追加しました。

18. 謝辞

編集者は、Alan Stearns、Alexey Feldgendler、Antonio Gomes、Björn Höhrmann、Boris Zbarsky、Chris Rebert、Corey Farwell、Dan Bates、David Vest、Elliott Sprehn、Garrett Smith、Henrik Andersson、Hallvord R. M. Steen、Kang-Hao Lu、Koji Ishii、Leif Arne Storset、Luiz Agostini、Maciej Stachowiak、Michael Dyck、Mike Wilson、Morten Stenshorne、Olli Pettay、Pavel Curtis、Peter-Paul Koch、Rachel Kmetz、Rick Byers、Robert O’Callahan、Sam Weinig、Scott Johnson、Sebastian Zartner、Stewart Brodie、Sylvain Galineau、Tab Atkins、Tarquin Wilton-Jones、Thomas Moore、Thomas Shinnick、Xiaomei Ji の本ドキュメントへの貢献に感謝します。

特に、Microsoftの社員の皆様には、本ドラフトで規定された多くの機能を最初に実装し、それがWindows Internet Explorerブラウザーで広く展開されたことに感謝します。