bootstrap-modal.js學習筆記(原始碼註釋)
主要知識點:
- 通過
on,one
註冊自定義事件,並且只能通過trigger
來觸發 - 計算滾動條的寬度,通過生成一個
div
節點,overflow
為scroll
,那麼就有滾動條了,然後就可以計算出滾動條的寬度 - 把變數繫結在該
dom
元素的data
的某個屬性上,這個很妙
/* ========================================================================
* Bootstrap: modal.js v3.3.7
* http://getbootstrap.com/javascript/#modals
* ========================================================================
* Copyright 2011-2016 Twitter, Inc.
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* ======================================================================== */
+function ($) {
'use strict';
// MODAL CLASS DEFINITION
// ======================
var Modal = function (element, options) {
this.options = options
this.$body = $(document.body)
this.$element = $(element)
this.$dialog = this.$element.find('.modal-dialog')
this.$backdrop = null
this.isShown = null
this.originalBodyPad = null
this.scrollbarWidth = 0
this.ignoreBackdropClick = false
if (this.options.remote) {
this.$element
.find('.modal-content')
.load(this.options.remote, $.proxy(function () {
this.$element.trigger('loaded.bs.modal')
}, this))
}
}
Modal.VERSION = '3.3.7'
Modal.TRANSITION_DURATION = 300
Modal.BACKDROP_TRANSITION_DURATION = 150
Modal.DEFAULTS = {
backdrop: true,
keyboard: true,
show: true
}
Modal.prototype.toggle = function (_relatedTarget) {
return this.isShown ? this.hide() : this.show(_relatedTarget)
}
// 第一個被呼叫的函式
Modal.prototype.show = function (_relatedTarget) {
// _relatedTarget是觸發的按鈕或a
// this指向modal例項
var that = this
// relatedTarget是jq event的屬性,返回當前事件涉及到的其他dom元素,它的值是一個dom節點
var e = $.Event('show.bs.modal', { relatedTarget: _relatedTarget })
// 執行了e事件
this.$element.trigger(e)
// 如果isShown為true那麼下面的不執行,最初的isShow為null,因此那後isShown為false,所以就是如果沒有modal顯示,那麼執行下面的程式碼
if (this.isShown || e.isDefaultPrevented()) return
this.isShown = true
//檢查瀏覽器滾動條的寬度
this.checkScrollbar()
// 如果溢位,給body的padding-right加上滾動條的寬度
this.setScrollbar()
// 'modal-open'的效果是overflow:hidden
this.$body.addClass('modal-open')
this.escape()
this.resize()
// 自定義事件click.dismiss.bs.modal
this.$element.on('click.dismiss.bs.modal', '[data-dismiss="modal"]', $.proxy(this.hide, this))
this.$dialog.on('mousedown.dismiss.bs.modal', function () {
that.$element.one('mouseup.dismiss.bs.modal', function (e) {
if ($(e.target).is(that.$element)) that.ignoreBackdropClick = true
})
})
this.backdrop(function () {
var transition = $.support.transition && that.$element.hasClass('fade')
if (!that.$element.parent().length) {
that.$element.appendTo(that.$body) // don't move modals dom position
}
that.$element
.show()
.scrollTop(0)
that.adjustDialog()
if (transition) {
that.$element[0].offsetWidth // force reflow
}
that.$element.addClass('in')
that.enforceFocus()
var e = $.Event('shown.bs.modal', { relatedTarget: _relatedTarget })
transition ?
that.$dialog // wait for modal to slide in
.one('bsTransitionEnd', function () {
that.$element.trigger('focus').trigger(e)
})
.emulateTransitionEnd(Modal.TRANSITION_DURATION) :
that.$element.trigger('focus').trigger(e)
})
}
Modal.prototype.hide = function (e) {
if (e) e.preventDefault()
e = $.Event('hide.bs.modal')
this.$element.trigger(e)
if (!this.isShown || e.isDefaultPrevented()) return
this.isShown = false
this.escape()
this.resize()
$(document).off('focusin.bs.modal')
this.$element
.removeClass('in')
.off('click.dismiss.bs.modal')
.off('mouseup.dismiss.bs.modal')
this.$dialog.off('mousedown.dismiss.bs.modal')
$.support.transition && this.$element.hasClass('fade') ?
this.$element
.one('bsTransitionEnd', $.proxy(this.hideModal, this))
.emulateTransitionEnd(Modal.TRANSITION_DURATION) :
this.hideModal()
}
Modal.prototype.enforceFocus = function () {
$(document)
.off('focusin.bs.modal') // guard against infinite focus loop
.on('focusin.bs.modal', $.proxy(function (e) {
if (document !== e.target &&
this.$element[0] !== e.target &&
!this.$element.has(e.target).length) {
this.$element.trigger('focus')
}
}, this))
}
Modal.prototype.escape = function () {
console.log('this.isShown', this.isShown)
console.log('this.options.keyboard', this.options.keyboard)
if (this.isShown && this.options.keyboard) {
this.$element.on('keydown.dismiss.bs.modal', $.proxy(function (e) {
e.which == 27 && this.hide()
}, this))
} else if (!this.isShown) {
this.$element.off('keydown.dismiss.bs.modal')
}
}
Modal.prototype.resize = function () {
if (this.isShown) {
$(window).on('resize.bs.modal', $.proxy(this.handleUpdate, this))
} else {
$(window).off('resize.bs.modal')
}
}
Modal.prototype.hideModal = function () {
var that = this
this.$element.hide()
this.backdrop(function () {
that.$body.removeClass('modal-open')
that.resetAdjustments()
that.resetScrollbar()
that.$element.trigger('hidden.bs.modal')
})
}
Modal.prototype.removeBackdrop = function () {
this.$backdrop && this.$backdrop.remove()
this.$backdrop = null
}
Modal.prototype.backdrop = function (callback) {
var that = this
var animate = this.$element.hasClass('fade') ? 'fade' : ''
if (this.isShown && this.options.backdrop) {
var doAnimate = $.support.transition && animate
this.$backdrop = $(document.createElement('div'))
.addClass('modal-backdrop ' + animate)
.appendTo(this.$body)
this.$element.on('click.dismiss.bs.modal', $.proxy(function (e) {
if (this.ignoreBackdropClick) {
this.ignoreBackdropClick = false
return
}
if (e.target !== e.currentTarget) return
this.options.backdrop == 'static'
? this.$element[0].focus()
: this.hide()
}, this))
if (doAnimate) this.$backdrop[0].offsetWidth // force reflow
this.$backdrop.addClass('in')
if (!callback) return
doAnimate ?
this.$backdrop
.one('bsTransitionEnd', callback)
.emulateTransitionEnd(Modal.BACKDROP_TRANSITION_DURATION) :
callback()
} else if (!this.isShown && this.$backdrop) {
this.$backdrop.removeClass('in')
var callbackRemove = function () {
that.removeBackdrop()
callback && callback()
}
$.support.transition && this.$element.hasClass('fade') ?
this.$backdrop
.one('bsTransitionEnd', callbackRemove)
.emulateTransitionEnd(Modal.BACKDROP_TRANSITION_DURATION) :
callbackRemove()
} else if (callback) {
callback()
}
}
// these following methods are used to handle overflowing modals
Modal.prototype.handleUpdate = function () {
this.adjustDialog()
}
Modal.prototype.adjustDialog = function () {
var modalIsOverflowing = this.$element[0].scrollHeight > document.documentElement.clientHeight
this.$element.css({
paddingLeft: !this.bodyIsOverflowing && modalIsOverflowing ? this.scrollbarWidth : '',
paddingRight: this.bodyIsOverflowing && !modalIsOverflowing ? this.scrollbarWidth : ''
})
}
Modal.prototype.resetAdjustments = function () {
this.$element.css({
paddingLeft: '',
paddingRight: ''
})
}
Modal.prototype.checkScrollbar = function () {
//window.innerWidth,瀏覽器的視口寬度,包含滾動條的寬度
var fullWindowWidth = window.innerWidth
if (!fullWindowWidth) { // workaround for missing window.innerWidth in IE8
var documentElementRect = document.documentElement.getBoundingClientRect()
fullWindowWidth = documentElementRect.right - Math.abs(documentElementRect.left)
}
// document.body.clientWidth是瀏覽器視窗的寬度,不包括滾動條
this.bodyIsOverflowing = document.body.clientWidth < fullWindowWidth
// 滾動條的寬度
this.scrollbarWidth = this.measureScrollbar()
}
Modal.prototype.setScrollbar = function () {
var bodyPad = parseInt((this.$body.css('padding-right') || 0), 10)
this.originalBodyPad = document.body.style.paddingRight || ''
// 如果body,overflow,那麼給body的padding-right加上滾動條的寬度
if (this.bodyIsOverflowing) this.$body.css('padding-right', bodyPad + this.scrollbarWidth)
}
Modal.prototype.resetScrollbar = function () {
this.$body.css('padding-right', this.originalBodyPad)
}
Modal.prototype.measureScrollbar = function () { // thx walsh
var scrollDiv = document.createElement('div')
scrollDiv.className = 'modal-scrollbar-measure'
this.$body.append(scrollDiv)
// offsetWidth,物件整體的實際寬度,包括滾動條等邊線
//clientWidth, 物件內容的寬度,不包括滾動條的寬度
var scrollbarWidth = scrollDiv.offsetWidth - scrollDiv.clientWidth
this.$body[0].removeChild(scrollDiv)
return scrollbarWidth
}
// MODAL PLUGIN DEFINITION
// =======================
function Plugin(option, _relatedTarget) {
// _relatedTarget觸發的按鈕或者a標籤
// this是call函式指定的modal節點
// 遍歷頁面中的所有modal節點
return this.each(function () {
var $this = $(this)
var data = $this.data('bs.modal')
var options = $.extend({}, Modal.DEFAULTS, $this.data(), typeof option == 'object' && option)
// 如果data為空,那麼給$(this).data('bs.modal')也就是data變數賦值,data變數現在是一個modal例項
if (!data) {
$this.data('bs.modal',
(data = new Modal(this, options))
)
}
// 如果option是string
if (typeof option == 'string') data[option](_relatedTarget)
// 如果show為真,那麼呼叫show函式
else if (options.show) data.show(_relatedTarget)
})
}
var old = $.fn.modal
$.fn.modal = Plugin
$.fn.modal.Constructor = Modal
// MODAL NO CONFLICT
// =================
$.fn.modal.noConflict = function () {
$.fn.modal = old
return this
}
// MODAL DATA-API
// ==============
$(document).on('click.bs.modal.data-api', '[data-toggle="modal"]', function (e) {
var $this = $(this)
// 也就是觸發modal的元素(button、a)
var href = $this.attr('href')
var $target = $($this.attr('data-target') || (href && href.replace(/.*(?=#[^\s]+$)/, ''))) // strip for ie7
// 找到頁面中的modal節點
var option = $target.data('bs.modal') ? 'toggle' : $.extend({ remote: !/#/.test(href) && href }, $target.data(), $this.data())
if ($this.is('a')) e.preventDefault()
// 自定義事件'show.bs.modal',自定義事件只能通過on,one來‘繫結’
$target.one('show.bs.modal', function (showEvent) {
if (showEvent.isDefaultPrevented()) return // only register focus restorer if modal will actually get shown
$target.one('hidden.bs.modal', function () {
$this.is(':visible') && $this.trigger('focus')
})
})
Plugin.call($target, option, this)
// 這下Plugin裡面的this指向的是$target
})
}(jQuery);
相關文章
- Retrofit原始碼學習筆記原始碼筆記
- vue原始碼學習筆記1Vue原始碼筆記
- jQuery原始碼學習筆記一jQuery原始碼筆記
- 學習筆記 sync/RWMutex原始碼筆記Mutex原始碼
- 註解學習筆記筆記
- 《Linux核心完全註釋》學習筆記:2.7 Linux核心原始碼的目錄結構Linux筆記原始碼
- Redux 學習筆記 – 原始碼閱讀Redux筆記原始碼
- Redux 學習筆記 - 原始碼閱讀Redux筆記原始碼
- Python 學習筆記 - socketserver原始碼剖析Python筆記Server原始碼
- Spring-cloud學習筆記--- Eureka原始碼剖析之服務註冊介面SpringCloud筆記原始碼
- 註解和反射學習筆記反射筆記
- 前端筆記-vue v2.6.10原始碼註釋-nextTick前端筆記Vue原始碼
- vue原始碼學習筆記2(resolveConstructorOptions)Vue原始碼筆記Struct
- MyBatis原始碼學習筆記(一) 初遇篇MyBatis原始碼筆記
- Universal播放器的原始碼學習筆記播放器原始碼筆記
- java.security.Provider 原始碼學習筆記JavaIDE原始碼筆記
- UE4(5)逆向學習筆記(三)——UEDumper原始碼學習筆記原始碼
- Java註解與反射學習筆記Java反射筆記
- 雲端計算學習路線原始碼框架筆記:Mysql原始碼一原始碼框架筆記MySql
- 雲端計算學習路線原始碼框架筆記:Mysql原始碼二原始碼框架筆記MySql
- 雲端計算學習路線原始碼框架筆記:Mysql原始碼三原始碼框架筆記MySql
- JUC原始碼學習筆記6——ReentrantReadWriteLock原始碼筆記
- Qt Creator 原始碼學習筆記01,初識QTCQT原始碼筆記
- async-validator 原始碼學習筆記(三):rule原始碼筆記
- drone學習筆記-釋出映象筆記
- Consul 學習筆記-服務註冊筆記
- 小白的學習筆記——eureka註冊中心筆記
- Flutter筆記——幀繪製系列之一(原始碼學習)Flutter筆記原始碼
- Flutter筆記——runApp發生了什麼(原始碼學習)Flutter筆記APP原始碼
- JUC原始碼學習筆記2——AQS共享和Semaphore,CountDownLatch原始碼筆記AQSCountDownLatch
- async-validator 原始碼學習筆記(四):validator原始碼筆記
- 《Shell指令碼學習指南》學習筆記指令碼筆記
- java筆記3-註釋Java筆記
- Shell指令碼學習筆記指令碼筆記
- 《Android原始碼設計模式》學習筆記之ImageLoaderAndroid原始碼設計模式筆記
- Springcloud原始碼學習筆記1—— Zuul閘道器原理SpringGCCloud原始碼筆記Zuul
- Qt Creator 原始碼學習筆記02,認識框架結構QT原始碼筆記框架
- async-validator 原始碼學習筆記(六):validate 方法原始碼筆記