modal.js 15.4 KB
Newer Older
1
import $ from 'jquery'
2
3
4
5
import Util from './util'

/**
 * --------------------------------------------------------------------------
Mark Otto's avatar
Mark Otto committed
6
 * Bootstrap (v4.1.3): modal.js
7
8
9
10
 * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
 * --------------------------------------------------------------------------
 */

Johann-S's avatar
Johann-S committed
11
12
13
14
15
/**
 * ------------------------------------------------------------------------
 * Constants
 * ------------------------------------------------------------------------
 */
16

Johann-S's avatar
Johann-S committed
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
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'
}
fat's avatar
fat committed
68

Johann-S's avatar
Johann-S committed
69
70
71
72
73
/**
 * ------------------------------------------------------------------------
 * Class Definition
 * ------------------------------------------------------------------------
 */
74

Johann-S's avatar
Johann-S committed
75
76
77
78
79
80
81
82
83
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
84
    this._isTransitioning     = false
Johann-S's avatar
Johann-S committed
85
    this._scrollbarWidth      = 0
86
87
  }

Johann-S's avatar
Johann-S committed
88
89
90
91
  // Getters

  static get VERSION() {
    return VERSION
92
93
  }

Johann-S's avatar
Johann-S committed
94
95
96
  static get Default() {
    return Default
  }
97

Johann-S's avatar
Johann-S committed
98
  // Public
99

Johann-S's avatar
Johann-S committed
100
101
102
  toggle(relatedTarget) {
    return this._isShown ? this.hide() : this.show(relatedTarget)
  }
103

Johann-S's avatar
Johann-S committed
104
  show(relatedTarget) {
105
    if (this._isShown || this._isTransitioning) {
Johann-S's avatar
Johann-S committed
106
      return
107
108
    }

Johann-S's avatar
Johann-S committed
109
110
    if ($(this._element).hasClass(ClassName.FADE)) {
      this._isTransitioning = true
111
112
    }

Johann-S's avatar
Johann-S committed
113
114
115
    const showEvent = $.Event(Event.SHOW, {
      relatedTarget
    })
116

Johann-S's avatar
Johann-S committed
117
    $(this._element).trigger(showEvent)
118

Johann-S's avatar
Johann-S committed
119
120
121
    if (this._isShown || showEvent.isDefaultPrevented()) {
      return
    }
122

Johann-S's avatar
Johann-S committed
123
    this._isShown = true
124

Johann-S's avatar
Johann-S committed
125
126
    this._checkScrollbar()
    this._setScrollbar()
127

Johann-S's avatar
Johann-S committed
128
    this._adjustDialog()
129

Johann-S's avatar
Johann-S committed
130
    $(document.body).addClass(ClassName.OPEN)
131

Johann-S's avatar
Johann-S committed
132
133
    this._setEscapeEvent()
    this._setResizeEvent()
David Bailey's avatar
David Bailey committed
134

Johann-S's avatar
Johann-S committed
135
136
137
138
139
    $(this._element).on(
      Event.CLICK_DISMISS,
      Selector.DATA_DISMISS,
      (event) => this.hide(event)
    )
140

Johann-S's avatar
Johann-S committed
141
142
143
144
145
146
147
    $(this._dialog).on(Event.MOUSEDOWN_DISMISS, () => {
      $(this._element).one(Event.MOUSEUP_DISMISS, (event) => {
        if ($(event.target).is(this._element)) {
          this._ignoreBackdropClick = true
        }
      })
    })
148

Johann-S's avatar
Johann-S committed
149
150
    this._showBackdrop(() => this._showElement(relatedTarget))
  }
151

