解决 Django 模板中 Bootstrap 下拉菜单无法工作的问题-html教程-PHP中文网

解决 Django 模板中 Bootstrap 下拉菜单无法工作的问题

花韻仙語

发布： 2025-09-24 22:07:02

原创

611人浏览过

解决 django 模板中 bootstrap 下拉菜单无法工作的问题

本文旨在解决 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 文件的 <body> 标签的末尾，</body> 标签之前引入 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 文件的路径是正确的。

Softr Studio

最简单的无代码web开发平台

查看详情

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 官方文档是解决问题的最佳途径。

以上就是解决 Django 模板中 Bootstrap 下拉菜单无法工作的问题的详细内容，更多请关注php中文网其它相关文章！