bootstrap下拉菜单
1 .dropdown-menu { 2 position: absolute; 3 top: 100%; 4 left: 0; 5 z-index: 1000; 6 display: none; 7 float: left; 8 min-width: 160px; 9 padding: 5px 0; 10 margin: 2px 0 0; 11 font-size: 14px; 12 text-align: left; 13 list-style: none; 14 background-color: #fff; 15 -webkit-background-clip: padding-box; 16 background-clip: padding-box; 17 border: 1px solid #ccc; 18 border: 1px solid rgba(0, 0, 0, .15); 19 border-radius: 4px; 20 -webkit-box-shadow: 0 6px 12px rgba(0, 0, 0, .175); 21 box-shadow: 0 6px 12px rgba(0, 0, 0, .175); 22 }
对于一个下拉菜单来说,最重要的就是下拉区域的定位问题,bootstrap通过top:100%这个属性设置,轻松地完成下拉菜单的定位问题,不需要任何的js计算操作。 细心的话就会发现,只要控制下拉元素的display就可以简单地实现下拉的效果,不过bs为了兼容更多的场景,加入动画的效果,js的处理也并不简单。下面分析理解dropdown.js的源码。
1 $(document) 2 .on('click.bs.dropdown.data-api', clearMenus)//目的是为了在展开下拉菜单后,再次点击页面任何区域都能隐藏之前已经展开的菜单,考虑的是一个页面中存在多个下拉菜单的情况,但是也有一个问题,就是点击展开的下拉菜单里面的菜单项,同样会隐藏菜单,这在不需要隐藏菜单的场景中将会是一个问题 3 .on('click.bs.dropdown.data-api', '.dropdown form', function (e) { e.stopPropagation() })//假如下拉菜单里有表单元素时,通过冒泡阻止菜单的隐藏,就是阻止第一行代码里的监听器响应点击事件 4 .on('click.bs.dropdown.data-api', toggle, Dropdown.prototype.toggle)//自动注册dropdown组件 5 .on('keydown.bs.dropdown.data-api', toggle, Dropdown.prototype.keydown)//在toggle元素获取焦点后,允许按向下箭头展开菜单 6 .on('keydown.bs.dropdown.data-api', '[role="menu"]', Dropdown.prototype.keydown)//允许在展开菜单后,可以通过向上向下箭头,切换菜单项 7 .on('keydown.bs.dropdown.data-api', '[role="listbox"]', Dropdown.prototype.keydown)//允许在展开菜单后,可以通过向上向下箭头,切换菜单项
关于对click.bs.drop.data-api的理解
①首先,Jquery的API
1 events,[selector],[data],fnV1.7 2 3 events:一个或多个用空格分隔的事件类型和可选的命名空间,如"click"或"keydown.myPlugin"
关于参数[selector]
,你可以简单地理解为:如果该参数等于null
或被省略,则为当前匹配元素绑定事件;否则就是为当前匹配元素的后代元素中符合selector
选择器的元素绑定事件。
1 var backdrop = '.dropdown-backdrop' 2 var toggle = '[data-toggle="dropdown"]' 3 var Dropdown = function (element) { 4 $(element).on('click.bs.dropdown', this.toggle) 5 } 6 7 Dropdown.VERSION = '3.3.4' 8 9 function Plugin(option) { 10 return this.each(function () { 11 var $this = $(this) 12 var data = $this.data('bs.dropdown') 13 14 if (!data) $this.data('bs.dropdown', (data = new Dropdown(this))) 15 if (typeof option == 'string') data[option].call($this) 16 }) 17 } 18 19 var old = $.fn.dropdown 20 21 $.fn.dropdown = Plugin 22 $.fn.dropdown.Constructor = Dropdown 23 24 25 // DROPDOWN NO CONFLICT 26 // ==================== 27 28 $.fn.dropdown.noConflict = function () { 29 $.fn.dropdown = old 30 return this 31 }
1 Dropdown.prototype.toggle = function (e) { 2 var $this = $(this) 3 4 if ($this.is('.disabled, :disabled')) return 5 6 var $parent = getParent($this)//getParent方法用来获取父元素,不过这个父元素很有可能不是dom结构上的父节点,而是通过data-target或者href指定的某个dom元素,所以才有专门的一个方法来写 7 var isActive = $parent.hasClass('open')//父元素有open类,则说明菜单当前是已经展开的 8 9 clearMenus()//先清空已经展开的所有菜单 10 11 //只有在菜单未展开的时候才进行以下逻辑处理 12 if (!isActive) { 13 if ('ontouchstart' in document.documentElement && !$parent.closest('.navbar-nav').length) { 14 // if mobile we use a backdrop because click events don't delegate 15 $('<div class="dropdown-backdrop"/>').insertAfter($(this)).on('click', clearMenus) 16 } 17 //以上代码的目的是为了在移动端里展开菜单后,点击页面任何区域都能隐藏菜单,因为bs的事件都是通过代理注册的监听器,而click事件在移动端里如果是通过代理注册的,不会执行相应的监听器,所以bs才用了backdrop这样的一个元素,替代实现隐藏菜单的功能。 18 19 var relatedTarget = { relatedTarget: this } 20 $parent.trigger(e = $.Event('show.bs.dropdown', relatedTarget)) 21 22 if (e.isDefaultPrevented()) return 23 24 $this 25 .trigger('focus') 26 .attr('aria-expanded', 'true') 27 28 $parent 29 .toggleClass('open') 30 .trigger('shown.bs.dropdown', relatedTarget) 31 } 32 33 return false 34 } 35 36 Dropdown.prototype.keydown = function (e) { 37 if (!/(38|40|27|32)/.test(e.which) || /input|textarea/i.test(e.target.tagName)) return 38 //如果按键不是向上向下箭头,空格和ESC键,或者按键是为了在文本控件里输入字符,就不做以下处理 39 //注意按下回车键,会触发click事件!!! 40 41 var $this = $(this) 42 43 e.preventDefault() 44 e.stopPropagation() 45 46 if ($this.is('.disabled, :disabled')) return 47 48 var $parent = getParent($this) 49 var isActive = $parent.hasClass('open') 50 51 if ((!isActive && e.which != 27) || (isActive && e.which == 27)) { 52 //实现的就是按向上向下和空格键展开菜单,再按esc键隐藏菜单。。。 53 if (e.which == 27) $parent.find(toggle).trigger('focus')//这里需要用find(toggle)的原因是因为,$this有可能是[role=menu]的dom元素而不是data-toggle元素 54 return $this.trigger('click') 55 } 56 57 var desc = ' li:not(.disabled):visible a' 58 var $items = $parent.find('[role="menu"]' + desc + ', [role="listbox"]' + desc) 59 60 if (!$items.length) return 61 62 var index = $items.index(e.target) 63 64 if (e.which == 38 && index > 0) index-- // 按向上键,index-- 65 if (e.which == 40 && index < $items.length - 1) index++ // 按向下键,index++ 66 if (!~index) index = 0 67 //~index的作用:~3 = -4,~4=-5,~5=-6,~0=-1,~-1=0,~-2=1,~-3=2,其实没必要搞这种写法,尼玛。。。 68 69 $items.eq(index).trigger('focus') 70 } 71 72 function clearMenus(e) { 73 if (e && e.which === 3) return 74 $(backdrop).remove() 75 $(toggle).each(function () { 76 var $this = $(this) 77 var $parent = getParent($this) 78 var relatedTarget = { relatedTarget: this } 79 80 if (!$parent.hasClass('open')) return 81 82 $parent.trigger(e = $.Event('hide.bs.dropdown', relatedTarget)) 83 84 if (e.isDefaultPrevented()) return 85 86 $this.attr('aria-expanded', 'false') 87 $parent.removeClass('open').trigger('hidden.bs.dropdown', relatedTarget) 88 }) 89 } 90 91 function getParent($this) { 92 var selector = $this.attr('data-target') 93 94 if (!selector) { 95 selector = $this.attr('href') 96 selector = selector && /#[A-Za-z]/.test(selector) && selector.replace(/.*(?=#[^\s]*$)/, '') // strip for ie7 97 } 98 99 var $parent = selector && $(selector) 100 101 return $parent && $parent.length ? $parent : $this.parent() 102 }
cncncn