Johann-S's avatar
Johann-S committed
152
153
154
155
  hide(event) {
    if (event) {
      event.preventDefault()
    }
156

157
    if (!this._isShown || this._isTransitioning) {
Johann-S's avatar
Johann-S committed
158
      return
159
160
    }

Johann-S's avatar
Johann-S committed
161
    const hideEvent = $.Event(Event.HIDE)
162

Johann-S's avatar
Johann-S committed
163
    $(this._element).trigger(hideEvent)
164

Johann-S's avatar
Johann-S committed
165
166
167
    if (!this._isShown || hideEvent.isDefaultPrevented()) {
      return
    }
168

Johann-S's avatar
Johann-S committed
169
170
    this._isShown = false
    const transition = $(this._element).hasClass(ClassName.FADE)
171

Johann-S's avatar
Johann-S committed
172
173
174
    if (transition) {
      this._isTransitioning = true
    }
175

Johann-S's avatar
Johann-S committed
176
177
    this._setEscapeEvent()
    this._setResizeEvent()
178

Johann-S's avatar
Johann-S committed
179
    $(document).off(Event.FOCUSIN)
180

Johann-S's avatar
Johann-S committed
181
    $(this._element).removeClass(ClassName.SHOW)
182

Johann-S's avatar
Johann-S committed
183
184
    $(this._element).off(Event.CLICK_DISMISS)
    $(this._dialog).off(Event.MOUSEDOWN_DISMISS)
185
186


Johann-S's avatar
Johann-S committed
187
188
    if (transition) {
      const transitionDuration  = Util.getTransitionDurationFromElement(this._element)
189

Johann-S's avatar
Johann-S committed
190
191
192
193
194
195
196
      $(this._element)
        .one(Util.TRANSITION_END, (event) => this._hideModal(event))
        .emulateTransitionEnd(transitionDuration)
    } else {
      this._hideModal()
    }
  }
197

Johann-S's avatar
Johann-S committed
198
199
  dispose() {
    $.removeData(this._element, DATA_KEY)
200

Johann-S's avatar
Johann-S committed
201
    $(window, document, this._element, this._backdrop).off(EVENT_KEY)
202

Johann-S's avatar
Johann-S committed
203
204
205
206
207
208
209
    this._config              = null
    this._element             = null
    this._dialog              = null
    this._backdrop            = null
    this._isShown             = null
    this._isBodyOverflowing   = null
    this._ignoreBackdropClick = null
210
    this._isTransitioning     = null
Johann-S's avatar
Johann-S committed
211
212
    this._scrollbarWidth      = null
  }
fat's avatar
fat committed
213

Johann-S's avatar
Johann-S committed
214
215
216
  handleUpdate() {
    this._adjustDialog()
  }
fat's avatar
fat committed
217

Johann-S's avatar
Johann-S committed
218
  // Private
fat's avatar
fat committed
219

Johann-S's avatar
Johann-S committed
220
221
222
223
  _getConfig(config) {
    config = {
      ...Default,
      ...config
224
    }
Johann-S's avatar
Johann-S committed
225
226
227
    Util.typeCheckConfig(NAME, config, DefaultType)
    return config
  }
228

Johann-S's avatar
Johann-S committed
229
230
  _showElement(relatedTarget) {
    const transition = $(this._element).hasClass(ClassName.FADE)
231

Johann-S's avatar
Johann-S committed
232
233
234
235
    if (!this._element.parentNode ||
        this._element.parentNode.nodeType !== Node.ELEMENT_NODE) {
      // Don't move modal's DOM position
      document.body.appendChild(this._element)
fat's avatar
fat committed
236
237
    }

Johann-S's avatar
Johann-S committed
238
239
240
    this._element.style.display = 'block'
    this._element.removeAttribute('aria-hidden')
    this._element.scrollTop = 0
241

Johann-S's avatar
Johann-S committed
242
243
244
    if (transition) {
      Util.reflow(this._element)
    }
245

Johann-S's avatar
Johann-S committed
246
    $(this._element).addClass(ClassName.SHOW)
247

Johann-S's avatar
Johann-S committed
248
249
250
    if (this._config.focus) {
      this._enforceFocus()
    }
251

Johann-S's avatar
Johann-S committed
252
253
254
    const shownEvent = $.Event(Event.SHOWN, {
      relatedTarget
    })
255

Johann-S's avatar
Johann-S committed
256
    const transitionComplete = () => {
Jacob Thornton's avatar
Jacob Thornton committed
257
      if (this._config.focus) {
Johann-S's avatar
Johann-S committed
258
        this._element.focus()
Jacob Thornton's avatar
Jacob Thornton committed
259
      }
Johann-S's avatar
Johann-S committed
260
261
262
      this._isTransitioning = false
      $(this._element).trigger(shownEvent)
    }
263

Johann-S's avatar
Johann-S committed
264
    if (transition) {
265
      const transitionDuration  = Util.getTransitionDurationFromElement(this._dialog)
266

Johann-S's avatar
Johann-S committed
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
      $(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) {
Jacob Thornton's avatar
Jacob Thornton committed
282
283
          this._element.focus()
        }
Johann-S's avatar
Johann-S committed
284
285
      })
  }
