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

fat's avatar
fat committed
8
const Util = (($) => {
fat's avatar
fat committed
9
10


11
12
13
14
15
  /**
   * ------------------------------------------------------------------------
   * Private TransitionEnd Helpers
   * ------------------------------------------------------------------------
   */
fat's avatar
fat committed
16

17
  let transition = false
fat's avatar
fat committed
18

19
20
  const MAX_UID = 1000000

21
22
23
24
25
26
  const TransitionEndEvent = {
    WebkitTransition : 'webkitTransitionEnd',
    MozTransition    : 'transitionend',
    OTransition      : 'oTransitionEnd otransitionend',
    transition       : 'transitionend'
  }
fat's avatar
fat committed
27

fat's avatar
fat committed
28
29
  // shoutout AngusCroll (https://goo.gl/pxwQGp)
  function toType(obj) {
30
    return {}.toString.call(obj).match(/\s([a-zA-Z]+)/)[1].toLowerCase()
fat's avatar
fat committed
31
32
33
  }

  function isElement(obj) {
Jacob Thornton's avatar
Jacob Thornton committed
34
    return (obj[0] || obj).nodeType
fat's avatar
fat committed
35
36
  }

37
38
39
40
  function getSpecialTransitionEndEvent() {
    return {
      bindType: transition.end,
      delegateType: transition.end,
Jacob Thornton's avatar
Jacob Thornton committed
41
      handle(event) {
42
        if ($(event.target).is(this)) {
43
          return event.handleObj.handler.apply(this, arguments) // eslint-disable-line prefer-rest-params
44
        }
45
        return undefined
46
47
48
      }
    }
  }
fat's avatar
fat committed
49

50
51
52
  function transitionEndTest() {
    if (window.QUnit) {
      return false
fat's avatar
fat committed
53
54
    }

55
    const el = document.createElement('bootstrap')
fat's avatar
fat committed
56

57
    for (const name in TransitionEndEvent) {
58
      if (el.style[name] !== undefined) {
59
60
61
        return {
          end: TransitionEndEvent[name]
        }
62
63
      }
    }
fat's avatar
fat committed
64

65
    return false
fat's avatar
fat committed
66
67
  }

68
69
  function transitionEndEmulator(duration) {
    let called = false
fat's avatar
fat committed
70

Jacob Thornton's avatar
Jacob Thornton committed
71
    $(this).one(Util.TRANSITION_END, () => {
72
73
      called = true
    })
fat's avatar
fat committed
74

75
76
    setTimeout(() => {
      if (!called) {
fat's avatar
fat committed
77
        Util.triggerTransitionEnd(this)
fat's avatar
fat committed
78
      }
79
    }, duration)
fat's avatar
fat committed
80

81
    return this
fat's avatar
fat committed
82
83
  }

84
85
86
87
  function setTransitionEndSupport() {
    transition = transitionEndTest()

    $.fn.emulateTransitionEnd = transitionEndEmulator
fat's avatar
fat committed
88

89
90
    if (Util.supportsTransitionEnd()) {
      $.event.special[Util.TRANSITION_END] = getSpecialTransitionEndEvent()
fat's avatar
fat committed
91
92
93
94
    }
  }


95
96
97
98
99
  /**
   * --------------------------------------------------------------------------
   * Public Util Api
   * --------------------------------------------------------------------------
   */
fat's avatar
fat committed
100

101
  const Util = {
fat's avatar
fat committed
102

103
104
105
    TRANSITION_END: 'bsTransitionEnd',

    getUID(prefix) {
Jacob Thornton's avatar
Jacob Thornton committed
106
      do {
107
        // eslint-disable-next-line no-bitwise
108
        prefix += ~~(Math.random() * MAX_UID) // "~~" acts like a faster Math.floor() here
Jacob Thornton's avatar
Jacob Thornton committed
109
      } while (document.getElementById(prefix))
110
111
      return prefix
    },
fat's avatar
fat committed
112

113
114
    getSelectorFromElement(element) {
      let selector = element.getAttribute('data-target')
fat's avatar
fat committed
115

116
117
118
119
120
121
122
      if (!selector) {
        selector = element.getAttribute('href') || ''
        selector = /^#[a-z]/i.test(selector) ? selector : null
      }

      return selector
    },
fat's avatar
fat committed
123

124
    reflow(element) {
Ilias's avatar
Ilias committed
125
      return element.offsetHeight
126
127
    },

fat's avatar
fat committed
128
129
130
131
    triggerTransitionEnd(element) {
      $(element).trigger(transition.end)
    },

132
    supportsTransitionEnd() {
Jacob Thornton's avatar
Jacob Thornton committed
133
      return Boolean(transition)
fat's avatar
fat committed
134
135
136
    },

    typeCheckConfig(componentName, config, configTypes) {
137
      for (const property in configTypes) {
Jacob Thornton's avatar
Jacob Thornton committed
138
        if (configTypes.hasOwnProperty(property)) {
139
140
141
142
          const expectedTypes = configTypes[property]
          const value         = config[property]
          const valueType     = value && isElement(value) ?
                                'element' : toType(value)
Jacob Thornton's avatar
Jacob Thornton committed
143
144
145
146
147
148
149

          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
150
151
        }
      }
152
    }
fat's avatar
fat committed
153
154
  }

155
156
157
158
  setTransitionEndSupport()

  return Util

fat's avatar
fat committed
159
})(jQuery)
160
161

export default Util