toast.js 5.33 KB
Newer Older
1
2
/**
 * --------------------------------------------------------------------------
XhmikosR's avatar
XhmikosR committed
3
 * Bootstrap (v4.3.1): toast.js
4
5
6
7
 * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
 * --------------------------------------------------------------------------
 */

8
import {
9
  getjQuery,
10
11
12
  TRANSITION_END,
  emulateTransitionEnd,
  getTransitionDurationFromElement,
13
  reflow,
14
  typeCheckConfig
15
16
17
18
} from './util/index'
import Data from './dom/data'
import EventHandler from './dom/event-handler'
import Manipulator from './dom/manipulator'
19

20
21
22
23
24
/**
 * ------------------------------------------------------------------------
 * Constants
 * ------------------------------------------------------------------------
 */
25

XhmikosR's avatar
XhmikosR committed
26
27
28
const NAME = 'toast'
const VERSION = '4.3.1'
const DATA_KEY = 'bs.toast'
29
const EVENT_KEY = `.${DATA_KEY}`
30
31

const Event = {
XhmikosR's avatar
XhmikosR committed
32
33
34
35
36
  CLICK_DISMISS: `click.dismiss${EVENT_KEY}`,
  HIDE: `hide${EVENT_KEY}`,
  HIDDEN: `hidden${EVENT_KEY}`,
  SHOW: `show${EVENT_KEY}`,
  SHOWN: `shown${EVENT_KEY}`
37
38
39
}

const ClassName = {
XhmikosR's avatar
XhmikosR committed
40
41
42
43
  FADE: 'fade',
  HIDE: 'hide',
  SHOW: 'show',
  SHOWING: 'showing'
44
45
46
}

const DefaultType = {
XhmikosR's avatar
XhmikosR committed
47
48
49
  animation: 'boolean',
  autohide: 'boolean',
  delay: 'number'
50
51
52
}

const Default = {
XhmikosR's avatar
XhmikosR committed
53
54
55
  animation: true,
  autohide: true,
  delay: 500
56
57
58
}

const Selector = {
XhmikosR's avatar
XhmikosR committed
59
  DATA_DISMISS: '[data-dismiss="toast"]'
60
}
61

62
63
64
65
66
/**
 * ------------------------------------------------------------------------
 * Class Definition
 * ------------------------------------------------------------------------
 */
67

68
69
70
class Toast {
  constructor(element, config) {
    this._element = element
XhmikosR's avatar
XhmikosR committed
71
    this._config = this._getConfig(config)
72
73
    this._timeout = null
    this._setListeners()
74
    Data.setData(element, DATA_KEY, this)
75
76
  }

77
  // Getters
78

79
80
81
  static get VERSION() {
    return VERSION
  }
82

83
84
85
  static get DefaultType() {
    return DefaultType
  }
86

87
88
89
90
  static get Default() {
    return Default
  }

91
  // Public
92

93
  show() {
94
95
96
97
98
    const showEvent = EventHandler.trigger(this._element, Event.SHOW)

    if (showEvent.defaultPrevented) {
      return
    }
99

100
101
102
    if (this._config.animation) {
      this._element.classList.add(ClassName.FADE)
    }
103

104
    const complete = () => {
Johann-S's avatar
Johann-S committed
105
106
107
      this._element.classList.remove(ClassName.SHOWING)
      this._element.classList.add(ClassName.SHOW)

108
      EventHandler.trigger(this._element, Event.SHOWN)
109

110
      if (this._config.autohide) {
ysds's avatar
ysds committed
111
112
113
        this._timeout = setTimeout(() => {
          this.hide()
        }, this._config.delay)
114
      }
115
    }
116

Johann-S's avatar
Johann-S committed
117
    this._element.classList.remove(ClassName.HIDE)
118
    reflow(this._element)
Johann-S's avatar
Johann-S committed
119
    this._element.classList.add(ClassName.SHOWING)
120
    if (this._config.animation) {
121
      const transitionDuration = getTransitionDurationFromElement(this._element)
122

123
124
      EventHandler.one(this._element, TRANSITION_END, complete)
      emulateTransitionEnd(this._element, transitionDuration)
125
126
    } else {
      complete()
127
    }
128
  }
129

ysds's avatar
ysds committed
130
  hide() {
131
132
133
    if (!this._element.classList.contains(ClassName.SHOW)) {
      return
    }
134

135
136
137
138
139
    const hideEvent = EventHandler.trigger(this._element, Event.HIDE)

    if (hideEvent.defaultPrevented) {
      return
    }
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

    const complete = () => {
      this._element.classList.add(ClassName.HIDE)
      EventHandler.trigger(this._element, Event.HIDDEN)
    }

    this._element.classList.remove(ClassName.SHOW)
    if (this._config.animation) {
      const transitionDuration = getTransitionDurationFromElement(this._element)

      EventHandler.one(this._element, TRANSITION_END, complete)
      emulateTransitionEnd(this._element, transitionDuration)
    } else {
      complete()
    }
155
  }
156

157
158
159
  dispose() {
    clearTimeout(this._timeout)
    this._timeout = null
160

161
162
    if (this._element.classList.contains(ClassName.SHOW)) {
      this._element.classList.remove(ClassName.SHOW)
163
164
    }

165
166
    EventHandler.off(this._element, Event.CLICK_DISMISS)
    Data.removeData(this._element, DATA_KEY)
167

168
    this._element = null
XhmikosR's avatar
XhmikosR committed
169
    this._config = null
170
  }
171

172
  // Private
173

174
175
176
  _getConfig(config) {
    config = {
      ...Default,
177
      ...Manipulator.getDataAttributes(this._element),
178
      ...typeof config === 'object' && config ? config : {}
179
180
    }

181
    typeCheckConfig(
182
183
184
185
      NAME,
      config,
      this.constructor.DefaultType
    )
186

187
188
    return config
  }
189

190
  _setListeners() {
191
192
    EventHandler.on(
      this._element,
193
194
      Event.CLICK_DISMISS,
      Selector.DATA_DISMISS,
ysds's avatar
ysds committed
195
      () => this.hide()
196
197
    )
  }
198

199
200
  // Static

201
  static jQueryInterface(config) {
202
    return this.each(function () {
XhmikosR's avatar
XhmikosR committed
203
204
      let data = Data.getData(this, DATA_KEY)
      const _config = typeof config === 'object' && config
205
206
207
208

      if (!data) {
        data = new Toast(this, _config)
      }
209

210
211
212
      if (typeof config === 'string') {
        if (typeof data[config] === 'undefined') {
          throw new TypeError(`No method named "${config}"`)
213
214
        }

215
216
217
        data[config](this)
      }
    })
218
  }
219

220
  static getInstance(element) {
221
222
    return Data.getData(element, DATA_KEY)
  }
223
224
}

225
226
const $ = getjQuery()

227
228
229
230
/**
 * ------------------------------------------------------------------------
 * jQuery
 * ------------------------------------------------------------------------
231
 *  add .toast to jQuery only if jQuery is present
232
 */
Anton Bershanskiy's avatar
Anton Bershanskiy committed
233
/* istanbul ignore if */
234
if ($) {
235
  const JQUERY_NO_CONFLICT = $.fn[NAME]
236
  $.fn[NAME] = Toast.jQueryInterface
XhmikosR's avatar
XhmikosR committed
237
238
  $.fn[NAME].Constructor = Toast
  $.fn[NAME].noConflict = () => {
239
    $.fn[NAME] = JQUERY_NO_CONFLICT
240
    return Toast.jQueryInterface
241
  }
242
}
243
244

export default Toast