bootstrap源码学习与示例：bootstrap-modal
bootstrap-modal译为模态对话框，也就是带遮罩层的对话框。
从它的源码实现来看有点罗索。
它的HTML结构分三分部，首部，内容区，底层，底部放按钮或分页栏。
<div class="modal hide fade">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
<h3>Modal header</h3>
</div>
<div class="modal-body">
<p>One fine body…</p>
</div>
<div class="modal-footer">
<a href="#" class="btn">Close</a>
<a href="#" class="btn btn-primary">Save changes</a>
</div>
</div>
总是觉得这样成本太大了，用户只知道他要填空的数据就行，HTML怎么样也没所谓。jQuery ui也犯了这毛病。
!function ($) {
"use strict"; // jshint ;_;
/* MODAL CLASS DEFINITION
* ====================== */
var Modal = function (element, options) {
this.options = options
this.$element = $(element) //绑定关闭事件，关闭按钮要求有[data-dismiss="modal"]属性
.delegate('[data-dismiss="modal"]', 'click.dismiss.modal', $.proxy(this.hide, this))
this.options.remote && this.$element.find('.modal-body').load(this.options.remote)
}
Modal.prototype = {
constructor: Modal
,
toggle: function () {
return this[!this.isShown ? 'show' : 'hide']()
}
,
show: function () {
var that = this
, e = $.Event('show')
//触发show事件
this.$element.trigger(e)
if (this.isShown || e.isDefaultPrevented()) return
this.isShown = true
this.escape();//绑定或移除键盘事件
this.backdrop(function () {
var transition = $.support.transition && that.$element.hasClass('fade')
if (!that.$element.parent().length) {
that.$element.appendTo(document.body) //don't move modals dom position
}
that.$element
.show()
if (transition) {
that.$element[0].offsetWidth // force reflow
}
that.$element
.addClass("in")
.attr("aria-hidden", false)
that.enforceFocus()
transition ?
that.$element.one($.support.transition.end, function () {
that.$element.focus().trigger("shown")
}) :
that.$element.focus().trigger("shown")
})
}
,
hide: function (e) {
e && e.preventDefault()
e = $.Event("hide")
this.$element.trigger(e)
if (!this.isShown || e.isDefaultPrevented()) return
this.isShown = false
this.escape()
$(document).off("focusin.modal")
this.$element
.removeClass("in")
.attr('aria-hidden', true)
$.support.transition && this.$element.hasClass("fade") ?
this.hideWithTransition() :
this.hideModal()
}
,
//让模态对话框获得焦点
enforceFocus: function () {
var that = this
$(document).on("focusin.modal", function (e) {
if (that.$element[0] !== e.target && !that.$element.has(e.target).length) {
that.$element.focus()
}
})
}
,
//这是个失败的设计
escape: function () {
var that = this
//如果已经处于显示状态，并且可以使用键盘关闭，那么绑定键盘事件
if (this.isShown && this.options.keyboard) {
this.$element.on("keyup.dismiss.modal", function ( e ) {
e.which == 27 && that.hide()//回车关闭
})
} else if (!this.isShown) {
this.$element.off("keyup.dismiss.modal")//移除事件
}
}
,
hideWithTransition: function () {
var that = this
//强制绑定移除事件
, timeout = setTimeout(function () {
that.$element.off($.support.transition.end)
that.hideModal()
}, 500)
this.$element.one($.support.transition.end, function () {
clearTimeout(timeout)
that.hideModal()
})
}
,
hideModal: function (that) {
this.$element
.hide()
.trigger('hidden')
//触发隐藏回调
this.backdrop()//移除遮罩层
}
,
removeBackdrop: function () {
this.$backdrop.remove()
this.$backdrop = null
}
,
backdrop: function (callback) {
var that = this
, animate = this.$element.hasClass('fade') ? 'fade' : ''
if (this.isShown && this.options.backdrop) {
var doAnimate = $.support.transition && animate
//添加遮罩层
this.$backdrop = $('<div class="modal-backdrop ' + animate + '" />')
.appendTo(document.body)
this.$backdrop.click(
this.options.backdrop == 'static' ?
$.proxy(this.$element[0].focus, this.$element[0])
: $.proxy(this.hide, this)
)
if (doAnimate) this.$backdrop[0].offsetWidth // force reflow
//显示遮罩层
this.$backdrop.addClass('in')
doAnimate ?
this.$backdrop.one($.support.transition.end, callback) :
callback()
} else if (!this.isShown && this.$backdrop) {
this.$backdrop.removeClass('in')
$.support.transition && this.$element.hasClass('fade')?
this.$backdrop.one($.support.transition.end, $.proxy(this.removeBackdrop, this)) :
this.removeBackdrop()
} else if (callback) {
callback()
}
}
}
/* MODAL PLUGIN DEFINITION
* ======================= */
var old = $.fn.modal
$.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)))
if (typeof option == 'string') data[option]()//show hide toggle
else if (options.show) data.show()//如果在参数指明要显示
})
}
$.fn.modal.defaults = {
backdrop: true,
keyboard: true,
show: true
}
$.fn.modal.Constructor = Modal
/* MODAL NO CONFLICT
* ================= */
$.fn.modal.noConflict = function () {
$.fn.modal = old
return this
}
/* MODAL DATA-API
* ============== */
$(document).on('click.modal.data-api', '[data-toggle="modal"]', function (e) {
var $this = $(this)
, href = $this.attr('href')
, $target = $($this.attr('data-target') || (href && href.replace(/.*(?=#[^\s]+$)/, ''))) //strip for ie7
, option = $target.data('modal') ? 'toggle' : $.extend({
remote:!/#/.test(href) && href
}, $target.data(), $this.data())
e.preventDefault()
$target
.modal(option)
.one('hide', function () {
$this.focus()
})
})
}(window.jQuery);