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

'use strict';

fat's avatar
fat committed
10
var Util = (function ($) {
fat's avatar
fat committed
11

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

18
  var transition = false;
fat's avatar
fat committed
19

Chris Rebert's avatar
grunt    
Chris Rebert committed
20
21
  var MAX_UID = 1000000;

22
23
24
25
26
27
28
  var TransitionEndEvent = {
    WebkitTransition: 'webkitTransitionEnd',
    MozTransition: 'transitionend',
    OTransition: 'oTransitionEnd otransitionend',
    transition: 'transitionend'
  };

fat's avatar
fat committed
29
30
31
32
33
34
35
36
37
  // 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;
  }

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

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

56
    var el = document.createElement('bootstrap');
fat's avatar
fat committed
57

Mark Otto's avatar
Mark Otto committed
58
59
60
    for (var _name in TransitionEndEvent) {
      if (el.style[_name] !== undefined) {
        return { end: TransitionEndEvent[_name] };
61
62
      }
    }
fat's avatar
fat committed
63

64
    return false;
fat's avatar
fat committed
65
66
  }

67
68
  function transitionEndEmulator(duration) {
    var _this = this;
fat's avatar
fat committed
69

70
71
72
73
74
    var called = false;

    $(this).one(Util.TRANSITION_END, function () {
      called = true;
    });
fat's avatar
fat committed
75

76
77
    setTimeout(function () {
      if (!called) {
fat's avatar
fat committed
78
        Util.triggerTransitionEnd(_this);
fat's avatar
fat committed
79
      }
80
    }, duration);
fat's avatar
fat committed
81

82
    return this;
fat's avatar
fat committed
83
84
  }

85
86
  function setTransitionEndSupport() {
    transition = transitionEndTest();
fat's avatar
fat committed
87

88
89
90
91
    $.fn.emulateTransitionEnd = transitionEndEmulator;

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

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

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

103
    TRANSITION_END: 'bsTransitionEnd',
fat's avatar
fat committed
104

105
    getUID: function getUID(prefix) {
Mark Otto's avatar
Mark Otto committed
106
      do {
Chris Rebert's avatar
Chris Rebert committed
107
        /* eslint-disable no-bitwise */
Chris Rebert's avatar
grunt    
Chris Rebert committed
108
        prefix += ~ ~(Math.random() * MAX_UID); // "~~" acts like a faster Math.floor() here
Chris Rebert's avatar
Chris Rebert committed
109
        /* eslint-enable no-bitwise */
Mark Otto's avatar
Mark Otto committed
110
      } while (document.getElementById(prefix));
111
112
      return prefix;
    },
fat's avatar
fat committed
113

114
115
116
117
118
119
120
    getSelectorFromElement: function getSelectorFromElement(element) {
      var selector = element.getAttribute('data-target');

      if (!selector) {
        selector = element.getAttribute('href') || '';
        selector = /^#[a-z]/i.test(selector) ? selector : null;
      }
fat's avatar
fat committed
121

122
123
      return selector;
    },
fat's avatar
fat committed
124

125
126
127
    reflow: function reflow(element) {
      new Function('bs', 'return bs')(element.offsetHeight);
    },
fat's avatar
fat committed
128

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

133
    supportsTransitionEnd: function supportsTransitionEnd() {
Mark Otto's avatar
Mark Otto committed
134
      return Boolean(transition);
fat's avatar
fat committed
135
136
137
138
    },

    typeCheckConfig: function typeCheckConfig(componentName, config, configTypes) {
      for (var property in configTypes) {
Mark Otto's avatar
Mark Otto committed
139
140
141
142
143
144
145
146
147
148
149
150
151
152
        if (configTypes.hasOwnProperty(property)) {
          var expectedTypes = configTypes[property];
          var value = config[property];
          var valueType = undefined;

          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 + '".'));
          }
fat's avatar
fat committed
153
154
        }
      }
155
156
    }
  };
fat's avatar
fat committed
157

158
  setTransitionEndSupport();
fat's avatar
fat committed
159

160
  return Util;
fat's avatar
fat committed
161
})(jQuery);
Jacob Thornton's avatar
Jacob Thornton committed
162
//# sourceMappingURL=util.js.map