1. 问题背景与目标
在网页开发中，我们经常需要为文本添加动态效果，例如波浪式抖动动画。最初的实现可能基于html元素的唯一id进行操作，例如：
<h1 id="wiggle">This text should wiggle...</h1>
function wiggle(){
var parent = document.getElementById("wiggle");
// ... 动画逻辑 ...
}
wiggle();#wiggle span {
/* ... 动画样式 ... */
}这种基于ID的方法虽然有效，但存在一个显著的局限性：ID在HTML文档中必须是唯一的。这意味着如果页面上有多个标题需要相同的动画效果，我们就无法简单地通过复制ID来实现，因为这将导致HTML结构无效。
我们的目标是将这种动画机制从ID切换到类（class），从而允许动画应用于页面上的任意多个元素，实现代码的复用性和可维护性。
2. 核心挑战：从单一元素到元素集合
当我们将目标从ID切换到类时，JavaScript的元素选择方式需要相应调整。document.getElementById()返回的是单个元素，而document.getElementsByClassName()或document.querySelectorAll()返回的是一个元素集合（HTMLCollection或NodeList）。直接将getElementById替换为getElementsByClassName并不能立即生效，因为后续操作（如innerHTML赋值）需要针对集合中的每个元素单独进行。
为了解决这个问题，我们需要：
- 使用document.querySelectorAll('.className')来获取所有匹配的元素。
- 遍历这个元素集合，对每个元素独立执行动画逻辑。
3. 解决方案一：直接在容器类中应用动画
这种方案将动画逻辑封装在一个可复用的函数中，通过遍历所有带有特定类的元素来应用动画。
3.1 JavaScript 实现
首先，我们定义一个wiggle函数，它接收一个DOM元素或一个选择器字符串作为参数。这个函数负责将目标元素的文本内容拆分成单个字符，并将每个字符包裹在一个<span>标签中，同时为每个<span>标签设置一个基于其索引的CSS变量--n，用于控制动画延迟。
/**
* 为指定元素或通过选择器获取的元素应用波浪动画效果。
* @param {HTMLElement|string} elementOrSelector - DOM元素或CSS选择器字符串。
*/
const wiggle = (elementOrSelector) => {
// 根据输入类型获取DOM元素
const element = typeof elementOrSelector === 'string'
? document.querySelector(elementOrSelector) // 如果是字符串，使用querySelector获取第一个匹配元素
: elementOrSelector; // 否则直接使用传入的元素
// 确保元素存在且不重复添加'wiggle'类（可选，如果逻辑上需要控制）
if (!element) {
console.warn('Wiggle target element not found:', elementOrSelector);
return;
}
if (!element.classList.contains('wiggle')) {
element.classList.add('wiggle'); // 确保元素有'wiggle'类，便于CSS选择
}
const text = element.textContent; // 获取原始文本内容
element.textContent = ''; // 清空元素内容
// 将文本拆分成字符，并为每个字符创建带动画延迟的<span>
element.innerHTML = text.split('').reduce((html, char, i) =>
(html + `<span style="--n:${10 * i}ms;">${char}</span>`), '');
// 注意：原始答案中的10 * i - 10000ms 可能导致初始负延迟，
// 这里简化为 10 * i ms，确保延迟从0开始递增。
};
/**
* 遍历所有带有'wiggle'类的元素并应用动画。
*/
const wiggleAll = () => {
// 使用querySelectorAll获取所有带有'wiggle'类的元素
document.querySelectorAll('.wiggle').forEach(wiggle);
};
// 页面加载完成后执行动画
document.addEventListener('DOMContentLoaded', () => {
wiggleAll(); // 自动为所有.wiggle元素应用动画
// 如果需要手动为特定元素应用动画（例如，动态添加的元素）
// wiggle('.wiggle-single');
});3.2 CSS 实现
CSS部分定义了动画的关键帧和应用于<span>元素的样式。--n变量在这里作为animation-delay使用。
@keyframes wave {
0% { top: 0px; }
25% { top: -4px; }
50% { top: 0px; }
75% { top: 4px; }
100% { top: 0px; }
}
/* 针对所有在.wiggle元素内部的<span>应用动画 */
.wiggle span {
animation-delay: var(--n); /* 使用JS设置的自定义延迟 */
animation: wave 2s linear var(--n) infinite forwards running;
position: relative; /* 使top属性生效 */
display: inline-block; /* 确保span可以独立定位和动画 */
}3.3 HTML 结构
现在，我们可以通过简单地为任何需要动画的元素添加wiggle类来实现效果。
<h1 class="wiggle">第一个会抖动的标题</h1> <p>这是一个不会抖动的普通段落。</p> <h2 class="wiggle">第二个会抖动的标题</h2> <div class="wiggle"> <p>这个div里的文本也会抖动。</p> </div> <h3 class="wiggle-single">这是一个可以手动触发的抖动元素。</h3>
注意事项:
- document.querySelectorAll()返回的是一个NodeList，它可以通过forEach方法进行迭代，这比HTMLCollection（由getElementsByClassName返回）更方便。
- --n是一个CSS自定义属性（变量），它允许JavaScript动态地控制CSS样式，实现每个字符的独立动画延迟。
- position: relative;对于top属性的生效至关重要。
- display: inline-block;可以确保每个<span>字符能够独立地进行垂直位移，同时保持在文本流中。
4. 解决方案二：解耦<span>与容器类
在某些情况下，你可能希望将<span>元素的动画样式与其父容器的类解耦。这意味着，即使父容器有其他<span>子元素不应抖动，动画也不会错误地应用。这种方法通过为动态生成的<span>标签添加一个特定的类来实现。
4.1 JavaScript 实现
JavaScript代码与方案一非常相似，唯一的区别是在生成<span>标签时，为其添加一个特定的类，例如wiggler。
const wiggle = (elementOrSelector) => {
const element = typeof elementOrSelector === 'string'
? document.querySelector(elementOrSelector)
: elementOrSelector;
if (!element) {
console.warn('Wiggle target element not found:', elementOrSelector);
return;
}
const text = element.textContent;
element.textContent = '';
// 关键改变：为生成的span添加'wiggler'类
element.innerHTML = text.split('').reduce((html, char, i) =>
(html + `<span class="wiggler" style="--n:${10 * i}ms;">${char}</span>`), '');
};
const wiggleAll = () => {
document.querySelectorAll('.wiggle').forEach(wiggle);
};
document.addEventListener('DOMContentLoaded', () => {
wiggleAll();
// wiggle('.wiggle-single'); // 同样支持手动触发
});4.2 CSS 实现
CSS部分现在直接针对.wiggler类应用动画样式，而不是.wiggle span。
@keyframes wave {
0% { top: 0px; }
25% { top: -4px; }
50% { top: 0px; }
75% { top: 4px; }
100% { top: 0px; }
}
/* 直接针对带有'wiggler'类的<span>应用动画 */
.wiggler {
animation-delay: var(--n);
animation: wave 2s linear var(--n) infinite forwards running;
position: relative;
display: inline-block;
}4.3 HTML 结构
HTML结构与方案一相同，因为wiggler类是由JavaScript动态添加的。
<h1 class="wiggle">第一个会抖动的标题</h1> <p>这是一个不会抖动的普通段落。</p> <h2 class="wiggle">第二个会抖动的标题</h2> <div class="wiggle"> <p>这个div里的文本也会抖动。</p> </div> <h3 class="wiggle-single">这是一个可以手动触发的抖动元素。</h3>
解耦的优势: 这种方法提供了更高的灵活性。如果你的.wiggle容器内部有其他<span>元素，但你不希望它们抖动，那么通过.wiggler类来精确控制动画目标会更清晰。
5. 总结与最佳实践
通过将动画逻辑从基于ID切换到基于类，我们实现了文本动画的强大复用性。
- 使用document.querySelectorAll(): 这是获取元素集合的首选方法，因为它返回NodeList，可以直接使用forEach方法进行迭代。
- 封装动画逻辑: 将动画生成过程封装在一个函数中，使其可重用，并能通过循环或手动调用来应用于多个元素。
- CSS自定义属性（变量）: 利用CSS变量（如--n）可以方便地通过JavaScript动态控制CSS样式，例如动画延迟，而无需直接修改元素的style属性。
- 考虑性能: 对于包含大量文本或需要动画的元素非常多的页面，频繁操作DOM（如innerHTML）可能会影响性能。在这种情况下，可以考虑使用更高效的DOM操作方法或虚拟DOM库。
- 可访问性: 对于任何动画效果，都应考虑其对可访问性的影响。例如，提供一个选项让用户关闭动画，特别是对于那些对运动敏感的用户。
- 模块化: 将JavaScript和CSS代码组织成独立的模块，提高代码的可维护性。
通过以上方法，你可以灵活地在你的网页中应用各种文本动画效果，同时保持代码的整洁和高效。
