SVGAnimationElement

基线

广泛可用

自 2020年1月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

* 此特性的某些部分的支持程度可能有所不同。

SVGAnimationElement 接口是所有动画元素接口的基础接口，包括 SVGAnimateElement、SVGSetElement、SVGAnimateMotionElement 和 SVGAnimateTransformElement。

实例属性

该接口还从其父接口 SVGElement 继承属性。

SVGAnimationElement.requiredExtensions 只读: 一个反映给定元素的 requiredExtensions 属性的 SVGStringList。
SVGAnimationElement.systemLanguage 只读: 一个反映给定元素的 systemLanguage 属性的 SVGStringList。
SVGAnimationElement.targetElement 只读: 一个表示正在应用动画的元素的 SVGElement。如果没有目标元素正在应用动画（例如，href 指定了未知元素），则返回值为 null。

该接口还从其父接口 SVGElement 继承方法。

SVGAnimationElement.getStartTime(): 如果此动画元素存在当前时间区间，则返回一个浮点数，表示该区间的开始时间（以秒为单位），无论该区间是否已经开始。如果没有当前时间区间，则抛出错误码为 INVALID_STATE_ERR 的 DOMException。
SVGAnimationElement.getCurrentTime(): 返回一个浮点数，表示相对于给定时间容器的零时刻的当前时间（以秒为单位）。
SVGAnimationElement.getSimpleDuration(): 返回一个浮点数，表示此动画的简单持续时间（以秒为单位）。如果简单持续时间未定义（例如，结束时间不确定），则抛出错误码为 NOT_SUPPORTED_ERR 的 DOMException。
SVGAnimationElement.beginElement(): 以当前时间创建一个开始实例时间。新的实例时间会添加到开始实例时间列表中。此方法的行为等同于 beginElementAt(0)。
SVGAnimationElement.beginElementAt(): 以当前时间加上指定偏移量创建一个开始实例时间。新的实例时间会添加到开始实例时间列表中。
SVGAnimationElement.endElement(): 以当前时间创建一个结束实例时间。新的实例时间会添加到结束实例时间列表中。此方法的行为等同于 endElementAt(0)。
SVGAnimationElement.endElementAt(): 以当前时间加上指定偏移量创建一个结束实例时间。新的实例时间会添加到结束实例时间列表中。

使用 addEventListener() 或将事件监听器赋值给此接口的 on... 处理器属性来监听这些事件。

规范
SVG Animations Level 2 # InterfaceSVGAnimationElement

此页面最后更新于 2026年11月12日，由 MDN 贡献者更新。