286

Johann-S's avatar
Johann-S committed
287
288
289
290
291
292
293
294
295
296
  _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)
297
    }
Johann-S's avatar
Johann-S committed
298
  }
299

Johann-S's avatar
Johann-S committed
300
301
302
303
304
  _setResizeEvent() {
    if (this._isShown) {
      $(window).on(Event.RESIZE, (event) => this.handleUpdate(event))
    } else {
      $(window).off(Event.RESIZE)
305
    }
Johann-S's avatar
Johann-S committed
306
  }
307

Johann-S's avatar
Johann-S committed
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
  _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
324
    }
Johann-S's avatar
Johann-S committed
325
  }
326

Johann-S's avatar
Johann-S committed
327
328
329
330
331
332
333
334
335
336
  _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)
337
338
      }

Johann-S's avatar
Johann-S committed
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
      $(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()
        }
354
355
      })

Johann-S's avatar
Johann-S committed
356
357
      if (animate) {
        Util.reflow(this._backdrop)
358
359
      }

Johann-S's avatar
Johann-S committed
360
      $(this._backdrop).addClass(ClassName.SHOW)
361

Johann-S's avatar
Johann-S committed
362
363
364
      if (!callback) {
        return
      }
365

Johann-S's avatar
Johann-S committed
366
367
368
369
      if (!animate) {
        callback()
        return
      }
370

Johann-S's avatar
Johann-S committed
371
      const backdropTransitionDuration = Util.getTransitionDurationFromElement(this._backdrop)
372

Johann-S's avatar
Johann-S committed
373
374
375
376
377
      $(this._backdrop)
        .one(Util.TRANSITION_END, callback)
        .emulateTransitionEnd(backdropTransitionDuration)
    } else if (!this._isShown && this._backdrop) {
      $(this._backdrop).removeClass(ClassName.SHOW)
378

Johann-S's avatar
Johann-S committed
379
380
381
      const callbackRemove = () => {
        this._removeBackdrop()
        if (callback) {
382
383
          callback()
        }
Johann-S's avatar
Johann-S committed
384
      }
385

Johann-S's avatar
Johann-S committed
386
      if ($(this._element).hasClass(ClassName.FADE)) {
387
388
        const backdropTransitionDuration = Util.getTransitionDurationFromElement(this._backdrop)

389
        $(this._backdrop)
Johann-S's avatar
Johann-S committed
390
          .one(Util.TRANSITION_END, callbackRemove)
391
          .emulateTransitionEnd(backdropTransitionDuration)
Johann-S's avatar
Johann-S committed
392
393
      } else {
        callbackRemove()
394
      }
Johann-S's avatar
Johann-S committed
395
396
    } else if (callback) {
      callback()
397
    }
Johann-S's avatar
Johann-S committed
398
  }
399

Johann-S's avatar
Johann-S committed
400
401
402
403
  // ----------------------------------------------------------------------
  // the following methods are used to handle overflowing modals
  // todo (fat): these should probably be refactored out of modal.js
  // ----------------------------------------------------------------------
404

Johann-S's avatar
Johann-S committed
405
406
407
  _adjustDialog() {
    const isModalOverflowing =
      this._element.scrollHeight > document.documentElement.clientHeight
408

Johann-S's avatar
Johann-S committed
409
410
    if (!this._isBodyOverflowing && isModalOverflowing) {
      this._element.style.paddingLeft = `${this._scrollbarWidth}px`
411
412
    }

Johann-S's avatar
Johann-S committed
413
414
    if (this._isBodyOverflowing && !isModalOverflowing) {
      this._element.style.paddingRight = `${this._scrollbarWidth}px`
415
    }
Johann-S's avatar
Johann-S committed
416
  }
417

Johann-S's avatar
Johann-S committed
418
419
420
421
  _resetAdjustments() {
    this._element.style.paddingLeft = ''
    this._element.style.paddingRight = ''
  }
422

