util.js 3.6 KB
Newer Older
fat's avatar
fat committed
1
2
3
4
5
6
7
/**
 * --------------------------------------------------------------------------
 * Bootstrap (v4.0.0): util.js
 * 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
21
22
23
24
  const TransitionEndEvent = {
    WebkitTransition : 'webkitTransitionEnd',
    MozTransition    : 'transitionend',
    OTransition      : 'oTransitionEnd otransitionend',
    transition       : 'transitionend'
  }
fat's avatar
fat committed
25

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

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

35
36
37
38
39
40
41
42
43
44
45
  function getSpecialTransitionEndEvent() {
    return {
      bindType: transition.end,
      delegateType: transition.end,
      handle: function (event) {
        if ($(event.target).is(this)) {
          return event.handleObj.handler.apply(this, arguments)
        }
      }
    }
  }
fat's avatar
fat committed
46

47
48
49
  function transitionEndTest() {
    if (window.QUnit) {
      return false
fat's avatar
fat committed
50
51
    }

52
    let el = document.createElement('bootstrap')
fat's avatar
fat committed
53

54
55
56
57
58
    for (var name in TransitionEndEvent) {
      if (el.style[name] !== undefined) {
        return { end: TransitionEndEvent[name] }
      }
    }
fat's avatar
fat committed
59

60
    return false
fat's avatar
fat committed
61
62
  }

63
64
  function transitionEndEmulator(duration) {
    let called = false
fat's avatar
fat committed
65

66
67
68
    $(this).one(Util.TRANSITION_END, function () {
      called = true
    })
fat's avatar
fat committed
69

70
71
    setTimeout(() => {
      if (!called) {
fat's avatar
fat committed
72
        Util.triggerTransitionEnd(this)
fat's avatar
fat committed
73
      }
74
    }, duration)
fat's avatar
fat committed
75

76
    return this
fat's avatar
fat committed
77
78
  }

79
80
81
82
  function setTransitionEndSupport() {
    transition = transitionEndTest()

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

84
85
    if (Util.supportsTransitionEnd()) {
      $.event.special[Util.TRANSITION_END] = getSpecialTransitionEndEvent()
fat's avatar
fat committed
86
87
88
89
    }
  }


90
91
92
93
94
  /**
   * --------------------------------------------------------------------------
   * Public Util Api
   * --------------------------------------------------------------------------
   */
fat's avatar
fat committed
95

96
  let Util = {
fat's avatar
fat committed
97

98
99
100
101
102
103
104
    TRANSITION_END: 'bsTransitionEnd',

    getUID(prefix) {
      do prefix += ~~(Math.random() * 1000000)
      while (document.getElementById(prefix))
      return prefix
    },
fat's avatar
fat committed
105

106
107
    getSelectorFromElement(element) {
      let selector = element.getAttribute('data-target')
fat's avatar
fat committed
108

109
110
111
112
113
114
115
      if (!selector) {
        selector = element.getAttribute('href') || ''
        selector = /^#[a-z]/i.test(selector) ? selector : null
      }

      return selector
    },
fat's avatar
fat committed
116

117
118
119
120
    reflow(element) {
      new Function('bs', 'return bs')(element.offsetHeight)
    },

fat's avatar
fat committed
121
122
123
124
    triggerTransitionEnd(element) {
      $(element).trigger(transition.end)
    },

125
126
    supportsTransitionEnd() {
      return !!transition
fat's avatar
fat committed
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
    },

    typeCheckConfig(componentName, config, configTypes) {

      for (let property in configTypes) {
        let expectedTypes = configTypes[property]
        let value         = config[property]
        let valueType

        if (value && isElement(value)) valueType = 'element'
        else valueType = toType(value)

        if (!new RegExp(expectedTypes).test(valueType)) {
          throw new Error(
            `${componentName.toUpperCase()}: ` +
            `Option "${property}" provided type "${valueType}" ` +
            `but expected type "${expectedTypes}".`)
        }
      }
146
    }
fat's avatar
fat committed
147
148
149

  }

150
151
152
153
  setTransitionEndSupport()

  return Util

fat's avatar
fat committed
154
})(jQuery)
155
156

export default Util