一、简介
Dropdown 就是下拉列表, 有一个例子。
Dropdown 的完整代码如下:
{提示}
.dropdown-toggle
这个类不是必须的,不过稍后讲到 Dropdown 的 JavaScript 代码调用时要使用它,所以为了方便,先在这里一并写入。#dropdownWrapper
表示 Dropdown 的容器,可根据具体情况命名,稍后讲到事件回调时,要用到它。
默认的 Dropdown 是隐藏的,让它出现有两种方式:
- 标签 API
- JavaScript 代码
二、通过标签 API
- 在
.dropdown-toggle
上添加data-toggle="dropdown"
(重申:.dropdown-toggle
不是必须添加的)。 - 下拉菜单
<ul>
添加.dropdown-menu
。
三、通过 JavaScript 代码
使用 $('.dropdown-toggle').dropdown('toggle');
可以让下拉框展开。
{注意} 无论是使用标签 API 还是 JavaScript 代码,
data-toggle="dropdown"
始终要写上。
四、Dropdown 的事件回调
Dropdown 回调事件总是在 .dropdown-menu
的父元素上触发(此处指 #dropdownWrapper
)。事件种类主要有四个:
show.bs.dropdown
:在 Dropdown 显示时触发。shown.bs.dropdown
:在 Dropdown 显示之后触发。hide.bs.dropdown
:在 Dropdown 隐藏时触发。hidden.bs.dropdown
:在 Dropdown 隐藏之后触发。
举个例子:
$('#dropdownWrapper').on('shown.bs.dropdown', function showDropdown() { console.log('Dropdown is showed!');});
五、设备可访问性
为了提高代码的设备可访问性,我们给 Dropdown 添加一些额外代码。
- 在
#btnTargetDropdownMenu
上:添加aria-haspopup="true"
,表示有子菜单。 - 在
#btnTargetDropdownMenu
上:添加aria-expanded="false"
,表示菜单现在没有展开。 - 在
.dropdown-menu
上:添加aria-labelledby="..."
,值为受指向标签的id
,在这里等同于设置aria-label="Dropdown"
,屏幕阅读器读到这里时,就会读出Dropdown
这个单词。
六、参考链接
(完)