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

8
import {
9
  getjQuery,
10
11
  TRANSITION_END,
  emulateTransitionEnd,
12
  getElementFromSelector,
13
14
15
  getTransitionDurationFromElement,
  makeArray,
  reflow
16
17
18
19
} from './util/index'
import Data from './dom/data'
import EventHandler from './dom/event-handler'
import SelectorEngine from './dom/selector-engine'
20

Johann-S's avatar
Johann-S committed
21
22
23
24
25
26
/**
 * ------------------------------------------------------------------------
 * Constants
 * ------------------------------------------------------------------------
 */

XhmikosR's avatar
XhmikosR committed
27
28
29
30
31
const NAME = 'tab'
const VERSION = '4.3.1'
const DATA_KEY = 'bs.tab'
const EVENT_KEY = `.${DATA_KEY}`
const DATA_API_KEY = '.data-api'
Johann-S's avatar
Johann-S committed
32

XhmikosR's avatar
XhmikosR committed
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
const EVENT_HIDE = `hide${EVENT_KEY}`
const EVENT_HIDDEN = `hidden${EVENT_KEY}`
const EVENT_SHOW = `show${EVENT_KEY}`
const EVENT_SHOWN = `shown${EVENT_KEY}`
const EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`

const CLASS_NAME_DROPDOWN_MENU = 'dropdown-menu'
const CLASS_NAME_ACTIVE = 'active'
const CLASS_NAME_DISABLED = 'disabled'
const CLASS_NAME_FADE = 'fade'
const CLASS_NAME_SHOW = 'show'

const SELECTOR_DROPDOWN = '.dropdown'
const SELECTOR_NAV_LIST_GROUP = '.nav, .list-group'
const SELECTOR_ACTIVE = '.active'
const SELECTOR_ACTIVE_UL = ':scope > li > .active'
const SELECTOR_DATA_TOGGLE = '[data-toggle="tab"], [data-toggle="pill"], [data-toggle="list"]'
const SELECTOR_DROPDOWN_TOGGLE = '.dropdown-toggle'
const SELECTOR_DROPDOWN_ACTIVE_CHILD = ':scope > .dropdown-menu .active'
fat's avatar
tab es6  
fat committed
52

Johann-S's avatar
Johann-S committed
53
54
55
56
57
58
59
60
61
/**
 * ------------------------------------------------------------------------
 * Class Definition
 * ------------------------------------------------------------------------
 */

class Tab {
  constructor(element) {
    this._element = element
62
63

    Data.setData(this._element, DATA_KEY, this)
fat's avatar
tab es6  
fat committed
64
65
  }

Johann-S's avatar
Johann-S committed
66
67
68
69
  // Getters

  static get VERSION() {
    return VERSION
fat's avatar
tab es6  
fat committed
70
71
  }

Johann-S's avatar
Johann-S committed
72
  // Public
fat's avatar
tab es6  
fat committed
73

Johann-S's avatar
Johann-S committed
74
  show() {
75
    if ((this._element.parentNode &&
76
      this._element.parentNode.nodeType === Node.ELEMENT_NODE &&
XhmikosR's avatar
XhmikosR committed
77
78
      this._element.classList.contains(CLASS_NAME_ACTIVE)) ||
      this._element.classList.contains(CLASS_NAME_DISABLED)) {
Johann-S's avatar
Johann-S committed
79
      return
fat's avatar
tab es6  
fat committed
80
81
    }

Johann-S's avatar
Johann-S committed
82
    let previous
83
    const target = getElementFromSelector(this._element)
XhmikosR's avatar
XhmikosR committed
84
    const listElement = SelectorEngine.closest(this._element, SELECTOR_NAV_LIST_GROUP)
fat's avatar
tab es6  
fat committed
85

Johann-S's avatar
Johann-S committed
86
    if (listElement) {
XhmikosR's avatar
XhmikosR committed
87
      const itemSelector = listElement.nodeName === 'UL' || listElement.nodeName === 'OL' ? SELECTOR_ACTIVE_UL : SELECTOR_ACTIVE
88
      previous = makeArray(SelectorEngine.find(itemSelector, listElement))
Johann-S's avatar
Johann-S committed
89
      previous = previous[previous.length - 1]
fat's avatar
tab es6  
fat committed
90
91
    }

92
    let hideEvent = null
fat's avatar
tab es6  
fat committed
93

Johann-S's avatar
Johann-S committed
94
    if (previous) {
XhmikosR's avatar
XhmikosR committed
95
      hideEvent = EventHandler.trigger(previous, EVENT_HIDE, {
96
97
        relatedTarget: this._element
      })
Johann-S's avatar
Johann-S committed
98
    }
fat's avatar
tab es6  
fat committed
99

XhmikosR's avatar
XhmikosR committed
100
    const showEvent = EventHandler.trigger(this._element, EVENT_SHOW, {
101
102
      relatedTarget: previous
    })
Johann-S's avatar
Johann-S committed
103

104
    if (showEvent.defaultPrevented ||
105
      (hideEvent !== null && hideEvent.defaultPrevented)) {
Johann-S's avatar
Johann-S committed
106
107
      return
    }
fat's avatar
tab es6  
fat committed
108

Johann-S's avatar
Johann-S committed
109
110
111
112
113
114
    this._activate(
      this._element,
      listElement
    )

    const complete = () => {
XhmikosR's avatar
XhmikosR committed
115
      EventHandler.trigger(previous, EVENT_HIDDEN, {
fat's avatar
tab es6  
fat committed
116
117
        relatedTarget: this._element
      })
XhmikosR's avatar
XhmikosR committed
118
      EventHandler.trigger(this._element, EVENT_SHOWN, {
fat's avatar
tab es6  
fat committed
119
120
        relatedTarget: previous
      })
Johann-S's avatar
Johann-S committed
121
    }
fat's avatar
tab es6  
fat committed
122

Johann-S's avatar
Johann-S committed
123
124
125
126
127
128
    if (target) {
      this._activate(target, target.parentNode, complete)
    } else {
      complete()
    }
  }
fat's avatar
tab es6  
fat committed
129

Johann-S's avatar
Johann-S committed
130
  dispose() {
131
    Data.removeData(this._element, DATA_KEY)
Johann-S's avatar
Johann-S committed
132
133
    this._element = null
  }
fat's avatar
tab es6  
fat committed
134

Johann-S's avatar
Johann-S committed
135
  // Private
fat's avatar
tab es6  
fat committed
136

Johann-S's avatar
Johann-S committed
137
  _activate(element, container, callback) {
XhmikosR's avatar
XhmikosR committed
138
    const activeElements = container && (container.nodeName === 'UL' || container.nodeName === 'OL') ?
XhmikosR's avatar
XhmikosR committed
139
140
      SelectorEngine.find(SELECTOR_ACTIVE_UL, container) :
      SelectorEngine.children(container, SELECTOR_ACTIVE)
141

XhmikosR's avatar
XhmikosR committed
142
    const active = activeElements[0]
143
    const isTransitioning = callback &&
XhmikosR's avatar
XhmikosR committed
144
      (active && active.classList.contains(CLASS_NAME_FADE))
fat's avatar
tab es6  
fat committed
145

Johann-S's avatar
Johann-S committed
146
147
148
149
150
    const complete = () => this._transitionComplete(
      element,
      active,
      callback
    )
fat's avatar
tab es6  
fat committed
151

Johann-S's avatar
Johann-S committed
152
    if (active && isTransitioning) {
153
      const transitionDuration = getTransitionDurationFromElement(active)
XhmikosR's avatar
XhmikosR committed
154
      active.classList.remove(CLASS_NAME_SHOW)
fat's avatar
tab es6  
fat committed
155

156
157
      EventHandler.one(active, TRANSITION_END, complete)
      emulateTransitionEnd(active, transitionDuration)
Johann-S's avatar
Johann-S committed
158
159
    } else {
      complete()
fat's avatar
tab es6  
fat committed
160
    }
Johann-S's avatar
Johann-S committed
161
  }
fat's avatar
tab es6  
fat committed
162

Johann-S's avatar
Johann-S committed
163
164
  _transitionComplete(element, active, callback) {
    if (active) {
XhmikosR's avatar
XhmikosR committed
165
      active.classList.remove(CLASS_NAME_ACTIVE)
fat's avatar
fat committed
166

XhmikosR's avatar
XhmikosR committed
167
      const dropdownChild = SelectorEngine.findOne(SELECTOR_DROPDOWN_ACTIVE_CHILD, active.parentNode)
fat's avatar
tab es6  
fat committed
168

Johann-S's avatar
Johann-S committed
169
      if (dropdownChild) {
XhmikosR's avatar
XhmikosR committed
170
        dropdownChild.classList.remove(CLASS_NAME_ACTIVE)
171
172
      }

Johann-S's avatar
Johann-S committed
173
174
      if (active.getAttribute('role') === 'tab') {
        active.setAttribute('aria-selected', false)
fat's avatar
tab es6  
fat committed
175
176
177
      }
    }

XhmikosR's avatar
XhmikosR committed
178
    element.classList.add(CLASS_NAME_ACTIVE)
Johann-S's avatar
Johann-S committed
179
180
181
    if (element.getAttribute('role') === 'tab') {
      element.setAttribute('aria-selected', true)
    }
182

183
    reflow(element)
184

XhmikosR's avatar
XhmikosR committed
185
186
    if (element.classList.contains(CLASS_NAME_FADE)) {
      element.classList.add(CLASS_NAME_SHOW)
187
    }
fat's avatar
tab es6  
fat committed
188

XhmikosR's avatar
XhmikosR committed
189
190
    if (element.parentNode && element.parentNode.classList.contains(CLASS_NAME_DROPDOWN_MENU)) {
      const dropdownElement = SelectorEngine.closest(element, SELECTOR_DROPDOWN)
191

Johann-S's avatar
Johann-S committed
192
      if (dropdownElement) {
XhmikosR's avatar
XhmikosR committed
193
194
        makeArray(SelectorEngine.find(SELECTOR_DROPDOWN_TOGGLE))
          .forEach(dropdown => dropdown.classList.add(CLASS_NAME_ACTIVE))
fat's avatar
tab es6  
fat committed
195
196
      }

Johann-S's avatar
Johann-S committed
197
198
      element.setAttribute('aria-expanded', true)
    }
fat's avatar
tab es6  
fat committed
199

Johann-S's avatar
Johann-S committed
200
201
    if (callback) {
      callback()
fat's avatar
tab es6  
fat committed
202
    }
Johann-S's avatar
Johann-S committed
203
  }
fat's avatar
tab es6  
fat committed
204

Johann-S's avatar
Johann-S committed
205
  // Static
fat's avatar
tab es6  
fat committed
206

207
  static jQueryInterface(config) {
Johann-S's avatar
Johann-S committed
208
    return this.each(function () {
209
      const data = Data.getData(this, DATA_KEY) || new Tab(this)
fat's avatar
tab es6  
fat committed
210

Johann-S's avatar
Johann-S committed
211
212
213
      if (typeof config === 'string') {
        if (typeof data[config] === 'undefined') {
          throw new TypeError(`No method named "${config}"`)
fat's avatar
tab es6  
fat committed
214
        }
XhmikosR's avatar
XhmikosR committed
215

Johann-S's avatar
Johann-S committed
216
217
218
        data[config]()
      }
    })
fat's avatar
tab es6  
fat committed
219
  }
220

221
  static getInstance(element) {
222
223
    return Data.getData(element, DATA_KEY)
  }
Johann-S's avatar
Johann-S committed
224
}
fat's avatar
tab es6  
fat committed
225

Johann-S's avatar
Johann-S committed
226
227
228
229
230
/**
 * ------------------------------------------------------------------------
 * Data Api implementation
 * ------------------------------------------------------------------------
 */
fat's avatar
tab es6  
fat committed
231

XhmikosR's avatar
XhmikosR committed
232
EventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {
233
234
235
236
237
  event.preventDefault()

  const data = Data.getData(this, DATA_KEY) || new Tab(this)
  data.show()
})
fat's avatar
tab es6  
fat committed
238

239
240
const $ = getjQuery()

Johann-S's avatar
Johann-S committed
241
242
243
244
/**
 * ------------------------------------------------------------------------
 * jQuery
 * ------------------------------------------------------------------------
245
 * add .tab to jQuery only if jQuery is present
Johann-S's avatar
Johann-S committed
246
 */
Johann-S's avatar
Johann-S committed
247
/* istanbul ignore if */
248
if ($) {
249
  const JQUERY_NO_CONFLICT = $.fn[NAME]
250
  $.fn[NAME] = Tab.jQueryInterface
XhmikosR's avatar
XhmikosR committed
251
252
  $.fn[NAME].Constructor = Tab
  $.fn[NAME].noConflict = () => {
253
    $.fn[NAME] = JQUERY_NO_CONFLICT
254
    return Tab.jQueryInterface
255
  }
Johann-S's avatar
Johann-S committed
256
}
fat's avatar
tab es6  
fat committed
257
258

export default Tab