讲师中心 微信公众号
AI工具推荐 视频效率加速

如何仅在文本溢出时启用自动滚动动画(CSS + JS 方案)

落婷君_3673

落婷君_3673

发布时间:2025-12-29 19:00:29

|

966人浏览过

|

来源于php中文网

原创

如何仅在文本溢出时启用自动滚动动画(CSS + JS 方案)

本文介绍一种实用方案:仅当容器内文本实际溢出时,才在 hover 时触发动画滚动;若文本完全可见,则禁用动画。纯 css 无法可靠检测溢出,因此需结合轻量 javascript 动态添加/移除滚动类。

在构建响应式 UI 组件(如标签芯片、状态提示栏)时,常需实现“悬停滚动长文本”的交互效果。但若对所有文本统一启用 animation,会导致短文本也出现无意义的位移动画,影响体验与性能。关键挑战在于:CSS 本身不具备检测 offsetWidth > parent.clientWidth 的能力,因此必须借助 JavaScript 进行运行时判定。

✅ 推荐实现方案(轻量 JS + 语义化 CSS)

核心思路是:

  1. 预定义一个带 hover 动画的 CSS 类(如 .scrolled:hover);
  2. 页面加载后,遍历目标元素,对比其 offsetWidth 与父容器可用宽度;
  3. 仅当文本真实溢出时,才为其添加 .scrolled 类 —— 此时 hover 才会触发动画。

以下是完整可运行代码:

Aria2 Json Rpc
Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互,使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载
/* 容器基础样式(固定宽度 + 隐藏溢出) */
.chip-container {
  max-width: 400px;
  height: 32px;
  font-size: 0.8125rem;
  display: inline-flex;
  align-items: center;
  white-space: nowrap;
  overflow: hidden;
  border-radius: 16px;
  background-color: #666;
  color: white;
  margin: 3px;
}

/* 文本内容区(不设宽,依赖内容伸缩) */
.chip-value {
  display: inline-block;
  position: relative;
  margin: 0 5px;
  text-overflow: clip; /* 防止 ellipsis 干扰宽度计算 */
}

/* 滚动动画类 —— 仅当存在该类时,hover 才生效 */
.scrolled:hover {
  animation: scroll-rtl 15s linear forwards;
}

@keyframes scroll-rtl {
  0%   { transform: translateX(0); }
  100% { transform: translateX(-100%); }
}
<!-- HTML 结构(保持简洁) -->
<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">Not long</div>
</div>
// 初始化:为所有溢出的 .chip-value 添加 .scrolled 类
document.querySelectorAll('.chip-value').forEach(el => {
  const parent = el.parentElement;
  // 使用 getComputedStyle 确保获取准确的可用宽度(兼容 padding/margin)
  const parentWidth = parent.clientWidth;
  if (el.offsetWidth > parentWidth) {
    el.classList.add('scrolled');
  }
});

⚠️ 注意事项与优化建议

  • 宽度判定逻辑:使用 el.offsetWidth > parent.clientWidth 而非硬编码 400,确保适配不同尺寸容器(如响应式布局或动态修改 max-width 的场景);
  • 性能考量:该脚本仅在初始化时执行一次,无监听开销;如需支持动态内容更新(如 AJAX 加载),可封装为函数并手动调用;
  • 无障碍友好:滚动动画可能对部分用户造成不适,建议在 prefers-reduced-motion: reduce 下禁用动画:
    @media (prefers-reduced-motion: reduce) {
      .scrolled:hover {
        animation: none;
      }
    }
  • 替代方案提醒:若严格要求零 JS,可考虑 CSS @container 查询(实验性,需开启 flag),但目前兼容性有限,不推荐生产环境使用。

通过此方案,你既能保持 CSS 动画的声明式优雅,又能精准控制交互逻辑 —— 真正实现「有溢出才滚动,无溢出不干扰」的高质量用户体验。

立即学习“前端免费学习笔记(深入)”;

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2360

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2213

2023.11.15

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1141

2024.09.24

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

3836

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1215

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1558

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

9303

2023.08.17

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5.7万人学习

CSS教程
CSS教程

共754课时 | 94.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn