bootstrap插件学习-bootstrap.modal.js

bootstrap插件学习-bootstrap.modal.js

先从bootstrap.modal.js的结构看起。

function($){
        var Modal = function(){}  //构造器
        Modal.prototype = function(){} //构造器的原型
        function ..(){}  //自定义方法 
        $.fn.modal = function(){} //在jQuery对象上自定方法
        $.fn.modal.defaults = {} //设置默认属性
        $.fn.modal.Constructor = Modal //重置构造器名
        $(function(){})   //初始化
    }(window.jQuery)

其HTML结构

<a class="btn" data-toggle="modal" href="#myModal" >点击触发对话框</a>

<div class="modal" id="myModal">
      <div class="modal-header">
        <a class="close" data-dismiss="modal">×</a>
        <h3>对话框标题</h3>
      </div>
      <div class="modal-body">
        <p>对话框内容</p>
      </div>
      <div class="modal-footer">
      <a href="#" class="btn" data-dismiss="modal">关闭</a>
      <a href="#" class="btn btn-primary" data-dismiss="modal">保存更新</a>
  </div>
</div>

我们开始过一遍插件源码:从初始化开始

$(function () {
     /*
     * 在所有有data-toggle='modal'属性的标签上帮上click事件,一般为a标签
     * /.*(?=#[^s]+$)/表示如果匹配成功将#之前的信息删除
     * 对于jQuery对象,比如a标签有data-xx类型的,在其data方法中都可以显示
     * 将a标签data-target指向的或是href的锚点指向的元素传入modal方法里
     * */
    $('body').on('click.modal.data-api', '[data-toggle="modal"]', function ( e ) {
      var $this = $(this), href
        , $target = $($this.attr('data-target') || (href = $this.attr('href')) && href.replace(/.*(?=#[^s]+$)/, '')) //strip for ie7
        , option = $target.data('modal') ? 'toggle' : $.extend({}, $target.data(), $this.data());
      e.preventDefault()
      $target.modal(option)
    })
  })

根据HTML提供的结构,$target为a标签所指向的弹出框div的Jquery对象。另外$this.data()存在数据,为{toggle:'modal'},这个我在注释中已经解释。最后执行$target.modal(option),我们进入jQuery对象的这个方法。

$.fn.modal = function ( option ) {
    return this.each(function () {
      var $this = $(this)
        , data = $this.data('modal')
        , options = $.extend({}, $.fn.modal.defaults, $this.data(), typeof option == 'object' && option)
      if (!data) $this.data('modal', (data = new Modal(this, options)))//为modal绑定对象
      if (typeof option == 'string') data[option]()
      else if (options.show) data.show()
    })
  }

初始化一些参数,在弹出框div上加入了一个modal属性,如果这个modal属性不存在,则实例化Modal构造器。最后执行show方法,因为此时你已经点击了a标签,让div显示。代码中有if(typeof option == 'string')data[option],表示代码支持传入方法名,执行该方法,在执行show方法之前,我们先进入Modal的构造器中看看。

/*
  * 构造器,为所有data-dismiss='modal'属性的标签绑定原型上的hide方法
  * */
  var Modal = function ( content, options ) {
    this.options = options
    this.$element = $(content)
      .delegate('[data-dismiss="modal"]', 'click.dismiss.modal', $.proxy(this.hide, this))
  }

很简单,让带有data-dismiss='modal'属性的标签的click事件交给弹出框div代理,注意这里的执行的方法。这里为什么要$.proxy(this.hide,this)这样写,第一,需要明白此时的this表示着构造器的实例,代理的事件需要使用到实例的hide方法,为什么实例拥有hide方法,很简单this是Modal的实例,它继承了Modal原型的方法。那proxy方法中的第二个this,则表示着这个hide方法的调用者,即上下文,可以试想一下,如果我们不修改这个,那执行这个方法时,其里面的this是不是指向了调用它的a标签呢?(注意留意HTML结构,拥有data-dismiss属性的三个a标签,其实分别就是弹出框的关闭按钮等),那原来定义在原型上的hide方法中的this的属性将不能在正常使用。
综上,实例化,主要就是给弹出框绑定了hide事件,为将来关闭弹出框,做准备。

好,回到之前JQuery的modal方法上,最后我们执行了show方法,进入show方法。

 下面是执行的流程图,就是各个方法的执行顺序

show -> escape -> backdrop
hide ->escape -> hideModal -> backdrop

show

    , show: function () {
        var that = this

        if (this.isShown) return

        $('body').addClass('modal-open')//给body加上modal-open类

        this.isShown = true//将isShown属性设置成true

        this.$element.trigger('show');//没理解
escape.call(
this)//加上键盘事件 backdrop.call(this, function () { var transition = $.support.transition && that.$element.hasClass('fade') //console.log(that.$element); /* * 插入弹出层 * */ !that.$element.parent().length && that.$element.appendTo(document.body) //don't move modals dom position that.$element .show()//jQuery方法显示 if (transition) { that.$element[0].offsetWidth // force reflow } that.$element.addClass('in') transition ? that.$element.one($.support.transition.end, function () { that.$element.trigger('shown') }) : that.$element.trigger('shown') }) }

谈到show和hide的时候,我们需要留意它们源码中的一些我们认为的'废'操作,其实它能帮助我们实现扩展。比如给body加modal-open这个类,如果你要在打开弹出层,执行其他程序,可以通过判断这个类来实现,这是bootstrap它自身已经提供的标识。escape()方法是一个添加键盘事件和删除键盘事件的方法,它可以让你按enter键也能关闭弹出框,比较简单。

接下来我们进入backdrop方法

/*
  * 生成遮罩层,并且控制遮罩层的显示或删除
  * */
  function backdrop( callback ) {
          var that = this
      , animate = this.$element.hasClass('fade') ? 'fade' : ''

    if (this.isShown && this.options.backdrop) {
      var doAnimate = $.support.transition && animate
      //console.log(doAnimate);
      this.$backdrop = $('<div class="modal-backdrop ' + animate + '" />')
        .appendTo(document.body)//遮罩层,让弹出框显示时,背景被遮罩,此时为透明的

      if (this.options.backdrop != 'static') {
        this.$backdrop.click($.proxy(this.hide, this))
      }

      if (doAnimate) this.$backdrop[0].offsetWidth // force reflow

      this.$backdrop.addClass('in')//加入in类,显示遮罩层

      doAnimate ?
        this.$backdrop.one($.support.transition.end, callback) :
        callback()
      //打开时,执行callback()回调
    } else if (!this.isShown && this.$backdrop) {
      this.$backdrop.removeClass('in')//删除in,遮罩层透明
      $.support.transition && this.$element.hasClass('fade')?
        this.$backdrop.one($.support.transition.end, $.proxy(removeBackdrop, this)) :
        removeBackdrop.call(this)
        //一般执行removeBackdrop()函数
    } else if (callback) {
      callback()
    }
  }

这里为什么要判断弹出框是否有fade类,在bootstrap.css中,.fade拥有left:-25%的属性,当.fade .in时则left变为10%,在版本较高的浏览器中,有自上向下的移动的效果(低版本浏览器没有效果,不过这个可以jQuery实现...),这个部分需要我们结合css样式看,注意in的样式,就可以了,弹出框显示的最后一步,执行callback回调,显示弹出框,并给弹出框加上in类,80%透明度。最后完成显示。

之前因为我们已经在弹出框的三个a标签上都绑定了hide事件,所以当我们点击关闭时,执行hide方法

hide: function ( e ) {
        e && e.preventDefault()

        if (!this.isShown) return

        var that = this
        this.isShown = false

        $('body').removeClass('modal-open')

        escape.call(this)//关闭按键事件

        this.$element
          .trigger('hide')
          .removeClass('in')//jQuery方法,将弹出框隐藏,并将div的class去in

        $.support.transition && this.$element.hasClass('fade') ?
          hideWithTransition.call(this) :
          hideModal.call(this)
      }

其实跟show方法差不多,主要是给show擦屁股,进入hideModal方法

function hideModal( that ) {
    this.$element
      .hide() //删除效果更好
      .trigger('hidden')

    backdrop.call(this)
  }

蛮蛋疼的方法,还是调用backdrop。最后删除时我们调用的是removeBackdrop方法。

/*
  * 清除遮罩层
  * */
  function removeBackdrop() {
    this.$backdrop.remove()
    this.$backdrop = null
  }

将之前创建的遮罩层删除。以上完成一遍弹出框的打开显示。

 内容不多,时间刚好,以上是我的一点读码体会,如有错误,请指出,大家共通学习。