Johann-S's avatar
Johann-S committed
423
424
425
426
427
  _checkScrollbar() {
    const rect = document.body.getBoundingClientRect()
    this._isBodyOverflowing = rect.left + rect.right < window.innerWidth
    this._scrollbarWidth = this._getScrollbarWidth()
  }
428

Johann-S's avatar
Johann-S committed
429
430
431
432
  _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
433
      const fixedContent = [].slice.call(document.querySelectorAll(Selector.FIXED_CONTENT))
Johann-S's avatar
Johann-S committed
434
435
436
      const stickyContent = [].slice.call(document.querySelectorAll(Selector.STICKY_CONTENT))

      // Adjust fixed content padding
437
      $(fixedContent).each((index, element) => {
Johann-S's avatar
Johann-S committed
438
439
440
441
442
        const actualPadding = element.style.paddingRight
        const calculatedPadding = $(element).css('padding-right')
        $(element)
          .data('padding-right', actualPadding)
          .css('padding-right', `${parseFloat(calculatedPadding) + this._scrollbarWidth}px`)
443
444
      })

Johann-S's avatar
Johann-S committed
445
446
447
448
449
450
451
      // 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`)
452
453
      })

Johann-S's avatar
Johann-S committed
454
455
456
457
458
459
      // 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`)
460
    }
Johann-S's avatar
Johann-S committed
461
  }
462

Johann-S's avatar
Johann-S committed
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
  _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')
      }
    })
480

Johann-S's avatar
Johann-S committed
481
482
483
484
485
    // Restore body padding
    const padding = $(document.body).data('padding-right')
    $(document.body).removeData('padding-right')
    document.body.style.paddingRight = padding ? padding : ''
  }
486

Johann-S's avatar
Johann-S committed
487
488
489
490
491
492
493
494
  _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
  }
495

Johann-S's avatar
Johann-S committed
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
  // 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)
      }
511

Johann-S's avatar
Johann-S committed
512
513
514
      if (typeof config === 'string') {
        if (typeof data[config] === 'undefined') {
          throw new TypeError(`No method named "${config}"`)
515
        }
Johann-S's avatar
Johann-S committed
516
517
518
519
520
        data[config](relatedTarget)
      } else if (_config.show) {
        data.show(relatedTarget)
      }
    })
521
  }
Johann-S's avatar
Johann-S committed
522
523
524
525
526
527
528
}

/**
 * ------------------------------------------------------------------------
 * Data Api implementation
 * ------------------------------------------------------------------------
 */
529

Johann-S's avatar
Johann-S committed
530
531
532
$(document).on(Event.CLICK_DATA_API, Selector.DATA_TOGGLE, function (event) {
  let target
  const selector = Util.getSelectorFromElement(this)
533

Johann-S's avatar
Johann-S committed
534
535
536
  if (selector) {
    target = document.querySelector(selector)
  }
537

Johann-S's avatar
Johann-S committed
538
539
540
541
  const config = $(target).data(DATA_KEY)
    ? 'toggle' : {
      ...$(target).data(),
      ...$(this).data()
542
543
    }

Johann-S's avatar
Johann-S committed
544
545
546
  if (this.tagName === 'A' || this.tagName === 'AREA') {
    event.preventDefault()
  }
547

Johann-S's avatar
Johann-S committed
548
549
550
551
  const $target = $(target).one(Event.SHOW, (showEvent) => {
    if (showEvent.isDefaultPrevented()) {
      // Only register focus restorer if modal will actually get shown
      return
552
553
    }

Johann-S's avatar
Johann-S committed
554
555
556
    $target.one(Event.HIDDEN, () => {
      if ($(this).is(':visible')) {
        this.focus()
557
558
559
560
      }
    })
  })

Johann-S's avatar
Johann-S committed
561
562
563
564
565
566
567
568
  Modal._jQueryInterface.call($(target), config, this)
})

/**
 * ------------------------------------------------------------------------
 * jQuery
 * ------------------------------------------------------------------------
 */
569

Johann-S's avatar
Johann-S committed
570
571
572
573
574
575
$.fn[NAME] = Modal._jQueryInterface
$.fn[NAME].Constructor = Modal
$.fn[NAME].noConflict = () => {
  $.fn[NAME] = JQUERY_NO_CONFLICT
  return Modal._jQueryInterface
}
576
577

export default Modal