Animation
Web Animations API 中的 Animation 介面代表一個單獨的動畫播放器,併為動畫節點或源提供播放控制元件和時間線。
建構函式
Animation()-
建立一個新的
Animation物件例項。
例項屬性
Animation.currentTime-
動畫的當前時間值,以毫秒為單位,無論是正在執行還是已暫停。如果動畫沒有
timeline,處於非活動狀態或尚未播放,其值為null。 Animation.effect-
獲取和設定與此動畫關聯的
AnimationEffect。這通常是一個KeyframeEffect物件。 Animation.finished只讀-
返回此動畫當前的完成 Promise。
Animation.id-
獲取和設定用於標識動畫的
String。 Animation.overallProgress只讀-
返回一個介於
0和1之間的數字,表示動畫在其完成狀態下的總體進度。 Animation.pending只讀-
指示動畫當前是否正在等待非同步操作,例如發起播放或暫停正在執行的動畫。
Animation.playState只讀-
返回一個描述動畫播放狀態的列舉值。
Animation.playbackRate-
獲取或設定動畫的播放速率。
Animation.ready只讀-
返回此動畫當前的就緒 Promise。
Animation.replaceState只讀-
指示動畫是活動的、在被另一個動畫替換後被自動移除,還是透過呼叫
Animation.persist()被顯式保留。 Animation.startTime-
獲取或設定動畫播放應開始的預定時間。
Animation.timeline-
獲取或設定與此動畫關聯的
timeline。
例項方法
Animation.cancel()-
清除由此動畫引起的
keyframeEffects並中止其播放。 Animation.commitStyles()-
將動畫的當前樣式狀態提交給正在動畫的元素,即使該動畫已被移除。它將導致當前樣式狀態以
style屬性中屬性的形式寫入正在動畫的元素。 Animation.finish()-
根據動畫是正在播放還是正在反向播放,將動畫定位到其一端。
Animation.pause()-
暫停動畫的播放。
Animation.persist()-
顯式保留一個動畫,防止它在另一個動畫替換它時被 自動移除。
Animation.play()-
開始或恢復動畫的播放,或者在動畫之前完成的情況下重新開始動畫。
Animation.reverse()-
反轉播放方向,停在動畫的開頭。如果動畫已完成或未播放,它將從末尾播放到開頭。
Animation.updatePlaybackRate()-
在首次同步其播放位置後設置動畫的速度。
事件
cancel-
當呼叫
Animation.cancel()方法或動畫從另一個狀態進入"idle"播放狀態時觸發。 finish-
動畫播放完成時觸發。
remove-
動畫被瀏覽器 自動移除 時觸發。
可訪問性考慮
閃爍和動畫可能會給患有注意力缺陷多動障礙 (ADHD) 等認知問題的人帶來困擾。此外,某些型別的運動可能會觸發前庭障礙、癲癇和偏頭痛以及瞳孔敏感性。
考慮提供暫停或停用動畫的機制,並使用 Reduced Motion Media Query(或等效的 使用者代理客戶端提示 Sec-CH-Prefers-Reduced-Motion)為已表示偏好無動畫體驗的使用者建立互補體驗。
規範
| 規範 |
|---|
| Web 動畫 # the-animation-interface |
瀏覽器相容性
載入中…