0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-01 13:24:25 +01:00
Bootstrap/js/dist/util.js

139 lines
4.3 KiB
JavaScript
Raw Normal View History

2015-05-07 21:48:22 +02:00
/**
* --------------------------------------------------------------------------
2018-01-18 17:21:22 +01:00
* Bootstrap (v4.0.0): util.js
2015-05-07 21:48:22 +02:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
2017-10-25 21:31:55 +02:00
var Util = function ($) {
/**
* ------------------------------------------------------------------------
* Private TransitionEnd Helpers
* ------------------------------------------------------------------------
*/
var transition = false;
2018-01-12 07:42:40 +01:00
var MAX_UID = 1000000; // Shoutout AngusCroll (https://goo.gl/pxwQGp)
2015-05-13 23:46:50 +02:00
2017-09-30 23:28:03 +02:00
function toType(obj) {
return {}.toString.call(obj).match(/\s([a-zA-Z]+)/)[1].toLowerCase();
2015-05-13 23:46:50 +02:00
}
function getSpecialTransitionEndEvent() {
return {
bindType: transition.end,
delegateType: transition.end,
handle: function handle(event) {
if ($(event.target).is(this)) {
2017-07-02 19:40:27 +02:00
return event.handleObj.handler.apply(this, arguments); // eslint-disable-line prefer-rest-params
}
2017-09-30 23:28:03 +02:00
2017-09-06 06:05:12 +02:00
return undefined; // eslint-disable-line no-undefined
}
};
}
2015-05-07 21:48:22 +02:00
function transitionEndTest() {
2018-01-12 07:42:40 +01:00
if (typeof window !== 'undefined' && window.QUnit) {
return false;
2015-05-07 21:48:22 +02:00
}
2017-12-23 01:21:54 +01:00
return {
end: 'transitionend'
};
2015-05-07 21:48:22 +02:00
}
function transitionEndEmulator(duration) {
var _this = this;
2015-05-07 21:48:22 +02:00
var called = false;
$(this).one(Util.TRANSITION_END, function () {
called = true;
});
setTimeout(function () {
if (!called) {
2015-05-08 07:26:40 +02:00
Util.triggerTransitionEnd(_this);
2015-05-07 21:48:22 +02:00
}
}, duration);
return this;
2015-05-07 21:48:22 +02:00
}
function setTransitionEndSupport() {
transition = transitionEndTest();
$.fn.emulateTransitionEnd = transitionEndEmulator;
if (Util.supportsTransitionEnd()) {
$.event.special[Util.TRANSITION_END] = getSpecialTransitionEndEvent();
2015-05-07 21:48:22 +02:00
}
}
2017-11-08 05:45:26 +01:00
function escapeId(selector) {
2018-01-12 07:42:40 +01:00
// We escape IDs in case of special selectors (selector = '#myId:something')
2017-11-08 05:45:26 +01:00
// $.escapeSelector does not exist in jQuery < 3
selector = typeof $.escapeSelector === 'function' ? $.escapeSelector(selector).substr(1) : selector.replace(/(:|\.|\[|\]|,|=|@)/g, '\\$1');
return selector;
}
/**
* --------------------------------------------------------------------------
* Public Util Api
* --------------------------------------------------------------------------
*/
2015-05-07 21:48:22 +02:00
2017-09-30 23:28:03 +02:00
var Util = {
TRANSITION_END: 'bsTransitionEnd',
getUID: function getUID(prefix) {
2015-08-19 05:28:28 +02:00
do {
2016-11-26 00:00:23 +01:00
// eslint-disable-next-line no-bitwise
2016-10-10 02:26:51 +02:00
prefix += ~~(Math.random() * MAX_UID); // "~~" acts like a faster Math.floor() here
2015-08-19 05:28:28 +02:00
} while (document.getElementById(prefix));
2017-09-30 23:28:03 +02:00
return prefix;
},
getSelectorFromElement: function getSelectorFromElement(element) {
var selector = element.getAttribute('data-target');
2017-09-30 23:28:03 +02:00
2017-03-20 03:03:32 +01:00
if (!selector || selector === '#') {
selector = element.getAttribute('href') || '';
2018-01-12 07:42:40 +01:00
} // If it's an ID
2017-11-08 05:45:26 +01:00
if (selector.charAt(0) === '#') {
selector = escapeId(selector);
}
2015-05-07 21:48:22 +02:00
2017-03-20 03:03:32 +01:00
try {
2017-09-06 06:05:12 +02:00
var $selector = $(document).find(selector);
2017-03-20 03:03:32 +01:00
return $selector.length > 0 ? selector : null;
2018-01-12 07:42:40 +01:00
} catch (err) {
2017-03-20 03:03:32 +01:00
return null;
}
},
reflow: function reflow(element) {
2016-10-30 23:21:53 +01:00
return element.offsetHeight;
},
2015-05-08 07:26:40 +02:00
triggerTransitionEnd: function triggerTransitionEnd(element) {
$(element).trigger(transition.end);
},
supportsTransitionEnd: function supportsTransitionEnd() {
2015-08-19 05:28:28 +02:00
return Boolean(transition);
2015-05-13 23:46:50 +02:00
},
2017-09-30 23:28:03 +02:00
isElement: function isElement(obj) {
return (obj[0] || obj).nodeType;
},
2015-05-13 23:46:50 +02:00
typeCheckConfig: function typeCheckConfig(componentName, config, configTypes) {
for (var property in configTypes) {
2017-09-06 06:05:12 +02:00
if (Object.prototype.hasOwnProperty.call(configTypes, property)) {
2015-08-19 05:28:28 +02:00
var expectedTypes = configTypes[property];
var value = config[property];
2017-09-30 23:28:03 +02:00
var valueType = value && Util.isElement(value) ? 'element' : toType(value);
2015-08-19 05:28:28 +02:00
if (!new RegExp(expectedTypes).test(valueType)) {
2017-09-30 23:28:03 +02:00
throw new Error(componentName.toUpperCase() + ": " + ("Option \"" + property + "\" provided type \"" + valueType + "\" ") + ("but expected type \"" + expectedTypes + "\"."));
2015-08-19 05:28:28 +02:00
}
2015-05-13 23:46:50 +02:00
}
}
}
};
setTransitionEndSupport();
return Util;
2017-10-16 00:51:44 +02:00
}($);
2017-04-22 08:58:09 +02:00
//# sourceMappingURL=util.js.map