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

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

秋枫吖_8340

秋枫吖_8340

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

|

156人浏览过

|

来源于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 规范

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

java后端编程
java后端编程

专用于 Java Spring Boot 后端开发的专业技能。当用户提出以下需求时,应调用此技能:构建 REST API、创建 Spring Boot 项目、编写 Java 后端服务、配置数据库访问(JPA / MyBatis)、处理认证与授权(Spring Security / JWT)、实现微服务架构(Spring Cloud)、排查 Spring Boot 相关错误、审查 Java 代码质量,或执行任何与 Spring Boot / Java 后端相关的任务。

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

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

<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是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

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

WorkBuddy

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

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

超级简历WonderCV

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

相关专题

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

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

601

2023.09.12

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

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

1136

2023.10.13

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

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

2242

2023.11.10

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

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

2148

2023.12.04

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

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

493

2023.12.06

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

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

337

2024.02.23

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

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

766

2024.02.23

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

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

289

2026.01.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

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

精品课程

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

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 6.1万人学习

CSS教程
CSS教程

共754课时 | 98.8万人学习

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

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