Dropdown

• Action
• Another action
• Something else here

• HTML
• CSS
• javascript

Dropdown

• Action
• Another action
• Something else here
• Separated link

Dropdown

• 第一部分菜单头部
• 下拉菜单项
• 下拉菜单项
• 第二部分菜单头部
• 下拉菜单项

默认是块级元素，撑满父级宽度。这里，需要为该元素设置inline-block和margin-left，使其内容撑开宽度，且距离左侧有一定距离

display: inline-block;

margin-left: 60px;

【菜单项状态】

下拉菜单项的默认的状态有悬浮状态(:hover)和焦点状态(:focus)

.dropdown-menu > li > a:hover,

.dropdown-menu > li > a:focus {

color: #262626;

text-decoration: none;

background-color: #f5f5f5;

}

下拉菜单项除了上面两种状态，还有当前状态(.active)和禁用状态(.disabled)。这两种状态使用方法只需要在对应的菜单项上添加对应的类名

JS触发

和模态弹出窗一样，Bootstrap框架中的下拉菜单也支持JavaScript方法触发下拉菜单显示。但是，要特点注意的是，即使使用JS触发，也不能去掉触发元素的data-toggle="dropdown"

;$(function(){

$('.dropdown-toggle').dropdown()

});

【toggle】

和Modal一样，dropdown也接收字符串作为参数进行传递，参数可以是"toggle"

但是，这非常不好用。每次单击都要两次toggle，就会一直是一个不变的状态。所以，一般情况下，使用不带参数的方法。就算需要使用参数“toggle”，也建议使用jQuery的one方法

$(".dropdown-toggle").one("click",function(){

$(this).dropdown("toggle");

})

【事件订阅】

与Modal类似，下拉菜单支持4种类型的事件订阅，分别对应下拉菜单的弹出前、弹出后、关闭前、关闭后

show.bs.dropdown 在show方法调用时立即触发(尚未显示之前)

shown.bs.dropdown 在下拉菜单完全显示给用户之后(并且等CSS动画完成之后)触发

hide.bs.dropdown 在hide方法调用时(但还未关闭隐藏)立即触发

hidden.bs.dropdown 在下拉菜单完全隐藏之后(并且等CSS动画完成之后)触发

;$(function(){

$('.dropdown').on('show.bs.dropdown',function(){

$('.dropdown-toggle').html('关闭');

});

$('.dropdown').on('hide.bs.dropdown',function(){

$('.dropdown-toggle').html('打开');

});

});

JS源码

【1】IIFE

使用立即调用函数，防止插件内代码外泄，从而形成一个闭环，并且只能从jQuery的fn里进行扩展

