0

0

如何修复 Bootstrap 4 下拉菜单(Dropdown)不展开的问题

聖光之護

聖光之護

发布时间:2026-01-27 13:54:18

|

116人浏览过

|

来源于php中文网

原创

如何修复 Bootstrap 4 下拉菜单(Dropdown)不展开的问题

bootstrap 4 下拉菜单无法展开,通常是因为缺少必要的 javascript 依赖(如 popper.js 和 bootstrap js)、未正确引入资源、或 html 结构不符合规范;本文提供完整排查与修复方案。

要使 Bootstrap 4 的下拉菜单正常工作,仅写对 HTML 是不够的——它高度依赖 JavaScript(特别是 bootstrap.bundle.min.js 或独立的 popper.min.js + bootstrap.min.js)来初始化交互行为。以下是从基础到进阶的系统性解决方案:

✅ 1. 确保正确引入 Bootstrap 4 资源(关键!)

Bootstrap 4 的 dropdown 组件需要:

  • jQuery(v3.0+,Bootstrap 4 官方依赖)
  • Popper.js(v1.x,用于定位下拉框)
  • Bootstrap JS(含 dropdown 插件)

推荐使用 bootstrap.bundle.min.js(已内置 Popper.js),避免手动管理依赖顺序:

<!-- 在 base.html 或 layout 模板的 <head> 或页面底部(推荐) -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/css/bootstrap.min.css" rel="stylesheet">
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/js/bootstrap.bundle.min.js"></script>

⚠️ 注意:

  • 不要同时引入 bootstrap.min.js 和 bootstrap.bundle.min.js;
  • jQuery 必须在 Bootstrap JS 之前加载;
  • 若使用本地文件,请确认路径无误(可通过浏览器开发者工具 → Network 标签检查 404)。

✅ 2. 验证 HTML 结构是否符合 Bootstrap 4 规范

你当前的代码结构基本正确,但需确保:

  • .dropdown 容器存在(✅ 已有);
  • 按钮含 data-toggle="dropdown"(✅ 已有);
  • 下拉菜单为 .dropdown-menu,且是按钮的同级兄弟元素(✅ 符合);
  • 无多余嵌套或 CSS 干扰(如 display: none、visibility: hidden、z-index 冲突等)。

✅ 推荐精简验证用的最小可运行片段(可直接复制测试):

Keevx
Keevx

一款专为海外中小企业和创作者打造的AI数字人视频创作平台

下载
<div class="dropdown d-inline-block">
  <button class="btn btn-primary dropdown-toggle" type="button" data-toggle="dropdown">
    <i class="fa fa-bars"></i> All Categories
  </button>
  <div class="dropdown-menu">
    <a class="dropdown-item" href="{% url 'products' %}">All Products</a>
    <a class="dropdown-item" href="{% url 'products' %}?category=price">By Price</a>
    <a class="dropdown-item" href="{% url 'products' %}?category=rating">By Rating</a>
    <a class="dropdown-item" href="{% url 'products' %}?category=weight">By Weight</a>
  </div>
</div>
? 小提示:你代码中拼写错误 wheight → 应为 weight(已在示例中修正)。

✅ 3. 排查常见故障点

打开浏览器开发者工具(F12),依次检查:

检查项 方法 问题表现
JS 是否加载成功 Console 标签页 → 输入 $.fn.dropdown 返回 undefined → jQuery 或 Bootstrap JS 未加载
是否有 JS 报错 Console 标签页顶部红字 如 Popper is not defined → 缺少 Popper 或 bundle 未生效
DOM 是否渲染正确 Elements 标签页 → 查看 .dropdown-menu 是否存在 若存在但不可见 → 检查 CSS(如 opacity: 0, transform: translateY(-10px) 等)
事件是否绑定 点击按钮后,在 Elements 中查看 .dropdown-menu 是否动态添加了 show 类 无 show 类 → JS 初始化失败

✅ 4. 手动初始化(备用方案)

若自动初始化失效,可在页面加载后显式调用:

<script>
  $(function() {
    $('.dropdown').dropdown(); // 初始化所有下拉组件
  });
</script>

或针对单个元素:

<script>
  $('#myDropdownBtn').dropdown('toggle');
</script>

✅ 总结:三步快速修复

  1. 引入正确资源:jQuery + bootstrap.bundle.min.js(CDN 或本地);
  2. 校验结构:确保 .dropdown 容器、data-toggle="dropdown"、.dropdown-menu 兄弟关系;
  3. 浏览器调试:用 Console 和 Elements 面板验证 JS 加载、报错和 DOM 状态。

只要资源加载无误、结构合规,Bootstrap 4 下拉菜单即可开箱即用——无需额外 CSS 或自定义 JS。坚持从依赖入手排查,90% 的“不展开”问题都能迎刃而解。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
jquery插件有哪些
jquery插件有哪些

jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

156

2023.09.12

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

jquery删除元素的方法
jquery删除元素的方法

jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

407

2023.11.10

jQuery hover()方法的使用
jQuery hover()方法的使用

hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

516

2023.12.04

jquery实现分页方法
jquery实现分页方法

在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

312

2023.12.06

jquery中隐藏元素是什么
jquery中隐藏元素是什么

jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

129

2024.02.23

jquery中什么是高亮显示
jquery中什么是高亮显示

jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2024.02.23

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

c++ 字符处理
c++ 字符处理

本专题整合了c++字符处理教程、字符串处理函数相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.03.17

热门下载

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

精品课程

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

共14课时 | 1.0万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.7万人学习

CSS教程
CSS教程

共754课时 | 44.1万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号