DocumentTimeline: DocumentTimeline() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.

Der DocumentTimeline() Konstruktor der Web Animations API erstellt eine neue Instanz des DocumentTimeline-Objekts, das mit dem aktiven Dokument des aktuellen Browsing-Kontexts verbunden ist.

Syntax

js
new DocumentTimeline(options)

Parameter

options Optional

Ein Objekt, das Optionen für die neue Timeline angibt. Die folgenden Eigenschaften sind verfügbar:

originTime Optional

Eine number, die die Nullzeit für die DocumentTimeline als Anzahl von Millisekunden relativ zu Performance.timeOrigin angibt. Standardmäßig 0.

Beispiele

Ursprungzeit

Eine DocumentTimeline mit einer originTime von null zählt die Zeit ab Performance.timeOrigin. Dies ist das gleiche Verhalten wie bei Document.timeline.

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

Das Festlegen einer nicht-null originTime verschiebt die DocumentTimeline um diesen Betrag von Document.timeline:

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

Eine DocumentTimeline, die relativ zum aktuellen Moment ist, kann wie folgt erstellt werden:

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

Spezifikationen

Specification
Web Animations
# dom-documenttimeline-documenttimeline

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch