AnimationTimeline: duration property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{ APIRef("Web Animations") }}
The **duration** read-only property of the Web Animations API's {{domxref("AnimationTimeline")}} interface returns the maximum value for this timeline or null.
Note that the derived interfaces {{domxref("ViewTimeline")}} and {{domxref("ScrollTimeline")}} always return a duration of 100%, while {{domxref("DocumentTimeline")}} has no duration, and returns null.
Value
A number representing the timeline's duration (the maximum value for this timeline) or null.
Examples
View timeline duration
The {{domxref("ViewTimeline")}} always returns a duration of 100% as a {{domxref("CSSUnitValue")}}.
const subject = document.querySelector(".subject");
const timeline = new ViewTimeline({
subject,
axis: "block",
});
timeline.duration; // CSSUnitValue { value: 100, unit: "percent" }Scroll timeline duration
The {{domxref("ScrollTimeline")}} always returns a duration of 100% as a {{domxref("CSSUnitValue")}}.
const timeline = new ScrollTimeline({
source: document.documentElement,
axis: "block",
});
timeline.duration; // CSSUnitValue { value: 100, unit: "percent" }Document timeline duration
The {{domxref("DocumentTimeline")}} has no duration.
document.timeline.duration; // nullSpecifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Web Animations API
- {{domxref("AnimationTimeline")}}
- {{domxref("DocumentTimeline")}} inherits this property
- {{domxref("ScrollTimeline")}} inherits this property
- {{domxref("ViewTimeline")}} inherits this property