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

Mark Otto's avatar
grunt    
Mark Otto committed
8
var Util = function ($) {
fat's avatar
fat committed
9

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

16
  var transition = false;
fat's avatar
fat committed
17

Chris Rebert's avatar
grunt    
Chris Rebert committed
18
19
  var MAX_UID = 1000000;

20
21
22
23
24
  var TransitionEndEvent = {
    WebkitTransition: 'webkitTransitionEnd',
    MozTransition: 'transitionend',
    OTransition: 'oTransitionEnd otransitionend',
    transition: 'transitionend'
Mark Otto's avatar
dist    
Mark Otto committed
25
  };
26

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

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

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

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

54
    var el = document.createElement('bootstrap');
fat's avatar
fat committed
55

Mark Otto's avatar
grunt    
Mark Otto committed
56
57
    for (var name in TransitionEndEvent) {
      if (el.style[name] !== undefined) {
Mark Otto's avatar
grunt    
Mark Otto committed
58
59
60
        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 {
Mark Otto's avatar
grunt    
Mark Otto committed
107
        // eslint-disable-next-line no-bitwise
Mark Otto's avatar
grunt    
Mark Otto committed
108
        prefix += ~~(Math.random() * MAX_UID); // "~~" acts like a faster Math.floor() here
Mark Otto's avatar
Mark Otto committed
109
      } while (document.getElementById(prefix));
110
111
112
113
      return prefix;
    },
    getSelectorFromElement: function getSelectorFromElement(element) {
      var selector = element.getAttribute('data-target');
Mark Otto's avatar
grunt    
Mark Otto committed
114
      if (!selector || selector === '#') {
115
116
        selector = element.getAttribute('href') || '';
      }
fat's avatar
fat committed
117

Mark Otto's avatar
grunt    
Mark Otto committed
118
119
120
121
122
123
      try {
        var $selector = $(selector);
        return $selector.length > 0 ? selector : null;
      } catch (error) {
        return null;
      }
124
125
    },
    reflow: function reflow(element) {
Mark Otto's avatar
grunt    
Mark Otto committed
126
      return element.offsetHeight;
127
    },
fat's avatar
fat committed
128
129
130
    triggerTransitionEnd: function triggerTransitionEnd(element) {
      $(element).trigger(transition.end);
    },
131
    supportsTransitionEnd: function supportsTransitionEnd() {
Mark Otto's avatar
Mark Otto committed
132
      return Boolean(transition);
fat's avatar
fat committed
133
134
135
    },
    typeCheckConfig: function typeCheckConfig(componentName, config, configTypes) {
      for (var property in configTypes) {
Mark Otto's avatar
Mark Otto committed
136
137
138
        if (configTypes.hasOwnProperty(property)) {
          var expectedTypes = configTypes[property];
          var value = config[property];
Mark Otto's avatar
grunt    
Mark Otto committed
139
          var valueType = value && isElement(value) ? 'element' : toType(value);
Mark Otto's avatar
Mark Otto committed
140
141
142
143

          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
144
145
        }
      }
146
147
    }
  };
fat's avatar
fat committed
148

149
  setTransitionEndSupport();
fat's avatar
fat committed
150

151
  return Util;
Mark Otto's avatar
grunt    
Mark Otto committed
152
}(jQuery);
Mark Otto's avatar
build    
Mark Otto committed
153
//# sourceMappingURL=util.js.map