Animation: sự kiện cancel

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.

Sự kiện cancel của Animation được kích hoạt khi phương thức Animation.cancel() được gọi hoặc khi hoạt ảnh chuyển sang trạng thái phát "idle" từ một trạng thái khác, chẳng hạn khi hoạt ảnh bị xóa khỏi một phần tử trước khi phát xong.

Note: Việc tạo một hoạt ảnh mới vốn ban đầu ở trạng thái idle không kích hoạt sự kiện cancel trên chính hoạt ảnh mới đó.

Cú pháp

Dùng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt thuộc tính trình xử lý sự kiện.

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

oncancel = (event) => { }

Kiểu sự kiện

Một AnimationPlaybackEvent. Kế thừa từ Event.

Event AnimationPlaybackEvent

Thuộc tính sự kiện

Ngoài các thuộc tính được liệt kê bên dưới, các thuộc tính từ giao diện cha Event cũng có sẵn.

AnimationPlaybackEvent.currentTime Read only

Thời gian hiện tại của hoạt ảnh đã tạo ra sự kiện.

AnimationPlaybackEvent.timelineTime Read only

Giá trị thời gian của timeline của hoạt ảnh đã tạo ra sự kiện.

Ví dụ

Nếu hoạt ảnh này bị hủy, hãy xóa phần tử của nó.

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

Thông số kỹ thuật

Thông số kỹ thuật
Web Animations
# dom-animation-oncancel
Web Animations
# cancel-event

Tương thích trình duyệt

Xem thêm