本文介绍一种实用方案：通过 javascript 动态判断文本是否溢出容器，仅在溢出时添加可 hover 触发的 css 滚动动画，避免短文本无效滚动，兼顾性能与体验。
在构建响应式 UI 组件（如标签芯片、状态徽章、单行信息卡片）时，常需实现「悬停滚动长文本」的效果。但若直接对所有元素统一启用 @keyframes 动画，会导致短文本也产生无意义的位移，影响可读性与视觉一致性。纯 CSS 无法检测内容溢出（offsetWidth > parent.clientWidth 等判定逻辑不可用），因此必须借助 JavaScript 进行运行时判断。
✅ 核心思路
- CSS 定义动画与触发类：将滚动动画封装为独立 class（如 .scrolled:hover），不默认启用；
- JS 动态注入行为：遍历目标元素，比较 element.scrollWidth 与 element.parentElement.clientWidth（更准确于 offsetWidth，因后者含 padding/border）；
- 条件添加 class：仅当 scrollWidth > clientWidth 时，添加可交互的动画类。
? 示例代码（优化版）
.chip-container {
max-width: 400px;
height: 32px;
font-size: 0.8125rem;
display: inline-flex;
align-items: center;
border-radius: 16px;
white-space: nowrap;
overflow: hidden;
background-color: #666;
color: white;
margin: 3px;
}
.chip-value {
display: inline-block;
position: relative;
margin: 0 5px;
text-overflow: clip; /* 防止默认省略号干扰 */
}
/* 可选：添加平滑过渡 */
.scrolled {
transition: transform 0.3s ease;
}
.scrolled:hover {
animation: scroll-rtl 15s linear forwards;
}
@keyframes scroll-rtl {
0% { transform: translateX(0); }
100% { transform: translateX(-100%); }
}<div class="chip-container"> <div class="chip-value">Very very very very very very very very very very long text</div> </div> <div class="chip-container"> <div class="chip-value">Short</div> </div>
// 页面加载后执行（推荐放在 DOMContentLoaded 或使用 defer）
document.addEventListener('DOMContentLoaded', () => {
document.querySelectorAll('.chip-value').forEach(el => {
const parent = el.parentElement;
// 关键判断：scrollWidth > parent.clientWidth（考虑 padding 和 border）
if (el.scrollWidth > parent.clientWidth) {
el.classList.add('scrolled');
}
});
});⚠️ 注意事项
- scrollWidth 是唯一可靠指标：它返回内容实际宽度（含不可见部分），而 offsetWidth 包含边框/内边距，易误判；
- 响应式场景需重校验：若容器尺寸随视口变化（如 max-width: 100%），需监听 resize 并重新计算（建议防抖处理）；
-
无障碍友好：滚动动画可能影响部分用户，可结合 prefers-reduced-motion 媒体查询禁用：
@media (prefers-reduced-motion: reduce) { .scrolled:hover { animation: none; } } - 性能提示：避免在大量元素上高频调用 scrollWidth；若数据量大，建议节流或服务端预判。
✅ 总结
虽然 CSS 动画简洁高效，但“按需启用”依赖运行时布局信息——这正是 JavaScript 的优势所在。本方案以最小侵入方式实现智能滚动：短文本静默展示，长文本悬停即动，语义清晰、兼容性强，是现代前端组件中值得复用的最佳实践。
