为什么Bootstrap 5弃用jQuery_原生JS与CSS动画如何替代旧交互

作者：袖梨 2026-07-23

Bootstrap 5 报 TypeError: $ is not a function 是因彻底移除 jQuery 依赖，需删除 jQuery 引入、改用原生 API 初始化组件（如 new bootstrap.Modal()）、动态元素需手动初始化，并用 CSS transition 替代 jQuery 动画。

Bootstrap 5 报 `TypeError: $ is not a function` 怎么办

因为 Bootstrap 5 彻底删掉了 jQuery 依赖，所有 JS 组件（Modal、Dropdown、Toast 等）都重写为原生 DOM API + ES6+ 类。只要代码里还留着 $().modal('show') 或 $('.dropdown').dropdown()，浏览器就直接报这个错。

实操建议：

删掉项目中所有 jquery.min.js 或 jquery.slim.js 的引入（除非其他插件强依赖）
确保 Bootstrap 5 的 JS 文件（如 bootstrap.bundle.min.js）已正确加载，且在你的自定义脚本之前执行
把旧写法逐个替换：比如 $('#myModal').modal('show') → new bootstrap.Modal(document.getElementById('myModal')).show()
注意全局对象名是 bootstrap（小写），不是 Bootstrap 或 BS

`data-bs-toggle` 还能用吗？为什么动态插入的 HTML 不生效

能用，但只对「页面加载时已存在的元素」自动初始化。Bootstrap 5 启动时会扫描 DOM，匹配 data-bs-toggle="modal" 这类属性并调用对应构造器 —— 这个过程只跑一次。

常见错误现象：

立即学习“前端免费学习笔记（深入）”；

用 innerHTML 或 insertAdjacentHTML 动态加了个带 data-bs-toggle="dropdown" 的按钮，点不动
Vue/React 渲染后组件没反应，控制台也没报错

原因很简单：Bootstrap 不监听 DOM 变化，也不会劫持 innerHTML。它不提供 MutationObserver 自动补救。

实操建议：

动态插入后，手动初始化：例如 const dropdownEl = document.querySelector('.my-dynamic-dropdown'); new bootstrap.Dropdown(dropdownEl);
避免混用：不要一边写 data-bs-toggle，一边又 new bootstrap.Dropdown(...)，否则事件监听可能重复绑定
确认元素存在再初始化：if (dropdownEl) { new bootstrap.Dropdown(dropdownEl); }

原生 JS 替代 jQuery 的关键操作有哪些

不是简单改函数名，而是整套交互范式变了。核心替换点集中在 DOM 查询、事件绑定、类名操作和动画触发上。

常见对比与注意事项：

$('.btn') → document.querySelectorAll('.btn')（返回 NodeList，不是数组，需 [...] 展开或用 forEach）
$(el).on('click', handler) → el.addEventListener('click', handler)（注意：事件目标是元素本身，不是 jQuery 对象）
$(el).addClass('active') → el.classList.add('active')（classList 是原生 API，支持 toggle/replace）
动画不再靠 .fadeIn()，而是靠 CSS transition + 切换类，比如 el.classList.add('fade-in') 配合 .fade-in { opacity: 1; transition: opacity .15s; }

性能影响：原生操作更快，内存占用更低，但需要自己处理 IE 兼容性（Bootstrap 5 已不支持 IE）。

为什么 CSS 动画 + `transition` 能替代 jQuery 的 `fadeIn`/`slideToggle`

因为 Bootstrap 5 的所有过渡效果（模态框淡入、下拉菜单展开、提示框滑出）全部基于 CSS transition 和 @keyframes 实现，JS 只负责添加/移除类，不操纵内联样式或定时器。

这样做的好处：

硬件加速更稳定（尤其是 opacity、transform）
JS 主线程不卡顿，动画帧率更可靠
可被浏览器 DevTools 的「Animations」面板直接调试

容易踩的坑：

忘记给元素设初始状态：比如 .fade 类默认 opacity: 0，但若没写 transition: opacity .15s，就不会有淡入效果
用 display: none 配合 transition 无效 —— display 不支持过渡，得用 visibility + opacity 或 max-height
手动调用 modal.show() 后，如果 CSS 中 .modal.fade .modal-dialog 缺少 transition，动画就变成硬切