util.js 4.19 KB
Newer Older
Mark Otto's avatar
dist    
Mark Otto committed
1
2
'use strict';

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

Mark Otto's avatar
dist    
Mark Otto 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
  var TransitionEndEvent = {
    WebkitTransition: 'webkitTransitionEnd',
    MozTransition: 'transitionend',
    OTransition: 'oTransitionEnd otransitionend',
    transition: 'transitionend'

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

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

37
38
39
40
41
42
  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
43
          return event.handleObj.handler.apply(this, arguments); // eslint-disable-line prefer-rest-params
44
        }
Mark Otto's avatar
dist    
Mark Otto committed
45
        return undefined; // eslint-disable-line no-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
    var el = document.createElement('bootstrap');
fat's avatar
fat committed
56

Mark Otto's avatar
grunt    
Mark Otto committed
57
    for (var name in TransitionEndEvent) {
Mark Otto's avatar
dist    
Mark Otto committed
58
      if (typeof el.style[name] !== 'undefined') {
Mark Otto's avatar
grunt    
Mark Otto committed
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) {
    var _this = this;
fat's avatar
fat committed
70

71
72
73
74
75
    var called = false;

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

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

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

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

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

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

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

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

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

106
    getUID: function getUID(prefix) {
Mark Otto's avatar
Mark Otto committed
107
      do {
Mark Otto's avatar
grunt    
Mark Otto committed
108
        // eslint-disable-next-line no-bitwise
Mark Otto's avatar
grunt    
Mark Otto committed
109
        prefix += ~~(Math.random() * MAX_UID); // "~~" acts like a faster Math.floor() here
Mark Otto's avatar
Mark Otto committed
110
      } while (document.getElementById(prefix));
111
112
113
114
      return prefix;
    },
    getSelectorFromElement: function getSelectorFromElement(element) {
      var selector = element.getAttribute('data-target');
Mark Otto's avatar
grunt    
Mark Otto committed
115
      if (!selector || selector === '#') {
116
117
        selector = element.getAttribute('href') || '';
      }
fat's avatar
fat committed
118

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

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

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

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