博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
Bootstrap下拉菜单
阅读量:6853 次
发布时间:2019-06-26

本文共 10221 字,大约阅读时间需要 34 分钟。

前面的话

  网页交互的时候经常会需要上下文菜单或者隐藏/显示菜单项,Bootstrap默认提供了用于显示链接列表的可切换、有上下文的菜单。而且在各种交互状态下的菜单展示需要和javascript插件配合才能使用。本文将详细介绍Bootstrap下拉菜单

 

使用方法

  在使用Bootstrap框架的下拉菜单时,必须调用Bootstrap框架提供的bootstrap.js文件。当然,如果使用的是未编译版本,在js文件夹下能找到一个名为“dropdown.js”的文件,也可以调用这个js文件

  因为Bootstrap的组件交互效果都是依赖于jQuery库写的插件,所以在使用bootstrap.js之前一定要先加载jquery.js才会产生效果

Document

 

基本用法

  在使用Bootstrap框架中的下拉菜单组件时,其结构运用的正确与否非常的重要,如果结构和类名未使用正确,直接影响组件是否能正常运用

  1、使用一个名为“dropdown”的容器包裹了整个下拉菜单元素

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

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

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

 

原理分析

  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

 

扩展用法

【分隔线】

  在Bootstrap框架中的下拉菜单提供了下拉分隔线,假设下拉菜单有两个组,那么组与组之间可以通过添加一个空的<li>,并且给这个<li>添加类名“divider”来实现添加下拉分隔线的功能

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

【菜单标题】

  在任何下拉菜单中均可通过添加标题来标明一组动作 

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

【对齐方式】

  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;

【菜单项状态】

  下拉菜单项的默认的状态有悬浮状态(: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"

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

 

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)

 

转载于:https://www.cnblogs.com/xiaohuochai/p/7106649.html

你可能感兴趣的文章
ES6第一篇:let、const、块级作用域
查看>>
2017最新苹果 APPLE ID注册流程
查看>>
删除超长路径/超长文件名文件夹
查看>>
SIP简介
查看>>
C#学习(一)之hello,world
查看>>
C#学习(三)之类的浅析
查看>>
转---写一个网页进度loading
查看>>
Go循环语句
查看>>
使用jQuery.FileUpload插件和Backload组件裁剪上传图片
查看>>
python一中实现组合的方式
查看>>
[原创]牛刀小试-重构并实现邮件内容生成功能
查看>>
过滤器
查看>>
Android 控件使用
查看>>
linux关闭防火墙
查看>>
贪吃蛇源码
查看>>
杂谈篇:阅读优秀代码是提高开发人员修为的一种捷径
查看>>
jfreechart 实例
查看>>
gstreamer 10.5版本发布啦
查看>>
Android--控件属性汇总
查看>>
LeetCode算法题-Implement Queue Using Stacks(Java实现)
查看>>