CSS如何实现点击涟漪的颜色扩散_动态CSS变量与径向渐变结合

点击涟漪本质是用 radial-gradient 实现的径向渐变动态扩展效果

先来看一张效果图，直观感受一下：

很多开发者第一次看到这种效果，会下意识地想到用动画位移一个圆形遮罩来实现。但其实，它的核心原理更巧妙——直接在元素的背景上，用 radial-gradient 画一个从点击点出发、半径能不断变大的圆。这个“动态扩展”的感觉，是通过控制 background-size 的缩放来实现的。

这里有个关键细节必须注意：渐变中心的位置必须用百分比来表示。如果直接用像素值，你会发现涟漪永远从元素中心扩散，鼠标点哪儿都不管用。

点击涟漪的本质是径向渐变的动态扩展

那么，如何把鼠标点击的像素坐标，转换成CSS能理解的百分比呢？

• 首先，用 getBoundingClientRect() 拿到元素相对于整个视口的位置。
• 然后，减去元素自身的 offsetLeft 和 offsetTop，得到点击位置相对于这个元素左上角的像素偏移量。
• 最后，把这个像素偏移量除以元素的宽度或高度，再乘以100，就得到了我们需要的 --x 和 --y CSS变量值。记住，这个值是一个纯数字，在CSS里使用时要手动拼接上 % 单位。

关于渐变色，有个小经验：颜色停靠点建议设为 rgba(255,255,255,0.3) 0%, transparent 70%。如果透明过渡段太长，扩散效果会显得很“虚”，缺乏力度感。

如何用 CSS 变量驱动渐变中心与大小

CSS自己无法读取鼠标坐标，这个“脏活”必须交给Ja vaScript来完成——由JS来注入坐标变量。不过好消息是，一旦变量设置好，后续所有的动画和颜色控制，都可以完全交给CSS处理，实现样式与逻辑的分离。

我们需要定义几组核心变量：--x 和 --y 控制涟漪中心，--r 控制扩散半径，--c 控制涟漪颜色（可选）。

• 在JS中设置变量时，推荐使用 element.style.setProperty('--x', xPercent) 这种方式。它只作用于当前元素，避免了污染全局的 :root 样式。
• 在CSS中书写渐变时，要显式地拼接单位：background: radial-gradient(circle at var(--x) var(--y), var(--c, rgba(0,0,0,0.1)) 0%, transparent var(--r, 200px))。
• --r 的初始值设为 0，在动画中过渡到一个足够覆盖整个元素的值。这里有个误区：有人会尝试用 calc(1.5 * sqrt((100vw * 100vw) + (100vh * 100vh))) 这种复杂的计算来确保覆盖对角线，其实在实践中，直接用一个较大的固定值如 300px，或者相对值 max(300px, 150%) 更加稳定可靠。

为什么 transition 会失效？检查这三点

效果出不来？最常见的情况就是点了没反应，而90%的原因出在 transition 没有生效。要知道，transition 只对“可动画”的CSS属性起作用，而 background-image（渐变属于此类）本身是不可过渡的。我们必须通过间接方式来触发动画。

• 不要对整个 background 属性应用 transition。正确的做法是，只对 background-size 和 opacity（如果使用了透明度变化）这两个可动画的属性进行过渡。
• 确保在Ja vaScript的每次点击事件中，先将 --r 重置为 0，然后在下一个微任务（microtask）中再将其设置为目标值。如果缺少这个重置步骤，CSS会认为值没有变化，从而不会触发动画。
• 性能优化方面，如果使用了 will-change: background，反而可能在某些浏览器中禁用硬件加速。更稳妥的做法是使用 transform: translateZ(0) 或 backface-visibility: hidden 来强制浏览器将元素提升到独立的渲染图层。

兼容性与性能陷阱：Safari 和高频点击

在实际项目中，兼容性和极端操作下的性能往往是坑点。Safari浏览器对 radial-gradient 中动态拼接变量的支持较弱，特别是 at var(--x) var(--y) 这种写法，容易出现渲染错位。另外，用户快速连续点击会导致多个涟漪叠加，可能引起内存泄漏或页面卡顿。

这里有几个经过验证的解决方案：

• 绕过Safari的Bug：可以换一种思路。不再动态改变渐变中心，而是准备一张固定的大渐变背景图，通过改变 background-position 来模拟中心点的移动。例如：background-position: calc(var(--x) * 1px) calc(var(--y) * 1px) 配合一个固定的 background-size: 400px 400px。
• 防止重复点击：在涟漪动画播放期间，为元素临时添加 pointer-events: none 样式来禁用点击，动画结束后再移除。或者，也可以用一个简单的标志位配合 setTimeout 来控制点击频率。
• 不要过度优化：CSS原生的 transition 自带性能优化，通常不需要动用 requestAnimationFrame 去手动控制每一帧。强行接管动画，反而会增加Ja vaScript的负担，得不偿失。

最后分享一个设计模式上的建议：如果涟漪颜色需要跟随系统或主题色变化，不要在Ja vaScript里硬编码 rgb() 字符串。更好的做法是让组件提前定义好一个CSS变量，例如 --ripple-color，然后在样式中直接引用。这样，未来需要换肤时，只需要修改CSS变量即可，无需触动Ja vaScript逻辑。