---
title: animationstart
slug: Web/API/HTMLElement/animationstart_event
tags:
  - Animation
  - AnimationEvent
  - CSS Animations
  - CSS3 Animations
  - Event
  - Reference
  - animationstart
translation_of: Web/API/HTMLElement/animationstart_event
original_slug: Web/Events/animationstart
---
<p><code>animationstart</code> 事件会在 CSS 动画开始时触发。 如果有 <code>animation-delay</code> 延时，事件会在延迟时效过后立即触发。为负数的延时时长会致使事件被触发时事件的 <code>elapsedTime</code> 属性值等于该时长的绝对值（并且，相应地，动画将直接播放该时长绝对值之后的动画）。</p>

<h2 id="基本信息">基本信息</h2>

<dl>
 <dt style="float: left; text-align: right; width: 120px;">规格</dt>
 <dd style="margin: 0 0 0 120px;"><a class="external" href="http://www.w3.org/TR/css3-animations/#animation-events">CSS Animations</a></dd>
 <dt style="float: left; text-align: right; width: 120px;">接口</dt>
 <dd style="margin: 0 0 0 120px;">AnimationEvent</dd>
 <dt style="float: left; text-align: right; width: 120px;">是否冒泡</dt>
 <dd style="margin: 0 0 0 120px;">是</dd>
 <dt style="float: left; text-align: right; width: 120px;">事件可取消</dt>
 <dd style="margin: 0 0 0 120px;">否</dd>
 <dt style="float: left; text-align: right; width: 120px;">目标</dt>
 <dd style="margin: 0 0 0 120px;">Document, Element</dd>
 <dt style="float: left; text-align: right; width: 120px;">默认行为</dt>
 <dd style="margin: 0 0 0 120px;">无</dd>
</dl>

<h2 id="属性表">属性表</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">属性</th>
   <th scope="col">类型</th>
   <th scope="col">描述</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>target</code> {{ReadOnlyInline}}</td>
   <td>{{domxref("EventTarget")}}</td>
   <td>事件来源（DOM 顶层目标）。</td>
  </tr>
  <tr>
   <td><code>type</code> {{ReadOnlyInline}}</td>
   <td>{{domxref("DOMString")}}</td>
   <td>事件类型</td>
  </tr>
  <tr>
   <td><code>bubbles</code> {{ReadOnlyInline}}</td>
   <td><code>boolean</code></td>
   <td>事件是否正常冒泡？</td>
  </tr>
  <tr>
   <td><code>cancelable</code> {{ReadOnlyInline}}</td>
   <td><code>boolean</code></td>
   <td>可否取消该事件？</td>
  </tr>
  <tr>
   <td><code>animationName</code> {{ReadOnlyInline}}</td>
   <td>{{domxref("DOMString")}}</td>
   <td>与该动画相关的 CSS 属性值。</td>
  </tr>
  <tr>
   <td><code>elapsedTime</code> {{ReadOnlyInline}}</td>
   <td><code>Float</code></td>
   <td>动画运行时长，单位为秒，与直到该事件被触发的时间相一致，不包括任何动画暂停时的时长。此值应为 0 除非 <code>animation-delay</code> 是一个负值，这种情况下此值为 (-1 * {{cssxref("animation-delay")}})，并且动画将直接从此值后的序列开始播放。</td>
  </tr>
 </tbody>
</table>

<h2 id="相关事件">相关事件</h2>

<ul>
 <li>{{Event("animationstart")}}</li>
 <li>{{Event("animationend")}}</li>
 <li>{{Event("animationiteration")}}</li>
</ul>

<h2 id="另请参阅">另请参阅</h2>

<ul>
 <li><a href="/en-US/docs/CSS/Using_CSS_animations" title="/en-US/docs/CSS/Using_CSS_animations">Using CSS Animations</a></li>
</ul>