面前的言辞

  网页交互的上时不时会面得上下文菜单或者藏/显示菜单项,Bootstrap默认提供了用于展示链接列表的但是切换、有上下文的菜谱。而且当各种互动状态下的菜系显示需要跟javascript插件配合才能够动用。本文将详细介绍Bootstrap下拉菜单

 

以方法

  以应用Bootstrap框架的下拉菜单时,必须调用Bootstrap框架提供的bootstrap.js文件。当然,如果采取的凡不编译版本,在js文件夹下能够找到一个曰吧“dropdown.js”的文件,也可调用这个js文件

  因为Bootstrap的零部件交互作用都是指让jQuery库写的插件,所以在使bootstrap.js之前一定要是事先加载jquery.js才见面出效果

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<link href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<script src="https://cdn.bootcss.com/jquery/1.12.4/jquery.min.js"></script>
<script src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
</body>
</html>

 

主干用法

  于应用Bootstrap框架中之下拉菜单组件时,其布局下的不错吧非常之要害,如果组织和类名未使用正确,直接影响组件是否会健康下

  1、使用一个称作也“dropdown”的容器包裹了全下拉菜单元素

<div class="dropdown"></div>

  2、使用了一个<button>按钮做也父菜单,并且定义类名“dropdown-toggle”和由定义“data-toggle”属性,且值必须同极外容器类名一致

<button class="btn dropdown-toggle" type="button" data-toggle="dropdown">

  3、下拉菜单项下一个ul列表,并且定义一个类名为“dropdown-menu”

<ul class="dropdown-menu" role="menu">

<div class="dropdown">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
    Dropdown

  </button>
  <ul class="dropdown-menu" aria-labelledby="dropdownMenu1">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
  </ul>
</div>

  4、通过为下拉菜单的父元素设置 .dropup 类,可以被菜单向上弹出(默认是朝着下弹出之)

<div class="dropup">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
    Dropup

  </button>
  <ul class="dropdown-menu" aria-labelledby="dropdownMenu1">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
  </ul>
</div>

 

原理分析

  Bootstrap框架中的下拉菜单组件,其下拉菜单项默认是隐身的,因为“dropdown-menu”默认样式设置了“display:none”;当用户点击父菜单项时,下拉菜单将会给显示出;当用户还点击时,下拉菜单将延续隐藏

.dropdown-menu {
  position: absolute;/*设置绝对定位,相对于父元素div.dropdown*/
  top: 100%;/*让下拉菜单项在父菜单项底部,如果父元素不设置相对定位,该元素相对于body元素*/
  left: 0;
  z-index: 1000;/*让下拉菜单项不被其他元素遮盖住*/
  display: none;/*默认隐藏下拉菜单项*/
  float: left;
  min-width: 160px;
  padding: 5px 0;
  margin: 2px 0 0;
  font-size: 14px;
  list-style: none;
  background-color: #fff;
  background-clip: padding-box;
  border: 1px solid #ccc;
  border: 1px solid rgba(0, 0, 0, .15);
  border-radius: 4px;
  -webkit-box-shadow: 0 6px 12px rgba(0, 0, 0, .175);
  box-shadow: 0 6px 12px rgba(0, 0, 0, .175);
}

【实现原理】

  1、Dropdown插件在网页加载的时候,对具有带有data-toggle=”dropdown”样式的因素进行事件绑定

  2、用户单击带有data-toggle=”dropdown”样式的链接或者按钮时,触发javascript事件代码

  3、javascript事件代码在父容器上加以一个.open样式

  4、默认隐藏的.dropdown-menu菜单在表有矣.open样式后,即可显示出,从而达到预期的效用

  5、当用户更点击时,“div.dropdown”容器中之类名“open”又会被移除

.open > .dropdown-menu {
  display: block;
}

【其他用法】

  还有一个好玩的用法,是触发元素可以置身菜单的父容器的外部

  但是,这种用法有零星接触要留意

  1、要装父容器的id值

  2、要安装触发元素的data-toggle属性和data-target属性,data-target属性值是#id

<button class="btn dropdown-toggle" type="button" data-toggle="dropdown" data-target="#dropdown1">外部触发器</button>
<div class="dropdown" id="dropdown1">
    <ul class="dropdown-menu" role="menu" aria-labelledby="tutorial">
        <li role="presentation"><a href="##">HTML</a></li>
        <li role="presentation"><a href="##">CSS</a></li>
        <li role="presentation"><a href="##">javascript</a></li>
    </ul>
