AnimationTimeline：duration 屬性

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

Web 動畫 API 的 AnimationTimeline 介面的 duration 只讀屬性返回此時間軸的最大值或 null。

請注意，派生介面 ViewTimeline 和 ScrollTimeline 總是返回 100% 的 duration，而 DocumentTimeline 沒有 duration，並返回 null。

值

表示時間軸持續時間（此時間軸的最大值）的數字或 null。

示例

檢視時間軸持續時間

ViewTimeline 始終以 CSSUnitValue 的形式返回 100% 的持續時間。

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

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

滾動時間軸持續時間

ScrollTimeline 始終以 CSSUnitValue 的形式返回 100% 的持續時間。

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

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

文件時間軸持續時間

DocumentTimeline 沒有持續時間。

document.timeline.duration; // null

規範

規範
Web 動畫 Level 2 # dom-animationtimeline-duration

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025年9月21日，由 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的問題