大网数据广告活动
Web 标准与前端开发

`animation-composition` CSS property

· 52CE 我爱测

The **`animation-composition`** CSS property specifies the composite operation to use when multiple animations affect the same property simultaneously.

The animation-composition CSS property specifies the composite operation to use when multiple animations affect the same property simultaneously.

Syntax

/* Single animation */
animation-composition: replace;
animation-composition: add;
animation-composition: accumulate;

/* Multiple animations */
animation-composition: replace, add;
animation-composition: add, accumulate;
animation-composition: replace, add, accumulate;

/* Global values */
animation-composition: inherit;
animation-composition: initial;
animation-composition: revert;
animation-composition: revert-layer;
animation-composition: unset;

Values

This property is specified as one or more comma-separated keyword values:

  • replace
    • : The effect value overrides the underlying value of the property. This is the default value.
  • add
    • : The effect value builds on the underlying value of the property. This operation produces an additive effect. For animation types where the addition operation is not commutative, the order of the operands is the underlying value followed by the effect value.
  • accumulate
    • : The effect and underlying values are combined. For animation types where the addition operation is not commutative, the order of the operands is the underlying value followed by the effect value.

Description

Each property that is targeted by the @keyframes at-rule is associated with an effect stack. The value of the effect stack is calculated by combining the underlying value of a property in a CSS style rule with the effect value of that property in the keyframe. The animation-composition property helps to specify how to combine the underlying value with the effect value.

For example, in the CSS below, blur(5px) is the underlying value, and blur(10px) is the effect value. The animation-composition property specifies the operation to perform to produce the final effect value after compositing the effect of the underlying value and the effect value.

.icon:hover {
  filter: blur(5px);
  animation: 3s infinite pulse;
  animation-composition: add;
}

@keyframes pulse {
  0% {
    filter: blur(10px);
  }
  100% {
    filter: blur(20px);
  }
}

Consider different values for the animation-composition property in the above example. The final effect value in each of those cases will be calculated as explained below:

  • With replace, blur(10px) will replace blur(5px) in the 0% keyframe. This is the default behavior of the property.
  • With add, the composite effect value in the 0% keyframe will be blur(5px) blur(10px).
  • With accumulate, the composite effect value in 0% keyframe will be blur(15px).

[!NOTE] A composite operation can also be specified in a keyframe. In that case, the specified composite operation is used for each property first within that keyframe and then on each property in the next keyframe.

Multiple values

When you specify multiple comma-separated values on an animation-* property, they will be applied to the animations in the order in which the animation-names appear. If the number of animations and compositions differ, the values listed in the animation-composition property will cycle from the first to the last animation-name, looping until all the animations have an assigned animation-composition value. For more information, see Setting multiple animation property values.

Formal definition

Formal syntax

Examples

Understanding the animation-composition values

The example below shows the effect of different animation-composition values side-by-side.

HTML

<div class="container">
  replace
  <div id="replace" class="target"></div>
</div>
<div class="container">
  add
  <div id="add" class="target"></div>
</div>
<div class="container">
  accumulate
  <div id="accumulate" class="target"></div>
</div>

CSS

body {
  display: flex;
  flex-wrap: wrap;
  gap: 3px;
}

.container {
  flex: 1;
  min-width: 200px;
  height: 200px;
  background: lightblue;
  display: inline-block;
  text-align: center;
}

.target {
  width: 20px;
  height: 50px;
  background: green;
  border-radius: 10px;
  margin: 20px 0;
}
@keyframes slide {
  50% {
    transform: translateY(30px);
  }
  100% {
    transform: translateX(150px);
  }
}

.target {
  transform: translateX(30px) rotate(45deg);
  animation: slide 5s linear infinite;
}
#replace {
  animation-composition: replace;
}
#add {
  animation-composition: add;
}
#accumulate {
  animation-composition: accumulate;
}

Result

understanding_the_animation-composition_values

The underlying value for the transform property in all cases is translateX(30px) rotate(45deg). The different animation-composition values' effects are as follows:

  • With replace, the transform property in each keyframe entirely replaces the underlying transform property set on the animated element. The final effect value for the transform property at the 50% keyframe is translateY(30px) (no rotate or translateX); at the 100% keyframe, it is translateX(150px) (no rotate or translateY).

    The target starts at transform: translateX(30px) rotate(45deg) and effectively animates to transform: translateY(30px), then to transform: translateX(150px).

  • With add, the final effect value at each keyframe is the underlying transform value with the effect value placed immediately after it.

    Therefore, the target starts at transform: translateX(30px) rotate(45deg) and effectively animates first to transform: translateX(30px) rotate(45deg) translateY(30px) (which is 30px "downwards" on the rotated Y-axis), and then to transform: translateX(30px) rotate(45deg) translateX(150px). Since the additive operation is relative to the underlying transform and not the previous keyframe, there is no translateY(30px) at 100%, placing the element 150px along the rotated X-axis from the original position.

  • With accumulate, the final effect value is the keyframe's effect transform combined with the underlying original. At 50%, translateY(30px) combines with the original translateX(30px) into a single translation (translate(30px, 30px)). At 100%, the translateX(150px) combines with the original translateX(30px) to create translateX(180px).

    Therefore, the target starts at transform: translateX(30px) rotate(45deg) and effectively animates first to transform: translate(30px, 30px) rotate(45deg), and then to transform: translateX(180px) rotate(45deg).

Specifications

Browser compatibility

See also

  • Using CSS animations
  • Composite property of KeyFrameEffect
  • Other related animation properties: animation, animation-delay, animation-direction, animation-duration, animation-fill-mode, animation-iteration-count, animation-name, animation-play-state, animation-timeline, animation-timing-function

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。