toast.js 5.13 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
9
10
11
12
13
14
import {
  jQuery as $,
  TRANSITION_END,
  emulateTransitionEnd,
  getTransitionDurationFromElement,
  typeCheckConfig
} from './util/index'
15
import Data from './dom/data'
16
import EventHandler from './dom/event-handler'
17
import Manipulator from './dom/manipulator'
18

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

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

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

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

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

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

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

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

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

76
  // Getters
77

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

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

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

90
  // Public
91

92
  show() {
93
    EventHandler.trigger(this._element, Event.SHOW)
94

95
96
97
    if (this._config.animation) {
      this._element.classList.add(ClassName.FADE)
    }
98

99
    const complete = () => {
Johann-S's avatar
Johann-S committed
100
101
102
      this._element.classList.remove(ClassName.SHOWING)
      this._element.classList.add(ClassName.SHOW)

103
      EventHandler.trigger(this._element, Event.SHOWN)
104

105
      if (this._config.autohide) {
ysds's avatar
ysds committed
106
107
108
        this._timeout = setTimeout(() => {
          this.hide()
        }, this._config.delay)
109
      }
110
    }
111

Johann-S's avatar
Johann-S committed
112
113
    this._element.classList.remove(ClassName.HIDE)
    this._element.classList.add(ClassName.SHOWING)
114
    if (this._config.animation) {
115
      const transitionDuration = getTransitionDurationFromElement(this._element)
116

117
118
      EventHandler.one(this._element, TRANSITION_END, complete)
      emulateTransitionEnd(this._element, transitionDuration)
119
120
    } else {
      complete()
121
    }
122
  }
123

ysds's avatar
ysds committed
124
  hide() {
125
126
127
    if (!this._element.classList.contains(ClassName.SHOW)) {
      return
    }
128

129
    EventHandler.trigger(this._element, Event.HIDE)
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

    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()
    }
145
  }
146

147
148
149
  dispose() {
    clearTimeout(this._timeout)
    this._timeout = null
150

151
152
    if (this._element.classList.contains(ClassName.SHOW)) {
      this._element.classList.remove(ClassName.SHOW)
153
154
    }

155
156
    EventHandler.off(this._element, Event.CLICK_DISMISS)
    Data.removeData(this._element, DATA_KEY)
157

158
    this._element = null
XhmikosR's avatar
XhmikosR committed
159
    this._config = null
160
  }
161

162
  // Private
163

164
165
166
  _getConfig(config) {
    config = {
      ...Default,
167
      ...Manipulator.getDataAttributes(this._element),
168
      ...typeof config === 'object' && config ? config : {}
169
170
    }

171
    typeCheckConfig(
172
173
174
175
      NAME,
      config,
      this.constructor.DefaultType
    )
176

177
178
    return config
  }
179

180
  _setListeners() {
181
182
    EventHandler.on(
      this._element,
183
184
      Event.CLICK_DISMISS,
      Selector.DATA_DISMISS,
ysds's avatar
ysds committed
185
      () => this.hide()
186
187
    )
  }
188

189
190
191
192
  // Static

  static _jQueryInterface(config) {
    return this.each(function () {
XhmikosR's avatar
XhmikosR committed
193
194
      let data = Data.getData(this, DATA_KEY)
      const _config = typeof config === 'object' && config
195
196
197
198

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

200
201
202
      if (typeof config === 'string') {
        if (typeof data[config] === 'undefined') {
          throw new TypeError(`No method named "${config}"`)
203
204
        }

205
206
207
        data[config](this)
      }
    })
208
  }
209
210
211
212

  static _getInstance(element) {
    return Data.getData(element, DATA_KEY)
  }
213
214
215
216
217
218
}

/**
 * ------------------------------------------------------------------------
 * jQuery
 * ------------------------------------------------------------------------
219
 *  add .toast to jQuery only if jQuery is present
220
 */
221

222
223
if (typeof $ !== 'undefined') {
  const JQUERY_NO_CONFLICT = $.fn[NAME]
XhmikosR's avatar
XhmikosR committed
224
225
226
  $.fn[NAME] = Toast._jQueryInterface
  $.fn[NAME].Constructor = Toast
  $.fn[NAME].noConflict = () => {
227
228
229
    $.fn[NAME] = JQUERY_NO_CONFLICT
    return Toast._jQueryInterface
  }
230
}
231
232

export default Toast