副队长BootStrap5探究(22)--下拉菜单 Dropdown

点此查看 所有教程、项目、源码导航

文章目录

  • [1. 开篇介绍与环境引入](#1. 开篇介绍与环境引入)
  • [2. 使用方法](#2. 使用方法)
    • [2.1 基础下拉菜单](#2.1 基础下拉菜单)
    • [2.2 带分隔线、禁用选项](#2.2 带分隔线、禁用选项)
    • [2.3 菜单右对齐](#2.3 菜单右对齐)
    • [2.4 向上弹出](#2.4 向上弹出)
  • [3. 底层实现关键点解析](#3. 底层实现关键点解析)
  • [4. 小结](#4. 小结)

1. 开篇介绍与环境引入

下拉菜单 Dropdown 用于点击或悬浮弹出菜单列表,常用于导航、按钮附属选项,支持对齐、分隔线、禁用选项等能力,依赖JS交互。

先引入BootStrap相关的环境:

html 复制代码
<!DOCTYPE html>
<html lang="zh-CN">

<head>
    <meta charset="UTF-8">
    <title></title>
    <!-- Bootstrap 5 CSS -->
    <link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.8/css/bootstrap.min.css">
</head>

<body>
    <!-- Bootstrap JS + Popper,用于部分交互 -->
    <script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.8/js/bootstrap.bundle.min.js"></script>
</body>

</html>

2. 使用方法

2.1 基础下拉菜单

外层容器 dropdown,触发按钮添加 data-bs-toggle="dropdown",菜单容器 dropdown-menu,菜单项使用 dropdown-item。

html 复制代码
<div class="dropdown">
    <button class="btn btn-secondary" type="button" data-bs-toggle="dropdown" aria-expanded="false">
        下拉菜单
    </button>
    <ul class="dropdown-menu">
        <li><a class="dropdown-item" href="#">选项一</a></li>
        <li><a class="dropdown-item" href="#">选项二</a></li>
        <li><a class="dropdown-item" href="#">选项三</a></li>
    </ul>
</div>

效果:

2.2 带分隔线、禁用选项

dropdown-divider 用来加分隔线,给 dropdown-item 增加 disabled 实现禁用。

html 复制代码
<div class="dropdown">
    <button class="btn btn-secondary" type="button" data-bs-toggle="dropdown" aria-expanded="false">
        带分隔线
    </button>
    <ul class="dropdown-menu">
        <li><a class="dropdown-item" href="#">选项一</a></li>
        <li><a class="dropdown-item" href="#">选项二</a></li>
        <li><hr class="dropdown-divider"></li>
        <li><a class="dropdown-item disabled" href="#" tabindex="-1">禁用选项</a></li>
    </ul>
</div>

2.3 菜单右对齐

给 dropdown-menu 添加 dropdown-menu-end,菜单向右侧对齐。

html 复制代码
<div class="dropdown">
    <button class="btn btn-secondary" type="button" data-bs-toggle="dropdown" aria-expanded="false">
        右对齐菜单
    </button>
    <ul class="dropdown-menu dropdown-menu-end">
        <li><a class="dropdown-item" href="#">选项A</a></li>
        <li><a class="dropdown-item" href="#">选项B</a></li>
    </ul>
</div>

效果:

2.4 向上弹出

外层换成 dropup,菜单向上弹出。

html 复制代码
<div class="dropup">
    <button class="btn btn-secondary" type="button" data-bs-toggle="dropdown" aria-expanded="false">
        向上弹出
    </button>
    <ul class="dropdown-menu">
        <li><a class="dropdown-item" href="#">上方选项</a></li>
    </ul>
</div>

效果:

3. 底层实现关键点解析

下面是精简复刻版本,去掉大量浏览器兼容代码,只保留核心逻辑。

使用上面的HTML代码,加下面自己写的CSS + JS,能得到基本类似的效果,大家可以尝试下。

css 复制代码
.dropdown {
    /* 相对定位,作为菜单的定位父级 */
    position: relative;
    display: inline-block;
}
.dropdown-menu {
    /* 默认隐藏 */
    position: absolute;
    top: 100%;
    left: 0;
    z-index: 1000;
    min-width: 10rem;
    padding: 0.5rem 0;
    margin: 0.125rem 0 0;
    background-color: #fff;
    border: 1px solid #dee2e6;
    border-radius: 0.375rem;
    /* 默认隐藏 */
    display: none;
}
.dropdown-menu.show {
    display: block;
}
.dropdown-menu-end {
    left: auto;
    right: 0;
}
.dropdown-item {
    display: block;
    width: 100%;
    padding: 0.25rem 1rem;
    clear: both;
    text-align: left;
    color: #212529;
    text-decoration: none;
    background: transparent;
    border: 0;
}
.dropdown-item:hover {
    background-color: #e9ecef;
}
.dropdown-item.disabled {
    color: #6c757d;
    pointer-events: none;
    background-color: transparent;
}
.dropdown-divider {
    height: 0;
    margin: 0.5rem 0;
    overflow: hidden;
    border-top: 1px solid #dee2e6;
}
.dropup .dropdown-menu {
    top: auto;
    bottom: 100%;
    margin-top: 0;
    margin-bottom: 0.125rem;
}
js 复制代码
// 简易复刻 dropdown 核心逻辑
document.querySelectorAll('[data-bs-toggle="dropdown"]').forEach(btn => {
    btn.addEventListener('click', function(e) {
        e.preventDefault();
        const parent = this.closest('.dropdown, .dropup');
        const menu = parent.querySelector('.dropdown-menu');
        // 切换显示隐藏
        menu.classList.toggle('show');
        // 点击页面其他地方关闭菜单
        function closeMenu(event) {
            if (!parent.contains(event.target)) {
                menu.classList.remove('show');
                document.removeEventListener('click', closeMenu);
            }
        }
        setTimeout(()=>{
            document.addEventListener('click', closeMenu);
        },0)
    })
})

基本能实现效果。

4. 小结

  1. 核心容器 dropdown,data-bs-toggle="dropdown" 绑定触发按钮,dropdown-menu 是菜单容器。
  2. dropdown-menu-end 实现右对齐;外层 dropup 让菜单向上弹出。
  3. dropdown-item 是菜单项,disabled 禁用,dropdown-divider 加分隔线。
  4. 原生Bootstrap的下拉底层依赖Popper.js,用来自动处理溢出、翻转位置;上面简易JS只做基础显隐,没有自动定位。
  5. 搭配 aria-expanded 给屏幕阅读器识别当前打开/关闭状态,提升无障碍。
相关推荐
程序员大阳3 天前
副队长BootStrap5探究(17)--分页 Pagination
分页·pagination·bootstrap5
程序员大阳8 天前
副队长BootStrap5探究(8)--输入框组 input group
源码分析·bootstrap5·输入框组·input group
程序员大阳8 天前
副队长BootStrap5探究(10)--复选框 check
源码分析·复选框·bootstrap5·check
程序员大阳9 天前
副队长BootStrap5探究(5)--图片 Image
源码分析·image·图片·bootstrap5
程序员大阳9 天前
副队长BootStrap5探究(7)--表单输入框 form control
text·textarea·bootstrap5·表单输入框·form control·form label
程序员大阳9 天前
副队长BootStrap5探究(3)--彩色链接 Colored link
源码·bootstrap5·彩色链接·colored link
程序员大阳9 天前
副队长BootStrap5探究(6)--画像 Figure (图文组合组件)
源码分析·figure·图文混排·bootstrap5·画像·图文组合
程序员大阳11 天前
副队长BootStrap5教程(1)--序言
教程·背景·bootstrap5·序言
神码编程3 个月前
【Unity】 HTFramework框架(七十)MultiChoiceDropdown可多选的下拉菜单
unity·游戏引擎·ugui·dropdown·下拉菜单