点击涟漪本质是用 radial-gradient 实现的径向渐变动态扩展效果
先来看一张效果图，直观感受一下：
很多开发者第一次看到这种效果，会下意识地想到用动画位移一个圆形遮罩来实现。但其实，它的核心原理更巧妙——直接在元素的背景上，用 radial-gradient 画一个从点击点出发、半径能不断变大的圆。这个“动态扩展”的感觉，是通过控制 background-size 的缩放来实现的。
这里有个关键细节必须注意：渐变中心的位置必须用百分比来表示。如果直接用像素值，你会发现涟漪永远从元素中心扩散，鼠标点哪儿都不管用。
点击涟漪的本质是径向渐变的动态扩展
那么，如何把鼠标点击的像素坐标，转换成CSS能理解的百分比呢？
- 首先，用
getBoundingClientRect()拿到元素相对于整个视口的位置。 - 然后，减去元素自身的
offsetLeft和offsetTop，得到点击位置相对于这个元素左上角的像素偏移量。 - 最后，把这个像素偏移量除以元素的宽度或高度，再乘以100，就得到了我们需要的
--x和--yCSS变量值。记住，这个值是一个纯数字，在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逻辑。
