本文旨在解决 Django 项目中 Bootstrap 下拉菜单无法正常工作的问题。通过检查 Bootstrap 版本、引入正确的 JavaScript 文件、使用正确的 data-bs-toggle 属性，并确保用户已认证，可以有效地解决此问题，使下拉菜单在 Django 模板中正常显示和交互。
在使用 Django 框架开发 Web 应用时，经常会使用 Bootstrap 来快速构建美观且响应式的用户界面。然而，有时会遇到 Bootstrap 的下拉菜单（dropdown）在 Django 模板中无法正常工作的情况，点击菜单项没有任何反应。本文将详细介绍如何解决这个问题。
1. 确认 Bootstrap 版本
首先，要确保你使用的 Bootstrap 版本与你的代码相匹配。Bootstrap 3 和 Bootstrap 4 使用 data-toggle="dropdown" 属性，而 Bootstrap 5 及更高版本则使用 data-bs-toggle="dropdown" 属性。
2. 引入正确的 JavaScript 文件
Bootstrap 的下拉菜单功能依赖于 JavaScript 文件。请确保在你的 Django 模板中正确引入了 Bootstrap 的 JavaScript 文件，并且 jQuery（如果 Bootstrap 版本需要）也在 Bootstrap 的 JavaScript 文件之前引入。
通常，你需要在 HTML 文件的
标签的末尾， 标签之前引入 JavaScript 文件。例如：<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
或者，如果你使用的是本地文件：
<script src="{% static 'js/jquery-3.6.0.min.js' %}"></script>
<script src="{% static 'js/bootstrap.bundle.min.js' %}"></script>注意： 确保 jquery-3.6.0.min.js 和 bootstrap.bundle.min.js 文件的路径是正确的。
3. 使用正确的 data-bs-toggle 属性
如果使用的是 Bootstrap 5 或更高版本，请确保使用 data-bs-toggle="dropdown" 属性，而不是 data-toggle="dropdown"。
例如：
<li class="nav-item">
<a class="nav-link dropdown-toggle" href="#" id="userMenu"
data-bs-toggle="dropdown" aria-haspopup="true"
aria-expanded="false">
{{ user.username }}
</a>
<div class="dropdown-menu dropdown-menu-right"
aria-labelledby="userMenu">
<a class="dropdown-item" href="#">Upload</a>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="#">Log Out</a>
</div>
</li>4. 检查用户认证状态
在某些情况下，下拉菜单可能只在用户认证后才显示。请确保你的代码逻辑正确处理了用户认证状态。
例如，在 Django 模板中：
{% if user.is_authenticated %}
<ul class="navbar-nav ms-auto">
<li class="nav-item">
<a class="nav-link dropdown-toggle" href="#" id="userMenu"
data-bs-toggle="dropdown" aria-haspopup="true"
aria-expanded="false">
{{ user.username }}
</a>
<div class="dropdown-menu dropdown-menu-right"
aria-labelledby="userMenu">
<a class="dropdown-item" href="{% url 'upload'%}">Upload</a>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="{% url 'logout' %}">Log Out</a>
</div>
</li>
</ul>
{% else %}
<form class="form-inline ms-auto">
<a href="{% url 'login' %}" class="btn btn-outline-secondary">Log In</a>
<a href="{% url 'signup' %}" class="btn btn-primary ms-2">Sign up</a>
</form>
{% endif %}5. 示例代码
下面是一个完整的示例代码，展示了如何在 Django 模板中使用 Bootstrap 5 的下拉菜单：
{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Bootstrap Dropdown Example</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css">
</head>
<body>
<nav class="navbar navbar-expand-lg navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">My Website</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarNavDropdown">
<ul class="navbar-nav">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#">Home</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Features</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Pricing</a>
</li>
{% if user.is_authenticated %}
<li class="nav-item dropdown">
<a class="nav-link dropdown-toggle" href="#" id="navbarDropdownMenuLink" role="button" data-bs-toggle="dropdown" aria-expanded="false">
{{ user.username }}
</a>
<ul class="dropdown-menu" aria-labelledby="navbarDropdownMenuLink">
<li><a class="dropdown-item" href="{% url 'upload' %}">Upload</a></li>
<li><a class="dropdown-item" href="{% url 'logout' %}">Logout</a></li>
</ul>
</li>
{% else %}
<li class="nav-item">
<a class="nav-link" href="{% url 'login' %}">Login</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{% url 'signup' %}">Signup</a>
</li>
{% endif %}
</ul>
</div>
</div>
</nav>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>6. 总结
解决 Django 模板中 Bootstrap 下拉菜单无法工作的问题，需要仔细检查 Bootstrap 版本、引入正确的 JavaScript 文件、使用正确的 data-bs-toggle 属性，并确保用户已认证。通过以上步骤，可以有效地解决此问题，使下拉菜单在 Django 模板中正常显示和交互。记住，仔细阅读 Bootstrap 官方文档是解决问题的最佳途径。
