このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

containertiming グローバル属性

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

もっと多くのブラウザーがこの機能に対応してほしいですか? 理由を教えてください。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

containertiming グローバル属性 は、要素を「コンテナールート」としてマークします。PerformanceObserver オブジェクトで "container" 型を使用すると、そのコンテナールートの PerformanceContainerTiming パフォーマンス項目を観測できます。

コンテナールートのサブツリー内の新しい領域への描画は、コンテナーのタイミング計測に寄与します。 コンテナールート自体の内側に描画されたコンテンツや、すでに描画された領域への再描画は対象外です。 タイミング項目は、ユーザーがページをスクロールするか操作するまでの間だけ報告されます。 子孫要素のサブツリーは、containertimingignore 属性を使用して、コンテナーのタイミング計測から除外できます。 詳しくは、PerformanceContainerTiming インターフェイスを参照してください。

DOM では、この属性は HTMLElement.containerTiming として反映されます。

値

コンテナーを識別する文字列です。 この値は PerformanceContainerTiming.identifier で返されます。

例

コンテナールートをマークする

この例では、2 つの要素をコンテナールートとしてマークし、それぞれ "hero" と "product-list" で識別します。

html
<section containertiming="hero">
  <h1>ようこそ</h1>
  <img src="hero.jpg" alt="" />
</section>

<div containertiming="product-list">
  <!-- 商品カード -->
</div>

仕様書

仕様書
Container Timing API
# dom-htmlelement-containertiming

ブラウザーの互換性

関連情報