HTMLElement: containerTiming property

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}{{SeeCompatTable}}

The **containerTiming** property of the {{domxref("HTMLElement")}} interface marks the element as a container root for observation in the Container Timing API.

The containerTiming property reflects the value of the [containertiming](/en-US/docs/Web/HTML/Reference/Global_attributes/containertiming) attribute. Setting the property adds the attribute, making the element a container root: if the element is already in the document, only subsequent paints contribute to its timing.

Value

A string. This is the empty string ("") if the attribute isn't set.

Examples

Logging the value of containerTiming

In this example, adding the [containertiming](/en-US/docs/Web/HTML/Reference/Global_attributes/containertiming) attribute to the {{htmlelement("section")}} element sets it up as a container root.

html
<section containertiming="hero" id="hero-section">
  <!-- ... -->
</section>

We can then read the property and log its value:

js
const el = document.getElementById("hero-section");
console.log(el.containerTiming); // "hero"

For examples of how to use the Container Timing API to get timing information, see {{domxref("PerformanceContainerTiming")}}.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("PerformanceContainerTiming")}}
  • [containertiming](/en-US/docs/Web/HTML/Reference/Global_attributes/containertiming) HTML attribute
  • {{domxref("HTMLElement.containerTimingIgnore")}}