HTMLElement: animationcancel event

在此页

范例
规范
浏览器兼容性
另请参阅
相关话题

这是实验性技术
检查浏览器兼容性表格要小心谨慎在生产中使用这之前。

animationcancel event is fired when a CSS Animation unexpectedly aborts. In other words, any time it stops running without sending an animationend event. This might happen when the animation-name is changed such that the animation is removed, or when the animating node is hidden using CSS. Therefore, either directly or because any of its containing nodes are hidden.

An event handler for this event can be added by setting the onanimationcancel property, or using addEventListener() .

冒泡	Yes
可取消	No
接口	`AnimationEvent`
事件处理程序特性	`onanimationcancel`

范例

This code gets an element that's currently being animated and adds a listener to the animationcancel event. It then sets the element's display 特性到 none , which will trigger the animationcancel 事件。

const animated = document.querySelector('.animated');
animated.addEventListener('animationcancel', () => {
  console.log('Animation canceled');
});
animated.style.display = 'none';

一样，但使用 onanimationcancel property instead of addEventListener() :

const animated = document.querySelector('.animated');
animated.onanimationcancel = () => {
  console.log('Animation canceled');
};
animated.style.display = 'none';

实时范例

HTML

<div class="animation-example">
    <div class="container">
        <p class="animation">You chose a cold night to visit our planet.</p>
    </div>
    <button class="activate" type="button">Activate animation</button>
    <div class="event-log"></div>
</div>

CSS

.container {
  height: 3rem;
}
.event-log {
  width: 25rem;
  height: 2rem;
  border: 1px solid black;
  margin: 0.2rem;
  padding: 0.2rem;
}
.animation.active {
  animation-duration: 2s;
  animation-name: slidein;
  animation-iteration-count: 2;
}
@keyframes slidein {
  from {
    transform: translateX(100%) scaleX(3);
  }
  to {
    transform: translateX(0) scaleX(1);
  }
}

JS

const animation = document.querySelector('p.animation');
const animationEventLog = document.querySelector('.animation-example>.event-log');
const applyAnimation = document.querySelector('.animation-example>button.activate');
let iterationCount = 0;
animation.addEventListener('animationstart', () => {
  animationEventLog.textContent = `${animationEventLog.textContent}'animation started' `;
});
animation.addEventListener('animationiteration', () => {
  iterationCount++;
  animationEventLog.textContent = `${animationEventLog.textContent}'animation iterations: ${iterationCount}' `;
});
animation.addEventListener('animationend', () => {
  animationEventLog.textContent = `${animationEventLog.textContent}'animation ended'`;
  animation.classList.remove('active');
  applyAnimation.textContent = "Activate animation";
});
animation.addEventListener('animationcancel', () => {
  animationEventLog.textContent = `${animationEventLog.textContent}'animation canceled'`;
});
applyAnimation.addEventListener('click', () => {
  animation.classList.toggle('active');
  animationEventLog.textContent = '';
  iterationCount = 0;
  let active = animation.classList.contains('active');
  if (active) {
    applyAnimation.textContent = "Cancel animation";
  } else {
    applyAnimation.textContent = "Activate animation";
  }
});

结果

规范

规范	状态	注释
CSS 动画	工作草案	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`animationcancel` event	Chrome No	Edge No	Firefox 54	IE No	Opera No	Safari 13.1 13.1 12 Disabled Disabled From version 12: this feature is behind the `Web 动画` preference and the `CSS Animations via Web Animations` preference.	WebView Android No	Chrome Android No	Firefox Android 54	Opera Android No	Safari iOS 13.4 13.4 12 Disabled Disabled From version 12: this feature is behind the `Web 动画` preference and the `CSS Animations via Web Animations` preference.	Samsung Internet Android No

图例

完整支持
不支持
用户必须明确启用此特征。

另请参阅

CSS 动画
Using CSS Animations
AnimationEvent
相关事件： animationstart , animationend , animationiteration
此事件在 Document 目标： animationcancel
此事件在 Window 目标： animationcancel

元数据

最后修改： Feb 16, 2020

HTMLElement
特性
方法
1. click()
2. forceSpellCheck()
事件
1. animationcancel
2. animationend
3. animationiteration
4. animationstart
5. beforeinput
6. change
7. gotpointercapture
8. input
9. lostpointercapture
10. pointercancel
11. pointerdown
12. pointerenter
13. pointerleave
14. pointermove
15. pointerout
16. pointerover
17. pointerup
18. transitioncancel
19. transitionend
20. transitionrun
21. transitionstart
继承：

在此页

范例

实时范例

HTML

CSS

JS

结果

规范

浏览器兼容性

图例

另请参阅

相关话题