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

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

  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)) {
Mark Otto's avatar
Mark Otto committed
44
          return event.handleObj.handler.apply(this, arguments); // eslint-disable-line prefer-rest-params
45
        }
Mark Otto's avatar
dist    
Mark Otto committed
46
        return undefined; // eslint-disable-line no-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
grunt    
Mark Otto committed
58
    for (var name in TransitionEndEvent) {
Mark Otto's avatar
dist    
Mark Otto committed
59
      if (typeof el.style[name] !== 'undefined') {
Mark Otto's avatar
grunt    
Mark Otto committed
60
61
62
        return {
          end: TransitionEndEvent[name]
        };
63
64
      }
    }
fat's avatar
fat committed
65

66
    return false;
fat's avatar
fat committed
67
68
  }

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

72
73
74
75
76
    var called = false;

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

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

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

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

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

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

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

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

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

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

Mark Otto's avatar
grunt    
Mark Otto committed
120
      try {
Mark Otto's avatar
dist    
Mark Otto committed
121
        var $selector = $(document).find(selector);
Mark Otto's avatar
grunt    
Mark Otto committed
122
123
124
125
        return $selector.length > 0 ? selector : null;
      } catch (error) {
        return null;
      }
126
127
    },
    reflow: function reflow(element) {
Mark Otto's avatar
grunt    
Mark Otto committed
128
      return element.offsetHeight;
129
    },
fat's avatar
fat committed
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
    },
    typeCheckConfig: function typeCheckConfig(componentName, config, configTypes) {
      for (var property in configTypes) {
Mark Otto's avatar
dist    
Mark Otto committed
138
        if (Object.prototype.hasOwnProperty.call(configTypes, property)) {
Mark Otto's avatar
Mark Otto committed
139
140
          var expectedTypes = configTypes[property];
          var value = config[property];
Mark Otto's avatar
grunt    
Mark Otto committed
141
          var valueType = value && isElement(value) ? 'element' : toType(value);
Mark Otto's avatar
Mark Otto committed
142
143
144
145

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

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

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