怎么用Bootstrap制作侧边栏折叠收缩动画

秋雪小哥_4142

秋雪小哥_4142

2026-11-21

648人浏览

原创

侧边栏折叠时内容被裁切或消失的解决方案是:用max-width/min-width+transition实现宽度动画,配合JS控制.collapsed类切换,并通过Bootstrap Collapse事件触发、媒体查询隔离hover、resize时清理类以适配移动端。

怎么用bootstrap制作侧边栏折叠收缩动画

侧边栏折叠时内容被裁切或消失

Bootstrap 5 默认的 collapse 类不处理宽度变化,只控制 height 和 overflow。直接对侧边栏容器加 collapse,会发现它“缩没了”——因为 display: none 被触发,或者 width 没参与动画,导致视觉跳变。

真正要动的是 width(或 flex-basis),而 Bootstrap 的 collapse 不支持这个。必须手动补 CSS 过渡 + JS 控制类切换。

  • 用 min-width + max-width 配合 transition 实现宽度动画,比直接改 width 更稳定(避免重排抖动)
  • 给侧边栏父容器设 flex-shrink: 0,防止 Flex 布局下被压缩变形
  • 折叠状态需同时移除 .show 并添加自定义类(如 .collapsed),不能只依赖 collapse 的显隐逻辑

用 CSS transition 实现平滑宽度收放

核心是让侧边栏在 .sidebar 和 .sidebar.collapsed 之间过渡 max-width 和 padding,而不是靠 JS 动态写内联样式。

.sidebar {
  transition: max-width 0.3s ease, padding 0.3s ease;
  max-width: 250px;
  min-width: 60px;
}
.sidebar.collapsed {
  max-width: 60px;
  padding: 0.5rem 0;
}
.sidebar.collapsed .nav-link span {
  display: none;
}
.sidebar.collapsed .nav-icon {
  margin: 0 auto;
}

注意:不要用 width: 0 → width: 250px,这会导致子元素布局重算,图标/文字可能错位;max-width 更安全,且能配合 min-width 设最小可交互宽度。

用 Bootstrap Collapse 触发器绑定宽度切换

可以复用 data-bs-toggle="collapse" 的点击行为,但别让它控制侧边栏本身——而是让它切换一个中间按钮或隐藏控件,再由 JS 响应并操作 sidebar 类名。

VPS Bootstrap
VPS Bootstrap

从零启动全新 VPS,完成 OpenClaw 完整部署,包括备份/恢复及恢复后验证。用于 OpenClaw 部署。

下载
  • 把 data-bs-toggle="collapse" 放在折叠按钮上,目标设为一个空 ,仅用来捕获事件
  • 监听 shown.bs.collapse / hidden.bs.collapse 事件,手动切 .sidebar 的 .collapsed 类
  • 务必调用 myCollapse.hide() 或 myCollapse.show() 后再操作 DOM,否则事件可能未就绪

示例 JS 片段:

const sidebar = document.querySelector('.sidebar');
const collapseBtn = document.querySelector('[data-bs-toggle="collapse"]');
const bsCollapse = new bootstrap.Collapse(collapseBtn, { toggle: false });

collapseBtn.addEventListener('click', () => {
  if (sidebar.classList.contains('collapsed')) {
    sidebar.classList.remove('collapsed');
    bsCollapse.show();
  } else {
    sidebar.classList.add('collapsed');
    bsCollapse.hide();
  }
});

移动端适配和 hover 展开的冲突点

在小屏(md 以下)通常希望侧边栏默认收起、点击才展开;但桌面端又想保留 hover 展开能力。这时候纯 CSS 的 :hover 会和 JS 控制的 .collapsed 类打架。

  • 用媒体查询隔离:桌面端启用 @media (min-width: 768px) 内的 .sidebar:hover 规则,移动端禁用
  • JS 中检测 window.matchMedia,避免在移动端监听 mouseenter
  • 折叠按钮在移动端必须始终可见,且 aria-expanded 要同步更新,不然屏幕阅读器会误判状态

容易被忽略的是:当用户从桌面缩放窗口到移动端时,.collapsed 类还在,但布局已切换成 offcanvas 模式——此时应监听 resize 并清掉该类,交由 Bootstrap 的 offcanvas 统一接管。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3143

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6883

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7690

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7678

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

bootstrap框架介绍
bootstrap框架介绍

本专题整合了bootstrap框架相关介绍,阅读专题下面的文章了解更多详细内容。

2026.03.18

825

21

bootstrap安装教程
bootstrap安装教程

本专题整合了bootstrap安装相关教程,阅读专题下面的文章了解更多详细操作教程。

2026.03.18

219

9

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
李炎恢bootstrap视频教程
李炎恢bootstrap视频教程

共26课时 | 10.9万人学习

兄弟连张诚Bootstrap视频教程
兄弟连张诚Bootstrap视频教程

共21课时 | 5.2万人学习

Bootstrap.用户界面架构视频教程
Bootstrap.用户界面架构视频教程

共35课时 | 9.1万人学习