DocumentTimeline: DocumentTimeline() コンストラクター
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年7月以降、すべてのブラウザーで利用可能です。
DocumentTimeline() はウェブアニメーション API のコンストラクターで、現在の閲覧コンテキストのアクティブな文書に関連付けられた DocumentTimeline オブジェクトの新しいインスタンスを作成します。
構文
js
new DocumentTimeline(options)
引数
options省略可-
新しいタイムラインのオプションを指定します。以下のプロパティが利用できます。
originTime省略可-
数値で、
DocumentTimelineのゼロ時刻を、Performance.timeOrigin関連のミリ秒数で指定します。 既定値は0です。
例
原点時刻
originTime が 0 の DocumentTimeline は Performance.timeOrigin から始まる時刻をカウントします。これは Document.timeline と同じ動作です。
js
const timeline = new DocumentTimeline();
console.log(timeline.currentTime === document.timeline.currentTime); // true
0 以外の originTime を設定すると、Document.timeline からDocumentTimeline をその分だけずらします。
js
const offsetTimeline = new DocumentTimeline({ originTime: 500 });
console.log(document.timeline.currentTime - offsetTimeline.currentTime); // 500
現在の瞬間に対して相対的な DocumentTimeline を構築することができます。
js
const nowTimeline = new DocumentTimeline({
originTime: document.timeline.currentTime,
});
console.log(nowTimeline.currentTime); // 0
仕様書
| 仕様書 |
|---|
| Web Animations # dom-documenttimeline-documenttimeline |