MDN self-hosted library · e01.org

AnimationTimeline: duration property

Web Animations

Open notebook · 3 cells web-api-instance-property upstream source

Web Animations

The duration read-only property of the Web Animations API's AnimationTimeline interface returns the maximum value for this timeline or null.

Note that the derived interfaces ViewTimeline and ScrollTimeline always return a duration of 100%, while 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 ViewTimeline always returns a duration of 100% as a CSSUnitValue.

const subject = document.querySelector(".subject");
const timeline = new ViewTimeline({
  subject,
  axis: "block",
});

timeline.duration; // CSSUnitValue { value: 100, unit: "percent" }

Scroll timeline duration

The ScrollTimeline always returns a duration of 100% as a CSSUnitValue.

const timeline = new ScrollTimeline({
  source: document.documentElement,
  axis: "block",
});

timeline.duration; // CSSUnitValue { value: 100, unit: "percent" }

Document timeline duration

The DocumentTimeline has no duration.

document.timeline.duration; // null

Specifications

Browser compatibility

See also

  • Web Animations API
  • AnimationTimeline
  • DocumentTimeline inherits this property
  • ScrollTimeline inherits this property
  • ViewTimeline inherits this property