HTMLElement: containerTiming プロパティ
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
もっと多くのブラウザーがこの機能に対応してほしいですか? 理由を教えてください。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
containerTiming は HTMLElement インターフェイスのプロパティで、この要素を コンテナータイミング API による観測対象のコンテナールートとしてマークします。
containerTiming プロパティは containertiming 属性の値を反映します。
プロパティを設定すると属性が追加され、要素はコンテナールートになります。要素がすでに文書内にある場合、それ以降の描画だけが要素のタイミング計測に寄与します。
値
文字列です。
属性が設定されていない場合は空文字列 ("") です。
例
>containerTiming の値をログに記録する
この例では、<section> 要素に containertiming 属性を追加することで、その要素をコンテナールートとして設定します。
html
<section containertiming="hero" id="hero-section">
<!-- ... -->
</section>
次に、プロパティを読み取り、その値をログに記録できます。
js
const el = document.getElementById("hero-section");
console.log(el.containerTiming); // "hero"
タイミング情報を取得するためにコンテナータイミング API を使用する例については、PerformanceContainerTiming を参照してください。
仕様書
| 仕様書 |
|---|
| Container Timing API> # dom-htmlelement-containertiming> |