从ID到Class：动画复用性的转变
在网页开发中，我们经常需要为多个相似的元素应用相同的动态效果。最初的实现可能为了快速验证概念而使用id选择器，例如document.getelementbyid("wiggle")和css中的#wiggle。然而，id在html中必须是唯一的，这使得这种方法无法直接应用于多个元素。为了实现动画的复用性，我们需要将目标从唯一的id转向可应用于多个元素的css类。
核心的挑战在于：
- JavaScript端： 如何获取所有带有特定类的元素，并对它们分别执行文本拆分和标签包裹的操作。
- CSS端： 如何确保动画样式能够正确地作用于这些新生成的标签，并且与父元素的类选择器配合。
JavaScript重构：遍历与动态生成
为了支持多元素动画，我们需要将原有的JavaScript逻辑进行封装和扩展。关键在于使用document.querySelectorAll()方法来获取所有匹配特定CSS选择器（例如.wiggle）的元素，然后对每个元素执行动画准备工作。
核心wiggle函数
首先，我们定义一个通用的wiggle函数，它可以接受一个DOM元素或一个CSS选择器作为参数。这个函数负责将目标元素的文本内容拆分成单个字符，并用带有动态CSS变量的标签包裹起来。
/**
* 将指定元素的文本内容拆分为带动画效果的标签。
* @param {HTMLElement|string} elementOrSelector - 目标DOM元素或CSS选择器。
*/
const wiggle = (elementOrSelector) => {
// 根据输入类型获取DOM元素
const element = typeof elementOrSelector === 'string'
? document.querySelector(elementOrSelector) // 如果是字符串，则查询第一个匹配的元素
: elementOrSelector; // 否则直接使用传入的元素
// 确保元素存在
if (!element) {
console.warn('Wiggle function: Target element not found.', elementOrSelector);
return;
}
const text = element.textContent; // 获取原始文本内容
element.textContent = ''; // 清空原始内容，准备插入新的
// 遍历字符，生成带有自定义CSS变量的标签
element.innerHTML = text.split('').reduce((html, char, index) =>
// --n 变量用于控制每个字符的动画延迟，例如 10 * index - 10000ms
(html + `${char}`), '');
};在上述代码中，--n是一个CSS自定义属性（或称CSS变量），它为每个字符的标签提供了唯一的动画延迟值。这个值是根据字符的索引index计算得出的，从而创建出逐字波动的效果。
立即学习“Java免费学习笔记（深入）”；
批量应用与手动控制
为了批量应用动画，我们可以定义一个wiggleAll函数，它会查找所有带有特定类的元素并调用wiggle函数。同时，wiggle函数的设计也允许我们手动指定某个元素进行动画。
/**
* 对所有带有'wiggle'类的元素应用动画。
*/
const wiggleAll = () => {
document.querySelectorAll('.wiggle').forEach(wiggle);
};
// 页面加载后自动对所有'.wiggle'元素应用动画
wiggleAll();
// 也可以手动对特定元素应用动画，例如：
// wiggle('.wiggle-single');CSS样式定义：动画效果与类选择器
CSS部分需要定义实际的动画效果，并确保它能作用于JavaScript动态生成的标签。
关键帧动画定义
首先，定义一个名为wave的关键帧动画，它描述了文本垂直方向上的波动效果。
@keyframes wave {
0% { top: 0px; }
25% { top: -4px; }
50% { top: 0px; }
75% { top: 4px; }
100% { top: 0px; }
}应用动画到标签
接着，使用类选择器和后代选择器来定位需要应用动画的标签。
/* 方案一：通过父元素的类名来定位其子 */
.wiggle span {
animation-delay: var(--n); /* 使用JavaScript设置的自定义属性作为动画延迟 */
animation: wave 2s linear var(--n) infinite forwards running;
position: relative; /* 确保top属性能够生效 */
}这里，.wiggle span选择器确保只有在class="wiggle"的父元素内的标签才会应用此动画。animation-delay: var(--n)是实现逐字动画的关键，它利用了JavaScript动态生成的--n变量。
HTML结构示例
现在，你只需在需要动画的
或任何其他块级元素上添加class="wiggle"即可。这段文字会波动...
而这段文字则不会...
...但这段也会波动。
手动指定的波动文字...
优化与解耦：独立Span类名（可选）
这段文字会波动...
而这段文字则不会...
...但这段也会波动。
手动指定的波动文字...
在某些情况下，你可能希望将动画样式与父容器的类名进一步解耦。这意味着，不是依赖于父元素的类来选择，而是直接给每个动态生成的添加一个特定的类名。
JavaScript调整
只需在生成标签时，为其添加一个额外的类名（例如wiggler）。
const wiggle = (elementOrSelector) => {
const element = typeof elementOrSelector === 'string'
? document.querySelector(elementOrSelector)
: elementOrSelector;
if (!element) {
console.warn('Wiggle function: Target element not found.', elementOrSelector);
return;
}
const text = element.textContent;
element.textContent = '';
element.innerHTML = text.split('').reduce((html, char, index) =>
// 添加 class="wiggler"
(html + `${char}`), '');
};
// 其余的 wiggleAll() 和调用方式保持不变
const wiggleAll = () => {
document.querySelectorAll('.wiggle').forEach(wiggle);
}
wiggleAll();
// wiggle('.wiggle-single');CSS调整
相应的，CSS选择器也需要更新，直接 targeting .wiggler 类。
/* 方案二：直接通过自身的类名来定位 */
.wiggler {
animation-delay: var(--n);
animation: wave 2s linear var(--n) infinite forwards running;
position: relative;
}这种方法提供了更高的灵活性，即使父元素没有wiggle类，只要JavaScript生成了带有wiggler类的，动画就会生效。
注意事项与最佳实践
- 性能考量： 对于非常长的文本或页面上大量需要动画的元素，频繁的DOM操作（innerHTML赋值）可能会影响性能。在实际应用中，应权衡效果与性能。考虑在动画初始化后，将JavaScript从DOM中移除，减少不必要的监听。
- 可访问性： 持续的动画效果可能对部分用户（例如有前庭系统障碍或认知障碍的用户）造成不适。考虑提供一个开关来禁用动画，或者只在用户交互时触发动画。使用prefers-reduced-motion媒体查询可以为有特殊需求的用户提供更友好的体验。
- CSS变量的强大： var(--n)的运用是实现此效果的关键，它展示了CSS自定义属性在动态样式控制方面的强大能力，使得JavaScript和CSS之间的数据传递变得简单高效。
- DOM操作的效率： 尽管innerHTML +=在循环中可能效率不高，但通过reduce方法构建整个字符串再一次性赋值给innerHTML是相对高效的做法，因为它只触发一次DOM重绘。
- 语义化： 尽量保持HTML的语义化，例如，如果动画只是视觉效果，确保它不会干扰屏幕阅读器对内容的理解。
总结
通过本教程，我们学习了如何将单元素ID动画扩展为多元素Class动画。关键在于：
- JavaScript端： 使用document.querySelectorAll()遍历目标元素集合，并封装一个通用的函数来处理每个元素的文本拆分和包裹。
- CSS端： 利用类选择器（如.wiggle span或.wiggler）来精确地定位需要应用动画的标签，并通过CSS自定义属性（--n）实现逐字动画延迟。
- HTML端： 简单地在需要动画的元素上添加相应的类名即可。
这种方法不仅提高了代码的复用性，也使得动画的控制更加灵活和模块化，是实现复杂动态网页效果的常用模式。
