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

Johann-S's avatar
Johann-S committed
8
import EventHandler from './dom/eventHandler'
fat's avatar
fat committed
9

Johann-S's avatar
Johann-S committed
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/**
 * ------------------------------------------------------------------------
 * Private TransitionEnd Helpers
 * ------------------------------------------------------------------------
 */

const TRANSITION_END = 'transitionend'
const MAX_UID = 1000000
const MILLISECONDS_MULTIPLIER = 1000

// Shoutout AngusCroll (https://goo.gl/pxwQGp)
function toType(obj) {
  return {}.toString.call(obj).match(/\s([a-z]+)/i)[1].toLowerCase()
}

25
26
27
28
29
30
31
32
33
34
35
36
37
38
function normalizeData(val) {
  if (val === 'true') {
    return true
  } else if (val === 'false') {
    return false
  } else if (val === 'null') {
    return null
  } else if (val === Number(val).toString()) {
    return Number(val)
  }

  return val
}

Johann-S's avatar
Johann-S committed
39
const Util = {
fat's avatar
fat committed
40

Johann-S's avatar
Johann-S committed
41
  TRANSITION_END: 'bsTransitionEnd',
42

Johann-S's avatar
Johann-S committed
43
44
45
46
47
48
49
  getUID(prefix) {
    do {
      // eslint-disable-next-line no-bitwise
      prefix += ~~(Math.random() * MAX_UID) // "~~" acts like a faster Math.floor() here
    } while (document.getElementById(prefix))
    return prefix
  },
fat's avatar
fat committed
50

Johann-S's avatar
Johann-S committed
51
52
  getSelectorFromElement(element) {
    let selector = element.getAttribute('data-target')
53

Johann-S's avatar
Johann-S committed
54
55
56
57
    if (!selector || selector === '#') {
      const hrefAttr = element.getAttribute('href')
      selector = hrefAttr && hrefAttr !== '#' ? hrefAttr.trim() : ''
    }
58

59
60
61
62
63
    try {
      return document.querySelector(selector) ? selector : null
    } catch (err) {
      return null
    }
Johann-S's avatar
Johann-S committed
64
  },
fat's avatar
fat committed
65

Johann-S's avatar
Johann-S committed
66
67
68
69
  getTransitionDurationFromElement(element) {
    if (!element) {
      return 0
    }
70

Johann-S's avatar
Johann-S committed
71
    // Get transition-duration of the element
XhmikosR's avatar
XhmikosR committed
72
73
    let transitionDuration = element.style.transitionDuration
    let transitionDelay = element.style.transitionDelay
74

Johann-S's avatar
Johann-S committed
75
    const floatTransitionDuration = parseFloat(transitionDuration)
76
    const floatTransitionDelay = parseFloat(transitionDelay)
77

Johann-S's avatar
Johann-S committed
78
    // Return 0 if element or transition duration is not found
79
    if (!floatTransitionDuration && !floatTransitionDelay) {
Johann-S's avatar
Johann-S committed
80
81
      return 0
    }
82

Johann-S's avatar
Johann-S committed
83
84
    // If multiple durations are defined, take the first
    transitionDuration = transitionDuration.split(',')[0]
85
    transitionDelay = transitionDelay.split(',')[0]
Johann-S's avatar
Johann-S committed
86

87
    return (parseFloat(transitionDuration) + parseFloat(transitionDelay)) * MILLISECONDS_MULTIPLIER
Johann-S's avatar
Johann-S committed
88
89
90
91
92
93
94
  },

  reflow(element) {
    return element.offsetHeight
  },

  triggerTransitionEnd(element) {
Johann-S's avatar
Johann-S committed
95
    EventHandler.trigger(element, Util.TRANSITION_END)
Johann-S's avatar
Johann-S committed
96
97
98
99
100
101
102
103
104
105
106
  },

  // TODO: Remove in v5
  supportsTransitionEnd() {
    return Boolean(TRANSITION_END)
  },

  isElement(obj) {
    return (obj[0] || obj).nodeType
  },

Johann-S's avatar
Johann-S committed
107
108
109
110
111
112
  emulateTransitionEnd(element, duration) {
    setTimeout(() => {
      Util.triggerTransitionEnd(element)
    }, duration)
  },

Johann-S's avatar
Johann-S committed
113
114
115
116
117
118
119
120
121
122
123
124
125
  typeCheckConfig(componentName, config, configTypes) {
    for (const property in configTypes) {
      if (Object.prototype.hasOwnProperty.call(configTypes, property)) {
        const expectedTypes = configTypes[property]
        const value         = config[property]
        const valueType     = value && Util.isElement(value)
          ? 'element' : toType(value)

        if (!new RegExp(expectedTypes).test(valueType)) {
          throw new Error(
            `${componentName.toUpperCase()}: ` +
            `Option "${property}" provided type "${valueType}" ` +
            `but expected type "${expectedTypes}".`)
fat's avatar
fat committed
126
127
        }
      }
128
129
130
131
132
133
134
135
136
137
138
139
140
141
    }
  },

  extend(obj1, ...others) {
    const obj2 = others.shift()
    for (const secondProp in obj2) {
      if (Object.prototype.hasOwnProperty.call(obj2, secondProp)) {
        const secondVal = obj2[secondProp]
        // Is this value an object?  If so, iterate over its properties, copying them over
        if (secondVal && Object.prototype.toString.call(secondVal) === '[object Object]') {
          obj1[secondProp] = obj1[secondProp] || {}
          Util.extend(obj1[secondProp], secondVal)
        } else {
          obj1[secondProp] = secondVal
Johann-S's avatar
Johann-S committed
142
143
        }
      }
144
    }
Johann-S's avatar
Johann-S committed
145

146
147
148
    if (others.length) {
      this.extend(obj1, ...others)
    }
Johann-S's avatar
Johann-S committed
149

150
151
152
153
154
155
156
157
158
    return obj1
  },

  makeArray(nodeList) {
    if (typeof nodeList === 'undefined' || nodeList === null) {
      return []
    }
    return Array.prototype.slice.call(nodeList)
  },
Johann-S's avatar
Johann-S committed
159

160
161
162
163
164
165
166
167
168
169
  getDataAttributes(element) {
    if (typeof element === 'undefined' || element === null) {
      return {}
    }

    let attributes
    if (Object.getOwnPropertyDescriptor(HTMLElement.prototype, 'dataset')) {
      attributes = this.extend({}, element.dataset)
    } else {
      attributes = {}
Johann-S's avatar
Johann-S committed
170
171
172
173
      for (let i = 0; i < element.attributes.length; i++) {
        const attribute = element.attributes[i]
        if (attribute.nodeName.indexOf('data-') !== -1) {
          // remove 'data-' part of the attribute name
174
          const attributeName = attribute.nodeName.substring('data-'.length).replace(/-./g, (str) => str.charAt(1).toUpperCase())
Johann-S's avatar
Johann-S committed
175
176
177
          attributes[attributeName] = attribute.nodeValue
        }
      }
178
    }
Johann-S's avatar
Johann-S committed
179

180
181
182
    for (const key in attributes) {
      if (!Object.prototype.hasOwnProperty.call(attributes, key)) {
        continue
Johann-S's avatar
Johann-S committed
183
184
      }

185
186
187
188
189
190
191
192
193
194
195
196
      attributes[key] = normalizeData(attributes[key])
    }

    return attributes
  },

  getDataAttribute(element, key) {
    return normalizeData(element.getAttribute(`data-${key.replace(/[A-Z]/g, (chr) => `-${chr.toLowerCase()}`)}`))
  },

  isVisible(element) {
    if (typeof element === 'undefined' || element === null) {
Johann-S's avatar
Johann-S committed
197
      return false
198
    }
199
200
201
202
203
204
205

    if (element.style !== null && element.parentNode !== null && typeof element.parentNode.style !== 'undefined') {
      return element.style.display !== 'none' &&
        element.parentNode.style.display !== 'none' &&
        element.style.visibility !== 'hidden'
    }
    return false
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
  },

  findShadowRoot(element) {
    if (!document.documentElement.attachShadow) {
      return null
    }

    // Can find the shadow root otherwise it'll return the document
    if (typeof element.getRootNode === 'function') {
      const root = element.getRootNode()
      return root instanceof ShadowRoot ? root : null
    }

    if (element instanceof ShadowRoot) {
      return element
    }

    // when we don't find a shadow root
    if (!element.parentNode) {
      return null
    }

    return Util.findShadowRoot(element.parentNode)
229
230
231
232
  },

  get jQuery() {
    return window.$ || window.jQuery
fat's avatar
fat committed
233
  }
Johann-S's avatar
Johann-S committed
234
}
fat's avatar
fat committed
235

236
export default Util