0
0
mirror of https://github.com/twbs/bootstrap.git synced 2025-01-23 15:52:21 +01:00
Bootstrap/js/src/modal.js

576 lines
15 KiB
JavaScript
Raw Normal View History

import $ from 'jquery'
import Util from './util'
/**
* --------------------------------------------------------------------------
2018-07-23 19:25:52 -07:00
* Bootstrap (v4.1.3): modal.js
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
2018-09-26 10:39:01 +02:00
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
2018-09-26 10:39:01 +02:00
const NAME = 'modal'
const VERSION = '4.1.3'
const DATA_KEY = 'bs.modal'
const EVENT_KEY = `.${DATA_KEY}`
const DATA_API_KEY = '.data-api'
const JQUERY_NO_CONFLICT = $.fn[NAME]
const ESCAPE_KEYCODE = 27 // KeyboardEvent.which value for Escape (Esc) key
const Default = {
backdrop : true,
keyboard : true,
focus : true,
show : true
}
const DefaultType = {
backdrop : '(boolean|string)',
keyboard : 'boolean',
focus : 'boolean',
show : 'boolean'
}
const Event = {
HIDE : `hide${EVENT_KEY}`,
HIDDEN : `hidden${EVENT_KEY}`,
SHOW : `show${EVENT_KEY}`,
SHOWN : `shown${EVENT_KEY}`,
FOCUSIN : `focusin${EVENT_KEY}`,
RESIZE : `resize${EVENT_KEY}`,
CLICK_DISMISS : `click.dismiss${EVENT_KEY}`,
KEYDOWN_DISMISS : `keydown.dismiss${EVENT_KEY}`,
MOUSEUP_DISMISS : `mouseup.dismiss${EVENT_KEY}`,
MOUSEDOWN_DISMISS : `mousedown.dismiss${EVENT_KEY}`,
CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`
}
const ClassName = {
SCROLLBAR_MEASURER : 'modal-scrollbar-measure',
BACKDROP : 'modal-backdrop',
OPEN : 'modal-open',
FADE : 'fade',
SHOW : 'show'
}
const Selector = {
DIALOG : '.modal-dialog',
DATA_TOGGLE : '[data-toggle="modal"]',
DATA_DISMISS : '[data-dismiss="modal"]',
FIXED_CONTENT : '.fixed-top, .fixed-bottom, .is-fixed, .sticky-top',
STICKY_CONTENT : '.sticky-top'
}
2015-05-13 14:46:50 -07:00
2018-09-26 10:39:01 +02:00
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
2018-09-26 10:39:01 +02:00
class Modal {
constructor(element, config) {
this._config = this._getConfig(config)
this._element = element
this._dialog = element.querySelector(Selector.DIALOG)
this._backdrop = null
this._isShown = false
this._isBodyOverflowing = false
this._ignoreBackdropClick = false
this._scrollbarWidth = 0
}
2018-09-26 10:39:01 +02:00
// Getters
static get VERSION() {
return VERSION
}
2018-09-26 10:39:01 +02:00
static get Default() {
return Default
}
2018-09-26 10:39:01 +02:00
// Public
2018-09-26 10:39:01 +02:00
toggle(relatedTarget) {
return this._isShown ? this.hide() : this.show(relatedTarget)
}
2018-09-26 10:39:01 +02:00
show(relatedTarget) {
if (this._isTransitioning || this._isShown) {
return
}
2018-09-26 10:39:01 +02:00
if ($(this._element).hasClass(ClassName.FADE)) {
this._isTransitioning = true
}
2018-09-26 10:39:01 +02:00
const showEvent = $.Event(Event.SHOW, {
relatedTarget
})
2018-09-26 10:39:01 +02:00
$(this._element).trigger(showEvent)
2018-09-26 10:39:01 +02:00
if (this._isShown || showEvent.isDefaultPrevented()) {
return
}
2018-09-26 10:39:01 +02:00
this._isShown = true
2018-09-26 10:39:01 +02:00
this._checkScrollbar()
this._setScrollbar()
2018-09-26 10:39:01 +02:00
this._adjustDialog()
2018-09-26 10:39:01 +02:00
$(document.body).addClass(ClassName.OPEN)
2018-09-26 10:39:01 +02:00
this._setEscapeEvent()
this._setResizeEvent()
2018-09-26 10:39:01 +02:00
$(this._element).on(
Event.CLICK_DISMISS,
Selector.DATA_DISMISS,
(event) => this.hide(event)
)
2018-09-26 10:39:01 +02:00
$(this._dialog).on(Event.MOUSEDOWN_DISMISS, () => {
$(this._element).one(Event.MOUSEUP_DISMISS, (event) => {
if ($(event.target).is(this._element)) {
this._ignoreBackdropClick = true
}
})
})
2018-09-26 10:39:01 +02:00
this._showBackdrop(() => this._showElement(relatedTarget))
}
2018-09-26 10:39:01 +02:00
hide(event) {
if (event) {
event.preventDefault()
}
2018-09-26 10:39:01 +02:00
if (this._isTransitioning || !this._isShown) {
return
}
2018-09-26 10:39:01 +02:00
const hideEvent = $.Event(Event.HIDE)
2018-09-26 10:39:01 +02:00
$(this._element).trigger(hideEvent)
2018-09-26 10:39:01 +02:00
if (!this._isShown || hideEvent.isDefaultPrevented()) {
return
}
2018-09-26 10:39:01 +02:00
this._isShown = false
const transition = $(this._element).hasClass(ClassName.FADE)
2018-09-26 10:39:01 +02:00
if (transition) {
this._isTransitioning = true
}
2018-09-26 10:39:01 +02:00
this._setEscapeEvent()
this._setResizeEvent()
2018-09-26 10:39:01 +02:00
$(document).off(Event.FOCUSIN)
2018-09-26 10:39:01 +02:00
$(this._element).removeClass(ClassName.SHOW)
2018-09-26 10:39:01 +02:00
$(this._element).off(Event.CLICK_DISMISS)
$(this._dialog).off(Event.MOUSEDOWN_DISMISS)
2018-09-26 10:39:01 +02:00
if (transition) {
const transitionDuration = Util.getTransitionDurationFromElement(this._element)
2018-09-26 10:39:01 +02:00
$(this._element)
.one(Util.TRANSITION_END, (event) => this._hideModal(event))
.emulateTransitionEnd(transitionDuration)
} else {
this._hideModal()
}
}
2018-03-13 09:59:20 +01:00
2018-09-26 10:39:01 +02:00
dispose() {
$.removeData(this._element, DATA_KEY)
2018-03-13 09:59:20 +01:00
2018-09-26 10:39:01 +02:00
$(window, document, this._element, this._backdrop).off(EVENT_KEY)
2018-09-26 10:39:01 +02:00
this._config = null
this._element = null
this._dialog = null
this._backdrop = null
this._isShown = null
this._isBodyOverflowing = null
this._ignoreBackdropClick = null
this._scrollbarWidth = null
}
2015-05-13 12:48:34 -07:00
2018-09-26 10:39:01 +02:00
handleUpdate() {
this._adjustDialog()
}
2015-05-13 12:48:34 -07:00
2018-09-26 10:39:01 +02:00
// Private
2015-05-13 12:48:34 -07:00
2018-09-26 10:39:01 +02:00
_getConfig(config) {
config = {
...Default,
...config
}
2018-09-26 10:39:01 +02:00
Util.typeCheckConfig(NAME, config, DefaultType)
return config
}
2018-09-26 10:39:01 +02:00
_showElement(relatedTarget) {
const transition = $(this._element).hasClass(ClassName.FADE)
2018-09-26 10:39:01 +02:00
if (!this._element.parentNode ||
this._element.parentNode.nodeType !== Node.ELEMENT_NODE) {
// Don't move modal's DOM position
document.body.appendChild(this._element)
2015-05-13 14:46:50 -07:00
}
2018-09-26 10:39:01 +02:00
this._element.style.display = 'block'
this._element.removeAttribute('aria-hidden')
this._element.scrollTop = 0
2018-09-26 10:39:01 +02:00
if (transition) {
Util.reflow(this._element)
}
2018-09-26 10:39:01 +02:00
$(this._element).addClass(ClassName.SHOW)
2018-09-26 10:39:01 +02:00
if (this._config.focus) {
this._enforceFocus()
}
2018-09-26 10:39:01 +02:00
const shownEvent = $.Event(Event.SHOWN, {
relatedTarget
})
2018-09-26 10:39:01 +02:00
const transitionComplete = () => {
2015-08-18 19:22:46 -07:00
if (this._config.focus) {
2018-09-26 10:39:01 +02:00
this._element.focus()
2015-08-18 19:22:46 -07:00
}
2018-09-26 10:39:01 +02:00
this._isTransitioning = false
$(this._element).trigger(shownEvent)
}
2018-09-26 10:39:01 +02:00
if (transition) {
const transitionDuration = Util.getTransitionDurationFromElement(this._dialog)
2018-09-26 10:39:01 +02:00
$(this._dialog)
.one(Util.TRANSITION_END, transitionComplete)
.emulateTransitionEnd(transitionDuration)
} else {
transitionComplete()
}
}
_enforceFocus() {
$(document)
.off(Event.FOCUSIN) // Guard against infinite focus loop
.on(Event.FOCUSIN, (event) => {
if (document !== event.target &&
this._element !== event.target &&
$(this._element).has(event.target).length === 0) {
2015-08-18 19:22:46 -07:00
this._element.focus()
}
2018-09-26 10:39:01 +02:00
})
}
2018-03-13 09:59:20 +01:00
2018-09-26 10:39:01 +02:00
_setEscapeEvent() {
if (this._isShown && this._config.keyboard) {
$(this._element).on(Event.KEYDOWN_DISMISS, (event) => {
if (event.which === ESCAPE_KEYCODE) {
event.preventDefault()
this.hide()
}
})
} else if (!this._isShown) {
$(this._element).off(Event.KEYDOWN_DISMISS)
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
_setResizeEvent() {
if (this._isShown) {
$(window).on(Event.RESIZE, (event) => this.handleUpdate(event))
} else {
$(window).off(Event.RESIZE)
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
_hideModal() {
this._element.style.display = 'none'
this._element.setAttribute('aria-hidden', true)
this._isTransitioning = false
this._showBackdrop(() => {
$(document.body).removeClass(ClassName.OPEN)
this._resetAdjustments()
this._resetScrollbar()
$(this._element).trigger(Event.HIDDEN)
})
}
_removeBackdrop() {
if (this._backdrop) {
$(this._backdrop).remove()
this._backdrop = null
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
_showBackdrop(callback) {
const animate = $(this._element).hasClass(ClassName.FADE)
? ClassName.FADE : ''
if (this._isShown && this._config.backdrop) {
this._backdrop = document.createElement('div')
this._backdrop.className = ClassName.BACKDROP
if (animate) {
this._backdrop.classList.add(animate)
}
2018-09-26 10:39:01 +02:00
$(this._backdrop).appendTo(document.body)
$(this._element).on(Event.CLICK_DISMISS, (event) => {
if (this._ignoreBackdropClick) {
this._ignoreBackdropClick = false
return
}
if (event.target !== event.currentTarget) {
return
}
if (this._config.backdrop === 'static') {
this._element.focus()
} else {
this.hide()
}
})
2018-09-26 10:39:01 +02:00
if (animate) {
Util.reflow(this._backdrop)
}
2018-09-26 10:39:01 +02:00
$(this._backdrop).addClass(ClassName.SHOW)
2018-09-26 10:39:01 +02:00
if (!callback) {
return
}
2018-09-26 10:39:01 +02:00
if (!animate) {
callback()
return
}
2018-09-26 10:39:01 +02:00
const backdropTransitionDuration = Util.getTransitionDurationFromElement(this._backdrop)
2018-09-26 10:39:01 +02:00
$(this._backdrop)
.one(Util.TRANSITION_END, callback)
.emulateTransitionEnd(backdropTransitionDuration)
} else if (!this._isShown && this._backdrop) {
$(this._backdrop).removeClass(ClassName.SHOW)
2018-09-26 10:39:01 +02:00
const callbackRemove = () => {
this._removeBackdrop()
if (callback) {
callback()
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
if ($(this._element).hasClass(ClassName.FADE)) {
2018-03-13 09:59:20 +01:00
const backdropTransitionDuration = Util.getTransitionDurationFromElement(this._backdrop)
$(this._backdrop)
2018-09-26 10:39:01 +02:00
.one(Util.TRANSITION_END, callbackRemove)
2018-03-13 09:59:20 +01:00
.emulateTransitionEnd(backdropTransitionDuration)
2018-09-26 10:39:01 +02:00
} else {
callbackRemove()
}
2018-09-26 10:39:01 +02:00
} else if (callback) {
callback()
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
// ----------------------------------------------------------------------
// the following methods are used to handle overflowing modals
// todo (fat): these should probably be refactored out of modal.js
// ----------------------------------------------------------------------
2018-09-26 10:39:01 +02:00
_adjustDialog() {
const isModalOverflowing =
this._element.scrollHeight > document.documentElement.clientHeight
2018-09-26 10:39:01 +02:00
if (!this._isBodyOverflowing && isModalOverflowing) {
this._element.style.paddingLeft = `${this._scrollbarWidth}px`
}
2018-09-26 10:39:01 +02:00
if (this._isBodyOverflowing && !isModalOverflowing) {
this._element.style.paddingRight = `${this._scrollbarWidth}px`
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
_resetAdjustments() {
this._element.style.paddingLeft = ''
this._element.style.paddingRight = ''
}
2018-09-26 10:39:01 +02:00
_checkScrollbar() {
const rect = document.body.getBoundingClientRect()
this._isBodyOverflowing = rect.left + rect.right < window.innerWidth
this._scrollbarWidth = this._getScrollbarWidth()
}
2018-09-26 10:39:01 +02:00
_setScrollbar() {
if (this._isBodyOverflowing) {
// Note: DOMNode.style.paddingRight returns the actual value or '' if not set
// while $(DOMNode).css('padding-right') returns the calculated value or 0 if not set
const fixedContent = [].slice.call(document.querySelectorAll(Selector.FIXED_CONTENT))
2018-09-26 10:39:01 +02:00
const stickyContent = [].slice.call(document.querySelectorAll(Selector.STICKY_CONTENT))
// Adjust fixed content padding
$(fixedContent).each((index, element) => {
2018-09-26 10:39:01 +02:00
const actualPadding = element.style.paddingRight
const calculatedPadding = $(element).css('padding-right')
$(element)
.data('padding-right', actualPadding)
.css('padding-right', `${parseFloat(calculatedPadding) + this._scrollbarWidth}px`)
})
2018-09-26 10:39:01 +02:00
// Adjust sticky content margin
$(stickyContent).each((index, element) => {
const actualMargin = element.style.marginRight
const calculatedMargin = $(element).css('margin-right')
$(element)
.data('margin-right', actualMargin)
.css('margin-right', `${parseFloat(calculatedMargin) - this._scrollbarWidth}px`)
})
2018-09-26 10:39:01 +02:00
// Adjust body padding
const actualPadding = document.body.style.paddingRight
const calculatedPadding = $(document.body).css('padding-right')
$(document.body)
.data('padding-right', actualPadding)
.css('padding-right', `${parseFloat(calculatedPadding) + this._scrollbarWidth}px`)
}
2018-09-26 10:39:01 +02:00
}
2018-09-26 10:39:01 +02:00
_resetScrollbar() {
// Restore fixed content padding
const fixedContent = [].slice.call(document.querySelectorAll(Selector.FIXED_CONTENT))
$(fixedContent).each((index, element) => {
const padding = $(element).data('padding-right')
$(element).removeData('padding-right')
element.style.paddingRight = padding ? padding : ''
})
// Restore sticky content
const elements = [].slice.call(document.querySelectorAll(`${Selector.STICKY_CONTENT}`))
$(elements).each((index, element) => {
const margin = $(element).data('margin-right')
if (typeof margin !== 'undefined') {
$(element).css('margin-right', margin).removeData('margin-right')
}
})
2018-09-26 10:39:01 +02:00
// Restore body padding
const padding = $(document.body).data('padding-right')
$(document.body).removeData('padding-right')
document.body.style.paddingRight = padding ? padding : ''
}
2018-09-26 10:39:01 +02:00
_getScrollbarWidth() { // thx d.walsh
const scrollDiv = document.createElement('div')
scrollDiv.className = ClassName.SCROLLBAR_MEASURER
document.body.appendChild(scrollDiv)
const scrollbarWidth = scrollDiv.getBoundingClientRect().width - scrollDiv.clientWidth
document.body.removeChild(scrollDiv)
return scrollbarWidth
}
2018-09-26 10:39:01 +02:00
// Static
static _jQueryInterface(config, relatedTarget) {
return this.each(function () {
let data = $(this).data(DATA_KEY)
const _config = {
...Default,
...$(this).data(),
...typeof config === 'object' && config ? config : {}
}
if (!data) {
data = new Modal(this, _config)
$(this).data(DATA_KEY, data)
}
2018-09-26 10:39:01 +02:00
if (typeof config === 'string') {
if (typeof data[config] === 'undefined') {
throw new TypeError(`No method named "${config}"`)
}
2018-09-26 10:39:01 +02:00
data[config](relatedTarget)
} else if (_config.show) {
data.show(relatedTarget)
}
})
}
2018-09-26 10:39:01 +02:00
}
/**
* ------------------------------------------------------------------------
* Data Api implementation
* ------------------------------------------------------------------------
*/
2018-09-26 10:39:01 +02:00
$(document).on(Event.CLICK_DATA_API, Selector.DATA_TOGGLE, function (event) {
let target
const selector = Util.getSelectorFromElement(this)
2018-09-26 10:39:01 +02:00
if (selector) {
target = document.querySelector(selector)
}
2018-09-26 10:39:01 +02:00
const config = $(target).data(DATA_KEY)
? 'toggle' : {
...$(target).data(),
...$(this).data()
}
2018-09-26 10:39:01 +02:00
if (this.tagName === 'A' || this.tagName === 'AREA') {
event.preventDefault()
}
2018-09-26 10:39:01 +02:00
const $target = $(target).one(Event.SHOW, (showEvent) => {
if (showEvent.isDefaultPrevented()) {
// Only register focus restorer if modal will actually get shown
return
}
2018-09-26 10:39:01 +02:00
$target.one(Event.HIDDEN, () => {
if ($(this).is(':visible')) {
this.focus()
}
})
})
2018-09-26 10:39:01 +02:00
Modal._jQueryInterface.call($(target), config, this)
})
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
2018-09-26 10:39:01 +02:00
$.fn[NAME] = Modal._jQueryInterface
$.fn[NAME].Constructor = Modal
$.fn[NAME].noConflict = () => {
$.fn[NAME] = JQUERY_NO_CONFLICT
return Modal._jQueryInterface
}
export default Modal