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

424 lines
12 KiB
JavaScript
Raw Normal View History

2018-11-13 07:41:12 +01:00
/*!
2021-10-09 08:33:12 +02:00
* Bootstrap toast.js v5.1.3 (https://getbootstrap.com/)
* Copyright 2011-2021 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors)
2020-06-16 20:50:01 +02:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
2018-11-13 07:41:12 +01:00
*/
(function (global, factory) {
typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory(require('./dom/event-handler.js'), require('./dom/manipulator.js'), require('./base-component.js')) :
typeof define === 'function' && define.amd ? define(['./dom/event-handler', './dom/manipulator', './base-component'], factory) :
(global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.Toast = factory(global.EventHandler, global.Manipulator, global.Base));
2021-10-05 17:50:18 +02:00
})(this, (function (EventHandler, Manipulator, BaseComponent) { 'use strict';
2018-11-13 07:41:12 +01:00
2021-10-05 17:50:18 +02:00
const _interopDefaultLegacy = e => e && typeof e === 'object' && 'default' in e ? e : { default: e };
2020-09-14 17:12:06 +02:00
2021-10-05 17:50:18 +02:00
const EventHandler__default = /*#__PURE__*/_interopDefaultLegacy(EventHandler);
const Manipulator__default = /*#__PURE__*/_interopDefaultLegacy(Manipulator);
const BaseComponent__default = /*#__PURE__*/_interopDefaultLegacy(BaseComponent);
2021-08-04 17:41:51 +02:00
/**
* --------------------------------------------------------------------------
2021-10-09 08:33:12 +02:00
* Bootstrap (v5.1.3): util/index.js
2021-08-04 17:41:51 +02:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
* --------------------------------------------------------------------------
*/
2021-03-23 17:26:54 +01:00
const toType = obj => {
2020-03-28 11:29:08 +01:00
if (obj === null || obj === undefined) {
2021-03-23 17:26:54 +01:00
return `${obj}`;
2020-03-28 11:29:08 +01:00
}
2019-03-01 17:31:34 +01:00
return {}.toString.call(obj).match(/\s([a-z]+)/i)[1].toLowerCase();
};
2021-08-04 17:41:51 +02:00
const getSelector = element => {
let selector = element.getAttribute('data-bs-target');
if (!selector || selector === '#') {
let hrefAttr = element.getAttribute('href'); // The only valid content that could double as a selector are IDs or classes,
// so everything starting with `#` or `.`. If a "real" URL is used as the selector,
// `document.querySelector` will rightfully complain it is invalid.
// See https://github.com/twbs/bootstrap/issues/32273
if (!hrefAttr || !hrefAttr.includes('#') && !hrefAttr.startsWith('.')) {
return null;
} // Just in case some CMS puts out a full URL with the anchor appended
if (hrefAttr.includes('#') && !hrefAttr.startsWith('#')) {
hrefAttr = `#${hrefAttr.split('#')[1]}`;
}
selector = hrefAttr && hrefAttr !== '#' ? hrefAttr.trim() : null;
}
return selector;
};
const getElementFromSelector = element => {
const selector = getSelector(element);
return selector ? document.querySelector(selector) : null;
};
const isElement = obj => {
if (!obj || typeof obj !== 'object') {
return false;
}
2019-03-01 17:31:34 +01:00
if (typeof obj.jquery !== 'undefined') {
obj = obj[0];
2019-03-01 17:31:34 +01:00
}
return typeof obj.nodeType !== 'undefined';
2019-03-01 17:31:34 +01:00
};
2021-03-23 17:26:54 +01:00
const typeCheckConfig = (componentName, config, configTypes) => {
Object.keys(configTypes).forEach(property => {
const expectedTypes = configTypes[property];
const value = config[property];
const valueType = value && isElement(value) ? 'element' : toType(value);
2019-03-01 17:31:34 +01:00
if (!new RegExp(expectedTypes).test(valueType)) {
throw new TypeError(`${componentName.toUpperCase()}: Option "${property}" provided type "${valueType}" but expected type "${expectedTypes}".`);
2019-03-01 17:31:34 +01:00
}
});
};
2021-08-04 17:41:51 +02:00
const isDisabled = element => {
if (!element || element.nodeType !== Node.ELEMENT_NODE) {
return true;
}
if (element.classList.contains('disabled')) {
return true;
}
if (typeof element.disabled !== 'undefined') {
return element.disabled;
}
return element.hasAttribute('disabled') && element.getAttribute('disabled') !== 'false';
};
/**
* Trick to restart an element's animation
*
* @param {HTMLElement} element
* @return void
*
* @see https://www.charistheo.io/blog/2021/02/restart-a-css-animation-with-javascript/#restarting-a-css-animation
*/
const reflow = element => {
// eslint-disable-next-line no-unused-expressions
element.offsetHeight;
};
2021-03-23 17:26:54 +01:00
const getjQuery = () => {
const {
jQuery
} = window;
2019-08-27 15:03:21 +02:00
2020-11-23 14:17:16 +01:00
if (jQuery && !document.body.hasAttribute('data-bs-no-jquery')) {
2019-08-27 15:03:21 +02:00
return jQuery;
}
return null;
};
const DOMContentLoadedCallbacks = [];
2021-03-23 17:26:54 +01:00
const onDOMContentLoaded = callback => {
2020-11-11 18:07:37 +01:00
if (document.readyState === 'loading') {
// add listener on the first call when the document is in loading state
if (!DOMContentLoadedCallbacks.length) {
document.addEventListener('DOMContentLoaded', () => {
DOMContentLoadedCallbacks.forEach(callback => callback());
});
}
DOMContentLoadedCallbacks.push(callback);
2020-11-11 18:07:37 +01:00
} else {
callback();
}
};
const defineJQueryPlugin = plugin => {
2021-03-23 17:26:54 +01:00
onDOMContentLoaded(() => {
const $ = getjQuery();
/* istanbul ignore if */
2020-12-03 15:18:59 +01:00
if ($) {
const name = plugin.NAME;
2021-03-23 17:26:54 +01:00
const JQUERY_NO_CONFLICT = $.fn[name];
$.fn[name] = plugin.jQueryInterface;
$.fn[name].Constructor = plugin;
2020-12-03 15:18:59 +01:00
2021-03-23 17:26:54 +01:00
$.fn[name].noConflict = () => {
$.fn[name] = JQUERY_NO_CONFLICT;
return plugin.jQueryInterface;
};
2020-12-03 15:18:59 +01:00
}
});
};
2020-12-03 15:18:59 +01:00
2021-03-23 17:26:54 +01:00
/**
* --------------------------------------------------------------------------
2021-10-09 08:33:12 +02:00
* Bootstrap (v5.1.3): util/component-functions.js
2021-08-04 17:41:51 +02:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
* --------------------------------------------------------------------------
*/
const enableDismissTrigger = (component, method = 'hide') => {
const clickEvent = `click.dismiss${component.EVENT_KEY}`;
const name = component.NAME;
2021-10-05 17:50:18 +02:00
EventHandler__default.default.on(document, clickEvent, `[data-bs-dismiss="${name}"]`, function (event) {
2021-08-04 17:41:51 +02:00
if (['A', 'AREA'].includes(this.tagName)) {
event.preventDefault();
}
if (isDisabled(this)) {
return;
}
const target = getElementFromSelector(this) || this.closest(`.${name}`);
const instance = component.getOrCreateInstance(target); // Method argument is left, for Alert and only, as it doesn't implement the 'hide' method
instance[method]();
});
};
/**
* --------------------------------------------------------------------------
2021-10-09 08:33:12 +02:00
* Bootstrap (v5.1.3): toast.js
2021-03-23 17:26:54 +01:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
* --------------------------------------------------------------------------
*/
2020-12-03 15:18:59 +01:00
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
2021-03-23 17:26:54 +01:00
const NAME = 'toast';
const DATA_KEY = 'bs.toast';
const EVENT_KEY = `.${DATA_KEY}`;
const EVENT_MOUSEOVER = `mouseover${EVENT_KEY}`;
const EVENT_MOUSEOUT = `mouseout${EVENT_KEY}`;
const EVENT_FOCUSIN = `focusin${EVENT_KEY}`;
const EVENT_FOCUSOUT = `focusout${EVENT_KEY}`;
2021-03-23 17:26:54 +01:00
const EVENT_HIDE = `hide${EVENT_KEY}`;
const EVENT_HIDDEN = `hidden${EVENT_KEY}`;
const EVENT_SHOW = `show${EVENT_KEY}`;
const EVENT_SHOWN = `shown${EVENT_KEY}`;
const CLASS_NAME_FADE = 'fade';
2021-08-04 17:41:51 +02:00
const CLASS_NAME_HIDE = 'hide'; // @deprecated - kept here only for backwards compatibility
2021-03-23 17:26:54 +01:00
const CLASS_NAME_SHOW = 'show';
const CLASS_NAME_SHOWING = 'showing';
const DefaultType = {
2018-11-24 17:22:59 +01:00
animation: 'boolean',
autohide: 'boolean',
delay: 'number'
};
2021-03-23 17:26:54 +01:00
const Default = {
2018-11-24 17:22:59 +01:00
animation: true,
autohide: true,
2020-09-14 17:12:06 +02:00
delay: 5000
2018-11-24 17:22:59 +01:00
};
2019-10-08 08:39:10 +02:00
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
2018-11-13 07:41:12 +01:00
2021-10-05 17:50:18 +02:00
class Toast extends BaseComponent__default.default {
2021-03-23 17:26:54 +01:00
constructor(element, config) {
super(element);
this._config = this._getConfig(config);
this._timeout = null;
this._hasMouseInteraction = false;
this._hasKeyboardInteraction = false;
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
this._setListeners();
} // Getters
2019-03-01 17:31:34 +01:00
2020-12-03 15:18:59 +01:00
2021-03-23 17:26:54 +01:00
static get DefaultType() {
return DefaultType;
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
static get Default() {
return Default;
}
2018-11-13 07:41:12 +01:00
static get NAME() {
return NAME;
2021-03-23 17:26:54 +01:00
} // Public
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
show() {
2021-10-05 17:50:18 +02:00
const showEvent = EventHandler__default.default.trigger(this._element, EVENT_SHOW);
2019-07-12 23:56:26 +02:00
if (showEvent.defaultPrevented) {
return;
}
2018-11-13 07:41:12 +01:00
2020-09-14 17:12:06 +02:00
this._clearTimeout();
2018-11-24 17:22:59 +01:00
if (this._config.animation) {
2020-03-28 11:29:08 +01:00
this._element.classList.add(CLASS_NAME_FADE);
2018-11-24 17:22:59 +01:00
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
const complete = () => {
this._element.classList.remove(CLASS_NAME_SHOWING);
2018-12-16 00:13:22 +01:00
2021-10-05 17:50:18 +02:00
EventHandler__default.default.trigger(this._element, EVENT_SHOWN);
2018-11-13 07:41:12 +01:00
this._maybeScheduleHide();
2018-11-13 07:41:12 +01:00
};
2021-08-04 17:41:51 +02:00
this._element.classList.remove(CLASS_NAME_HIDE); // @deprecated
2018-12-16 00:13:22 +01:00
reflow(this._element);
2021-08-04 17:41:51 +02:00
this._element.classList.add(CLASS_NAME_SHOW);
2020-03-28 11:29:08 +01:00
this._element.classList.add(CLASS_NAME_SHOWING);
2018-11-13 07:41:12 +01:00
this._queueCallback(complete, this._element, this._config.animation);
2021-03-23 17:26:54 +01:00
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
hide() {
2020-03-28 11:29:08 +01:00
if (!this._element.classList.contains(CLASS_NAME_SHOW)) {
2018-11-24 17:22:59 +01:00
return;
}
2018-11-13 07:41:12 +01:00
2021-10-05 17:50:18 +02:00
const hideEvent = EventHandler__default.default.trigger(this._element, EVENT_HIDE);
2019-07-12 23:56:26 +02:00
if (hideEvent.defaultPrevented) {
return;
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
const complete = () => {
2021-08-04 17:41:51 +02:00
this._element.classList.add(CLASS_NAME_HIDE); // @deprecated
this._element.classList.remove(CLASS_NAME_SHOWING);
this._element.classList.remove(CLASS_NAME_SHOW);
2019-04-18 13:47:52 +02:00
2021-10-05 17:50:18 +02:00
EventHandler__default.default.trigger(this._element, EVENT_HIDDEN);
2019-04-18 13:47:52 +02:00
};
2021-08-04 17:41:51 +02:00
this._element.classList.add(CLASS_NAME_SHOWING);
2019-04-18 13:47:52 +02:00
this._queueCallback(complete, this._element, this._config.animation);
2021-03-23 17:26:54 +01:00
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
dispose() {
2020-09-14 17:12:06 +02:00
this._clearTimeout();
2018-11-13 07:41:12 +01:00
2020-03-28 11:29:08 +01:00
if (this._element.classList.contains(CLASS_NAME_SHOW)) {
this._element.classList.remove(CLASS_NAME_SHOW);
2018-11-24 17:22:59 +01:00
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
super.dispose();
2019-01-04 17:29:45 +01:00
} // Private
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
_getConfig(config) {
config = { ...Default,
2021-10-05 17:50:18 +02:00
...Manipulator__default.default.getDataAttributes(this._element),
2021-03-23 17:26:54 +01:00
...(typeof config === 'object' && config ? config : {})
};
2019-03-01 17:31:34 +01:00
typeCheckConfig(NAME, config, this.constructor.DefaultType);
2018-11-24 17:22:59 +01:00
return config;
2021-03-23 17:26:54 +01:00
}
2018-11-13 07:41:12 +01:00
_maybeScheduleHide() {
if (!this._config.autohide) {
return;
}
if (this._hasMouseInteraction || this._hasKeyboardInteraction) {
return;
}
this._timeout = setTimeout(() => {
this.hide();
}, this._config.delay);
}
_onInteraction(event, isInteracting) {
switch (event.type) {
case 'mouseover':
case 'mouseout':
this._hasMouseInteraction = isInteracting;
break;
case 'focusin':
case 'focusout':
this._hasKeyboardInteraction = isInteracting;
break;
}
if (isInteracting) {
this._clearTimeout();
return;
}
const nextElement = event.relatedTarget;
if (this._element === nextElement || this._element.contains(nextElement)) {
return;
}
this._maybeScheduleHide();
}
2021-03-23 17:26:54 +01:00
_setListeners() {
2021-10-05 17:50:18 +02:00
EventHandler__default.default.on(this._element, EVENT_MOUSEOVER, event => this._onInteraction(event, true));
EventHandler__default.default.on(this._element, EVENT_MOUSEOUT, event => this._onInteraction(event, false));
EventHandler__default.default.on(this._element, EVENT_FOCUSIN, event => this._onInteraction(event, true));
EventHandler__default.default.on(this._element, EVENT_FOCUSOUT, event => this._onInteraction(event, false));
2021-03-23 17:26:54 +01:00
}
2020-09-14 17:12:06 +02:00
2021-03-23 17:26:54 +01:00
_clearTimeout() {
2020-09-14 17:12:06 +02:00
clearTimeout(this._timeout);
this._timeout = null;
2019-01-04 17:29:45 +01:00
} // Static
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
static jQueryInterface(config) {
2018-11-24 17:22:59 +01:00
return this.each(function () {
const data = Toast.getOrCreateInstance(this, config);
2018-11-13 07:41:12 +01:00
2018-11-24 17:22:59 +01:00
if (typeof config === 'string') {
if (typeof data[config] === 'undefined') {
2021-03-23 17:26:54 +01:00
throw new TypeError(`No method named "${config}"`);
2018-11-13 07:41:12 +01:00
}
2018-11-24 17:22:59 +01:00
data[config](this);
2018-11-13 07:41:12 +01:00
}
2018-11-24 17:22:59 +01:00
});
2021-03-23 17:26:54 +01:00
}
2018-11-13 07:41:12 +01:00
2021-03-23 17:26:54 +01:00
}
2021-08-04 17:41:51 +02:00
enableDismissTrigger(Toast);
2018-11-24 17:22:59 +01:00
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
2020-11-11 18:07:37 +01:00
* add .Toast to jQuery only if jQuery is present
2018-11-24 17:22:59 +01:00
*/
2018-11-13 07:41:12 +01:00
defineJQueryPlugin(Toast);
2018-11-13 07:41:12 +01:00
return Toast;
2021-10-05 17:50:18 +02:00
}));
2018-11-13 07:41:12 +01:00
//# sourceMappingURL=toast.js.map