Animation:cancel 事件

Baseline 已廣泛支援

此功能已經成熟,並可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 3 月⁩起,它已在各瀏覽器中推出。

cancel 事件是 Animation 介面的一部分,當呼叫 Animation.cancel() 方法時,或當動畫從其他狀態進入 "idle"(空閒)播放狀態時(例如,當動畫在播放完成前從元素中移除時),就會觸發此事件。

注意: 建立一個初始狀態為空閒的新動畫不會在其上觸發 cancel 事件。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("cancel", (event) => { })

oncancel = (event) => { }

事件型別

一個 AnimationPlaybackEvent 物件。繼承自 Event

Event AnimationPlaybackEvent

事件屬性

除了下面列出的屬性之外,父介面 Event 的屬性也可使用。

AnimationPlaybackEvent.currentTime 只讀

生成事件的動畫的當前時間。

AnimationPlaybackEvent.timelineTime 只讀

生成事件的動畫的時間線時間值。

示例

如果此動畫被取消,則移除其元素。

js
animation.oncancel = (event) => {
  animation.effect.target.remove();
};

規範

規範
Web 動畫
# dom-animation-oncancel
Web 動畫
# cancel-event

瀏覽器相容性

另見