大网数据广告活动
Web 标准与前端开发

DocumentTimeline: DocumentTimeline() constructor

· 52CE 我爱测

The **`DocumentTimeline()`** constructor of the Web Animations API creates a new instance of the DocumentTimeline object associated with the active document of the current browsing context.

Web Animations

The DocumentTimeline() constructor of the Web Animations API creates a new instance of the DocumentTimeline object associated with the active document of the current browsing context.

Syntax

new DocumentTimeline(options)

Parameters

  • options
    • : An object specifying options for the new timeline. The following properties are available:
      • originTime
        • : A number that specifies the zero time for the DocumentTimeline as a number of milliseconds relative to Performance.timeOrigin. Defaults to 0.

Examples

Origin time

A DocumentTimeline with an originTime of zero counts time starting from Performance.timeOrigin. This is the same behavior as Document.timeline.

const timeline = new DocumentTimeline();
console.log(timeline.currentTime === document.timeline.currentTime); // true

Setting a non-zero originTime will offset the DocumentTimeline from Document.timeline by that amount:

const offsetTimeline = new DocumentTimeline({ originTime: 500 });
console.log(document.timeline.currentTime - offsetTimeline.currentTime); // 500

A DocumentTimeline relative to the current moment can be constructed with:

const nowTimeline = new DocumentTimeline({
  originTime: document.timeline.currentTime,
});
console.log(nowTimeline.currentTime); // 0

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。