</div>

 

推而广之用法

【分隔线】

  于Bootstrap框架中之下拉菜单提供了下拉分隔线,假要下拉菜单来少数只组,那么组及组里可以透过抬高一个缺损的<li>,并且给这个<li>添加类名“divider”来兑现增长下拉分隔线的职能

.dropdown-menu .divider {
  height: 1px;
  margin: 9px 0;
  overflow: hidden;
  background-color: #e5e5e5;
}

<li role="separator" class="divider"></li>

<div class="dropdown">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
    Dropdown

  </button>
  <ul class="dropdown-menu" aria-labelledby="dropdownMenu1">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
    <li role="separator" class="divider"></li>
    <li><a href="#">Separated link</a></li>
  </ul>
</div>

【菜单标题】

  在另外下拉菜单中皆只是由此丰富标题来表明一组动作 

<li class="dropdown-header">Dropdown header</li>

.dropdown-header {
  display: block;
  padding: 3px 20px;
  font-size: 12px;
  line-height: 1.42857143;
  color: #999;
}

<div class="dropdown">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
    Dropdown

  </button>
  <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
    <li role="presentation" class="dropdown-header">第一部分菜单头部</li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation" class="divider"></li>
    <li role="presentation" class="dropdown-header">第二部分菜单头部</li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
  </ul>
</div>

【对齐方式】

  Bootstrap框架中下拉菜单默认是误对合,如果想让下拉菜单相对于父容器右对同时,可以当“dropdown-menu”上添加一个“dropdown-menu-right”类名 

.dropdown-menu-right {
  right: 0;
  left: auto;
}

  由于<div
class=”dropdown”>默认是块级元素,撑满父级宽度。这里,需要也该因素设置inline-block和margin-left,使其情节撑起来宽度,且离开左侧有必然距离

    display: inline-block;
    margin-left: 60px;

<div class="dropdown" style="display: inline-block;margin-left: 60px;">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
    Dropdown

  </button>
  <ul class="dropdown-menu dropdown-menu-right" role="menu" aria-labelledby="dropdownMenu1">
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation" class="divider"></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
  </ul>
</div>

【菜单项状态】

  下拉菜单项的默认的状态产生浮动状态(:hover)和症结状态(:focus)

.dropdown-menu > li > a:hover,
.dropdown-menu > li > a:focus {
  color: #262626;
  text-decoration: none;
  background-color: #f5f5f5;
}

  下拉菜单项除了上面两种植状态,还有当前状态(.active)和剥夺状态(.disabled)。这片栽状态下方法就待以对应的食谱项达到加上对应的类名

<div class="dropdown">
  <button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
    Dropdown

  </button>
  <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
    <li role="presentation" class="active"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
    <li role="presentation" class="divider"></li>
    <li role="presentation" class="disabled"><a role="menuitem" tabindex="-1" href="#">下拉菜单项</a></li>
  </ul>
</div>

 

JS触发

  和模态弹出窗相同,Bootstrap框架中之下拉菜单也支持JavaScript方法触发下拉菜单显示。但是,要特点注意的凡,即使用JS触发,也未可知去丢触发元素的data-toggle=”dropdown”

<div class="dropdown">
    <button class="btn dropdown-toggle" data-toggle="dropdown" type="button">触发器</button>
    <ul class="dropdown-menu" role="menu" aria-labelledby="tutorial">
        <li role="presentation"><a href="##">HTML</a></li>
        <li role="presentation"><a href="##">CSS</a></li>
        <li role="presentation"><a href="##">javascript</a></li>
    </ul>
</div>
<script>
;$(function(){
    $('.dropdown-toggle').dropdown()
});
</script>

【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动画完成之后)触发

<div class="dropdown">
    <button class="btn dropdown-toggle" data-toggle="dropdown" type="button">触发器</button>
    <ul class="dropdown-menu" role="menu" aria-labelledby="tutorial">
        <li role="presentation"><a href="##">HTML</a></li>
        <li role="presentation"><a href="##">CSS</a></li>
        <li role="presentation"><a href="##">javascript</a></li>
    </ul>
</div>
<script>
;$(function(){
    $('.dropdown').on('show.bs.dropdown',function(){
        $('.dropdown-toggle').html('关闭');
    });
    $('.dropdown').on('hide.bs.dropdown',function(){
        $('.dropdown-toggle').html('打开');
    });

});
</script>

 

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)

 

相关文章

网站地图xml地图