+function ($) { //使用es5严格模式

'use strict'; //}(window.jQuery);

【2】初始设置

//弹出下拉菜单时的蒙版样式

var backdrop = '.dropdown-backdrop'

//dropdown触发元素的自定义属性

var toggle = '[data-toggle="dropdown"]'

var Dropdown = function (element) {

//插件类函数定义，一旦触发，就在click事件上绑定toggle，所以不能再用自定义代码进行toggle了

$(element).on('click.bs.dropdown', this.toggle)

}

//版本号为'3.3.7'

Dropdown.VERSION = '3.3.7'

【3】插件核心代码

//获取下拉菜单的父元素容器

function getParent($this) {

//获取触发元素的'data-target'特性值，表示下拉菜单的父元素容器的选择器

var selector = $this.attr('data-target')

//如果触发元素没有设置'data-target'

if (!selector) {

//获取触发元素的'href'特性值，表示下拉菜单的父元素容器的选择器

selector = $this.attr('href')

//该值是所弹出元素的id值

selector = selector && /#[A-Za-z]/.test(selector) && selector.replace(/.*(?=#[^\s]*$)/, '') // strip for ie7

}

//通过选择器，来获取下拉菜单的父元素容器

var $parent = selector && $(selector)

//如果找到，说明触发元素确实在下拉菜单外部，则返回找到的下拉菜单的父元素容器即可

//如果没有找到，说明触发元素在下拉菜单内部，则返回它的直接父级元素

return $parent && $parent.length ? $parent : $this.parent()

}

//关闭所有的下拉菜单

function clearMenus(e) {

//如果点击的是鼠标右键，则直接返回

if (e && e.which === 3) return

//删除用于移动设备的蒙版

$(backdrop).remove()

//根据选择器，遍历所有的dropdown标记，然后全部关闭

$(toggle).each(function () {

var $this = $(this)

var $parent = getParent($this)

var relatedTarget = { relatedTarget: this }

//如果下拉菜单的父元素容器没有open类名，则直接返回

if (!$parent.hasClass('open')) return

//如果触发了鼠标单击事件，并且鼠标事件的目标元素是input或textarea，则直接返回

if (e && e.type == 'click' && /input|textarea/i.test(e.target.tagName) && $.contains($parent[0], e.target)) return

//关闭前，触发hide事件

$parent.trigger(e = $.Event('hide.bs.dropdown', relatedTarget))

//如果阻止了默认行为，则直接返回

if (e.isDefaultPrevented()) return

$this.attr('aria-expanded', 'false')

//关闭后，触发hidden事件

$parent.removeClass('open').trigger($.Event('hidden.bs.dropdown', relatedTarget))

})

}

//控制下拉菜单的打开、关闭操作

Dropdown.prototype.toggle = function (e) {

var $this = $(this)

//如果有禁用标记，则不处理

if ($this.is('.disabled, :disabled')) return

//获取下拉菜单的父元素容器

var $parent = getParent($this)

//判断下拉菜单的父元素容器是否有open样式

var isActive = $parent.hasClass('open')

//关闭所有的下拉菜单

clearMenus()

//如果是，在clearMenus阶段已经关闭了，所以不需要再次关闭

//如果不是，说明默认是关闭状态，则需要展开下拉菜单

if (!isActive) {

//如果是移动设置，则使用dropdown-backdrop样式，因为移动设备不支持click单击委托

if ('ontouchstart' in document.documentElement && !$parent.closest('.navbar-nav').length) {

$(document.createElement('div'))

.addClass('dropdown-backdrop')

.insertAfter($(this))

.on('click', clearMenus)

}

var relatedTarget = { relatedTarget: this }

//展开下拉菜单前，触发show事件

$parent.trigger(e = $.Event('show.bs.dropdown', relatedTarget))

//如果阻止了默认行为，则直接返回

if (e.isDefaultPrevented()) return

$this

//设置focus样式

.trigger('focus')

.attr('aria-expanded', 'true')

$parent

//设置open样式

.toggleClass('open')

//展开下拉菜单后，触发shown事件

.trigger($.Event('shown.bs.dropdown', relatedTarget))

}

return false

}

//利用键盘控制下拉菜单

Dropdown.prototype.keydown = function (e) {

//如果按键不是esc、或上下方向键、或空格键，或者目标元素是input或textarea控件，则忽略处理

if (!/(38|40|27|32)/.test(e.which) || /input|textarea/i.test(e.target.tagName)) return

var $this = $(this)

//阻止默认行为及冒泡

e.preventDefault()

e.stopPropagation()

//如果有禁用标记，则不做处理

if ($this.is('.disabled, :disabled')) return

//获取下拉菜单的父元素容器

var $parent = getParent($this)

//判断父元素是否有open样式

var isActive = $parent.hasClass('open')

//如果有open样式并且按键不是向下箭头，或者没有open样式并且按键是向下箭头，也打开下拉菜单

if (!isActive && e.which != 27 || isActive && e.which == 27) {

//如果按下向下箭头，则给触发元素加上焦点

if (e.which == 27) $parent.find(toggle).trigger('focus')

//触发单击事件

return $this.trigger('click')

}

//返回可以利用箭头选择的下拉菜单项

//必须是可见的a链接，并且不包括分隔符

var desc = ' li:not(.disabled):visible a'

var $items = $parent.find('.dropdown-menu' + desc)

//如果没有，则不做处理

if (!$items.length) return

//找出当前处理焦点状态的第一个下拉菜单项的索引

var index = $items.index(e.target)

//按向上箭头，index-1

if (e.which == 38 && index > 0) index--

//按向下箭头，index+1

if (e.which == 40 && index < $items.length - 1) index++

//当index为-1时，置为0

if (!~index) index = 0

//给所选择的菜单项设置焦点

$items.eq(index).trigger('focus')

}

【4】jQuery插件定义

function Plugin(option) {

//根据选择器，遍历所有符合规则的元素

return this.each(function () {

var $this = $(this)

//获取自定义属性bs.dropdown的值

var data = $this.data('bs.dropdown')

//如果值不存在，则将Dropdown实例设置为bs.dropdown值

if (!data) $this.data('bs.dropdown', (data = new Dropdown(this)))

//如果option传递了string，则表示要执行某个方法

if (typeof option == 'string') data[option].call($this)

})

}

var old = $.fn.dropdown

//保留其他库的$.fn.modal代码(如果定义的话)，以便在noConflict之后可以继续使用该老代码

$.fn.dropdown = Plugin

//重设插件构造器，可以通过该属性获取插件的真实类函数

$.fn.dropdown.Constructor = Dropdown

【5】防冲突处理

$.fn.dropdown.noConflict = function () {

//恢复以前的旧代码

$.fn.dropdown = old

//将$.fn.dropdown.noConflict()设置为Bootstrap的Dropdown插件

return this

}

【6】绑定触发事件

$(document)

//为声明式的HTML绑定单击事件，在单击以后先关闭所有的下拉菜单

.on('click.bs.dropdown.data-api', clearMenus)

//如果内部有form元素，则阻止冒泡，不做其他处理

.on('click.bs.dropdown.data-api', '.dropdown form', function (e) { e.stopPropagation() })

//绑定单击事件，执行toggle()方法

.on('click.bs.dropdown.data-api', toggle, Dropdown.prototype.toggle)

//绑定键盘keydown事件，执行keydown()方法

.on('keydown.bs.dropdown.data-api', toggle, Dropdown.prototype.keydown)

//为dropdown-menu绑定键盘keydown事件，执行keydown()方法

.on('keydown.bs.dropdown.data-api', '.dropdown-menu', Dropdown.prototype.keydown)