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

View in English Always switch to English

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

ブラウザーの互換性

関連情報