1
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2022-11-09 12:25:43 -05:00
twbs--bootstrap/js/dist/tooltip.js

636 lines
18 KiB
JavaScript
Raw Normal View History

2016-10-09 20:26:51 -04:00
var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; };
2015-11-11 01:59:59 -05:00
2016-10-09 20:26:51 -04:00
var _createClass = function () { function defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } return function (Constructor, protoProps, staticProps) { if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; }; }();
2016-10-09 20:26:51 -04:00
function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
/**
* --------------------------------------------------------------------------
2017-01-06 11:38:04 -05:00
* Bootstrap (v4.0.0-alpha.6): tooltip.js
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
2016-10-09 20:26:51 -04:00
var Tooltip = function ($) {
/**
* Check for Tether dependency
2016-10-09 15:39:56 -04:00
* Tether - http://tether.io/
*/
if (typeof Tether === 'undefined') {
2016-10-09 15:39:56 -04:00
throw new Error('Bootstrap tooltips require Tether (http://tether.io/)');
}
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
var NAME = 'tooltip';
2017-01-06 11:38:04 -05:00
var VERSION = '4.0.0-alpha.6';
var DATA_KEY = 'bs.tooltip';
2015-05-13 15:48:34 -04:00
var EVENT_KEY = '.' + DATA_KEY;
var JQUERY_NO_CONFLICT = $.fn[NAME];
var TRANSITION_DURATION = 150;
var CLASS_PREFIX = 'bs-tether';
2017-03-28 12:31:32 -04:00
var TETHER_PREFIX_REGEX = new RegExp('(^|\\s)' + CLASS_PREFIX + '\\S+', 'g');
var Default = {
animation: true,
2016-10-09 23:26:49 -04:00
template: '<div class="tooltip" role="tooltip">' + '<div class="tooltip-inner"></div></div>',
trigger: 'hover focus',
title: '',
delay: 0,
html: false,
selector: false,
2015-05-12 17:28:11 -04:00
placement: 'top',
offset: '0 0',
2016-11-26 22:17:23 -05:00
constraints: [],
container: false
2015-05-13 17:46:50 -04:00
};
var DefaultType = {
animation: 'boolean',
template: 'string',
2015-08-29 17:03:55 -04:00
title: '(string|element|function)',
2015-05-13 17:46:50 -04:00
trigger: 'string',
delay: '(number|object)',
html: 'boolean',
selector: '(string|boolean)',
placement: '(string|function)',
offset: 'string',
2016-11-26 22:17:23 -05:00
constraints: 'array',
container: '(string|element|boolean)'
};
2015-05-12 17:28:11 -04:00
var AttachmentMap = {
TOP: 'bottom center',
RIGHT: 'middle left',
BOTTOM: 'top center',
LEFT: 'middle right'
};
var HoverState = {
2016-12-20 00:48:24 -05:00
SHOW: 'show',
OUT: 'out'
};
var Event = {
2015-05-13 15:48:34 -04:00
HIDE: 'hide' + EVENT_KEY,
HIDDEN: 'hidden' + EVENT_KEY,
SHOW: 'show' + EVENT_KEY,
SHOWN: 'shown' + EVENT_KEY,
INSERTED: 'inserted' + EVENT_KEY,
CLICK: 'click' + EVENT_KEY,
FOCUSIN: 'focusin' + EVENT_KEY,
FOCUSOUT: 'focusout' + EVENT_KEY,
MOUSEENTER: 'mouseenter' + EVENT_KEY,
MOUSELEAVE: 'mouseleave' + EVENT_KEY
};
var ClassName = {
FADE: 'fade',
2016-12-20 00:48:24 -05:00
SHOW: 'show'
};
var Selector = {
TOOLTIP: '.tooltip',
TOOLTIP_INNER: '.tooltip-inner'
};
var TetherClass = {
2015-05-12 17:28:11 -04:00
element: false,
enabled: false
};
var Trigger = {
HOVER: 'hover',
FOCUS: 'focus',
CLICK: 'click',
MANUAL: 'manual'
};
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
2016-10-09 20:26:51 -04:00
var Tooltip = function () {
function Tooltip(element, config) {
_classCallCheck(this, Tooltip);
// private
this._isEnabled = true;
this._timeout = 0;
this._hoverState = '';
this._activeTrigger = {};
2015-05-12 17:28:11 -04:00
this._tether = null;
// protected
this.element = element;
this.config = this._getConfig(config);
this.tip = null;
this._setListeners();
}
2015-08-13 00:12:03 -04:00
// getters
2016-10-09 20:26:51 -04:00
// public
2016-10-09 20:26:51 -04:00
Tooltip.prototype.enable = function enable() {
this._isEnabled = true;
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.disable = function disable() {
this._isEnabled = false;
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.toggleEnabled = function toggleEnabled() {
this._isEnabled = !this._isEnabled;
};
2015-08-18 23:28:28 -04:00
2016-10-09 20:26:51 -04:00
Tooltip.prototype.toggle = function toggle(event) {
if (event) {
var dataKey = this.constructor.DATA_KEY;
var context = $(event.currentTarget).data(dataKey);
2015-08-18 23:28:28 -04:00
2016-10-09 20:26:51 -04:00
if (!context) {
context = new this.constructor(event.currentTarget, this._getDelegateConfig());
$(event.currentTarget).data(dataKey, context);
}
2015-05-12 17:28:11 -04:00
2016-10-09 20:26:51 -04:00
context._activeTrigger.click = !context._activeTrigger.click;
2015-05-12 17:28:11 -04:00
2016-10-09 20:26:51 -04:00
if (context._isWithActiveTrigger()) {
context._enter(null, context);
} else {
context._leave(null, context);
2015-05-13 15:48:34 -04:00
}
2016-10-09 20:26:51 -04:00
} else {
2015-05-13 15:48:34 -04:00
2016-12-20 00:48:24 -05:00
if ($(this.getTipElement()).hasClass(ClassName.SHOW)) {
2016-10-09 20:26:51 -04:00
this._leave(null, this);
return;
}
2015-05-13 15:48:34 -04:00
2016-10-09 20:26:51 -04:00
this._enter(null, this);
}
2016-10-09 20:26:51 -04:00
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.dispose = function dispose() {
clearTimeout(this._timeout);
2016-10-09 20:26:51 -04:00
this.cleanupTether();
2016-10-09 20:26:51 -04:00
$.removeData(this.element, this.constructor.DATA_KEY);
2016-10-09 20:26:51 -04:00
$(this.element).off(this.constructor.EVENT_KEY);
2016-11-30 00:37:00 -05:00
$(this.element).closest('.modal').off('hide.bs.modal');
2016-10-09 20:26:51 -04:00
if (this.tip) {
$(this.tip).remove();
}
2016-10-09 20:26:51 -04:00
this._isEnabled = null;
this._timeout = null;
this._hoverState = null;
this._activeTrigger = null;
this._tether = null;
2016-10-09 20:26:51 -04:00
this.element = null;
this.config = null;
this.tip = null;
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.show = function show() {
var _this = this;
2016-11-01 00:14:23 -04:00
if ($(this.element).css('display') === 'none') {
throw new Error('Please use show on visible elements');
}
2016-12-02 13:13:36 -05:00
var showEvent = $.Event(this.constructor.Event.SHOW);
2016-10-09 20:26:51 -04:00
if (this.isWithContent() && this._isEnabled) {
$(this.element).trigger(showEvent);
2016-10-09 20:26:51 -04:00
var isInTheDom = $.contains(this.element.ownerDocument.documentElement, this.element);
2016-10-09 20:26:51 -04:00
if (showEvent.isDefaultPrevented() || !isInTheDom) {
return;
}
2016-10-09 20:26:51 -04:00
var tip = this.getTipElement();
var tipId = Util.getUID(this.constructor.NAME);
2016-10-09 20:26:51 -04:00
tip.setAttribute('id', tipId);
this.element.setAttribute('aria-describedby', tipId);
2016-10-09 20:26:51 -04:00
this.setContent();
2016-10-09 20:26:51 -04:00
if (this.config.animation) {
$(tip).addClass(ClassName.FADE);
}
2016-10-09 20:26:51 -04:00
var placement = typeof this.config.placement === 'function' ? this.config.placement.call(this, tip, this.element) : this.config.placement;
2016-10-09 20:26:51 -04:00
var attachment = this._getAttachment(placement);
2016-11-26 22:17:23 -05:00
var container = this.config.container === false ? document.body : $(this.config.container);
2017-04-01 22:18:29 -04:00
$(tip).data(this.constructor.DATA_KEY, this);
if (!$.contains(this.element.ownerDocument.documentElement, this.tip)) {
$(tip).appendTo(container);
}
2015-08-18 23:28:28 -04:00
2016-10-09 20:26:51 -04:00
$(this.element).trigger(this.constructor.Event.INSERTED);
this._tether = new Tether({
attachment: attachment,
element: tip,
target: this.element,
classes: TetherClass,
classPrefix: CLASS_PREFIX,
offset: this.config.offset,
constraints: this.config.constraints,
addTargetClasses: false
});
Util.reflow(tip);
this._tether.position();
2016-12-20 00:48:24 -05:00
$(tip).addClass(ClassName.SHOW);
var complete = function complete() {
2016-10-09 20:26:51 -04:00
var prevHoverState = _this._hoverState;
_this._hoverState = null;
2016-10-09 20:26:51 -04:00
$(_this.element).trigger(_this.constructor.Event.SHOWN);
2016-10-09 20:26:51 -04:00
if (prevHoverState === HoverState.OUT) {
_this._leave(null, _this);
}
};
2016-10-09 20:26:51 -04:00
if (Util.supportsTransitionEnd() && $(this.tip).hasClass(ClassName.FADE)) {
$(this.tip).one(Util.TRANSITION_END, complete).emulateTransitionEnd(Tooltip._TRANSITION_DURATION);
return;
}
2016-10-09 20:26:51 -04:00
complete();
}
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.hide = function hide(callback) {
var _this2 = this;
2016-10-09 20:26:51 -04:00
var tip = this.getTipElement();
var hideEvent = $.Event(this.constructor.Event.HIDE);
var complete = function complete() {
2016-12-20 00:48:24 -05:00
if (_this2._hoverState !== HoverState.SHOW && tip.parentNode) {
2016-10-09 20:26:51 -04:00
tip.parentNode.removeChild(tip);
}
2017-03-28 12:31:32 -04:00
_this2._cleanTipClass();
2016-10-09 20:26:51 -04:00
_this2.element.removeAttribute('aria-describedby');
$(_this2.element).trigger(_this2.constructor.Event.HIDDEN);
_this2.cleanupTether();
2016-10-09 20:26:51 -04:00
if (callback) {
callback();
}
};
2016-10-09 20:26:51 -04:00
$(this.element).trigger(hideEvent);
if (hideEvent.isDefaultPrevented()) {
return;
}
2016-12-20 00:48:24 -05:00
$(tip).removeClass(ClassName.SHOW);
2016-12-27 17:27:41 -05:00
this._activeTrigger[Trigger.CLICK] = false;
this._activeTrigger[Trigger.FOCUS] = false;
this._activeTrigger[Trigger.HOVER] = false;
2016-10-09 20:26:51 -04:00
if (Util.supportsTransitionEnd() && $(this.tip).hasClass(ClassName.FADE)) {
2017-04-01 22:18:29 -04:00
2016-10-09 20:26:51 -04:00
$(tip).one(Util.TRANSITION_END, complete).emulateTransitionEnd(TRANSITION_DURATION);
} else {
complete();
}
2016-10-09 20:26:51 -04:00
this._hoverState = '';
};
// protected
Tooltip.prototype.isWithContent = function isWithContent() {
return Boolean(this.getTitle());
};
Tooltip.prototype.getTipElement = function getTipElement() {
return this.tip = this.tip || $(this.config.template)[0];
};
Tooltip.prototype.setContent = function setContent() {
var $tip = $(this.getTipElement());
this.setElementContent($tip.find(Selector.TOOLTIP_INNER), this.getTitle());
2016-12-20 00:48:24 -05:00
$tip.removeClass(ClassName.FADE + ' ' + ClassName.SHOW);
2016-10-09 20:26:51 -04:00
this.cleanupTether();
};
Tooltip.prototype.setElementContent = function setElementContent($element, content) {
var html = this.config.html;
if ((typeof content === 'undefined' ? 'undefined' : _typeof(content)) === 'object' && (content.nodeType || content.jquery)) {
// content is a DOM node or a jQuery
if (html) {
if (!$(content).parent().is($element)) {
$element.empty().append(content);
2015-08-29 17:03:55 -04:00
}
} else {
2016-10-09 20:26:51 -04:00
$element.text($(content).text());
2015-08-29 17:03:55 -04:00
}
2016-10-09 20:26:51 -04:00
} else {
$element[html ? 'html' : 'text'](content);
2015-08-29 17:03:55 -04:00
}
2016-10-09 20:26:51 -04:00
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.getTitle = function getTitle() {
var title = this.element.getAttribute('data-original-title');
2016-10-09 20:26:51 -04:00
if (!title) {
title = typeof this.config.title === 'function' ? this.config.title.call(this.element) : this.config.title;
}
2016-10-09 20:26:51 -04:00
return title;
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype.cleanupTether = function cleanupTether() {
if (this._tether) {
this._tether.destroy();
2015-05-12 17:28:11 -04:00
}
2016-10-09 20:26:51 -04:00
};
2016-10-09 20:26:51 -04:00
// private
2016-10-09 20:26:51 -04:00
Tooltip.prototype._getAttachment = function _getAttachment(placement) {
return AttachmentMap[placement.toUpperCase()];
};
2017-03-28 12:31:32 -04:00
Tooltip.prototype._cleanTipClass = function _cleanTipClass() {
var $tip = $(this.getTipElement());
var tabClass = $tip.attr('class').match(TETHER_PREFIX_REGEX);
if (tabClass !== null && tabClass.length > 0) {
$tip.removeClass(tabClass.join(''));
}
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype._setListeners = function _setListeners() {
var _this3 = this;
2016-10-09 20:26:51 -04:00
var triggers = this.config.trigger.split(' ');
triggers.forEach(function (trigger) {
if (trigger === 'click') {
2016-11-01 00:14:23 -04:00
$(_this3.element).on(_this3.constructor.Event.CLICK, _this3.config.selector, function (event) {
return _this3.toggle(event);
});
2016-10-09 20:26:51 -04:00
} else if (trigger !== Trigger.MANUAL) {
var eventIn = trigger === Trigger.HOVER ? _this3.constructor.Event.MOUSEENTER : _this3.constructor.Event.FOCUSIN;
var eventOut = trigger === Trigger.HOVER ? _this3.constructor.Event.MOUSELEAVE : _this3.constructor.Event.FOCUSOUT;
2016-11-01 00:14:23 -04:00
$(_this3.element).on(eventIn, _this3.config.selector, function (event) {
return _this3._enter(event);
}).on(eventOut, _this3.config.selector, function (event) {
return _this3._leave(event);
});
}
2016-11-30 00:37:00 -05:00
$(_this3.element).closest('.modal').on('hide.bs.modal', function () {
return _this3.hide();
});
2016-10-09 20:26:51 -04:00
});
if (this.config.selector) {
this.config = $.extend({}, this.config, {
trigger: 'manual',
selector: ''
});
} else {
this._fixTitle();
}
2016-10-09 20:26:51 -04:00
};
2015-05-12 17:28:11 -04:00
2016-10-09 20:26:51 -04:00
Tooltip.prototype._fixTitle = function _fixTitle() {
var titleType = _typeof(this.element.getAttribute('data-original-title'));
if (this.element.getAttribute('title') || titleType !== 'string') {
this.element.setAttribute('data-original-title', this.element.getAttribute('title') || '');
this.element.setAttribute('title', '');
}
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype._enter = function _enter(event, context) {
var dataKey = this.constructor.DATA_KEY;
2016-10-09 20:26:51 -04:00
context = context || $(event.currentTarget).data(dataKey);
2016-10-09 20:26:51 -04:00
if (!context) {
context = new this.constructor(event.currentTarget, this._getDelegateConfig());
$(event.currentTarget).data(dataKey, context);
}
2016-10-09 20:26:51 -04:00
if (event) {
context._activeTrigger[event.type === 'focusin' ? Trigger.FOCUS : Trigger.HOVER] = true;
}
2016-12-20 00:48:24 -05:00
if ($(context.getTipElement()).hasClass(ClassName.SHOW) || context._hoverState === HoverState.SHOW) {
context._hoverState = HoverState.SHOW;
2016-10-09 20:26:51 -04:00
return;
}
clearTimeout(context._timeout);
2016-12-20 00:48:24 -05:00
context._hoverState = HoverState.SHOW;
2016-10-09 20:26:51 -04:00
if (!context.config.delay || !context.config.delay.show) {
context.show();
return;
}
context._timeout = setTimeout(function () {
2016-12-20 00:48:24 -05:00
if (context._hoverState === HoverState.SHOW) {
context.show();
}
2016-10-09 20:26:51 -04:00
}, context.config.delay.show);
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype._leave = function _leave(event, context) {
var dataKey = this.constructor.DATA_KEY;
2015-05-12 17:28:11 -04:00
2016-10-09 20:26:51 -04:00
context = context || $(event.currentTarget).data(dataKey);
2016-10-09 20:26:51 -04:00
if (!context) {
context = new this.constructor(event.currentTarget, this._getDelegateConfig());
$(event.currentTarget).data(dataKey, context);
}
2016-10-09 20:26:51 -04:00
if (event) {
context._activeTrigger[event.type === 'focusout' ? Trigger.FOCUS : Trigger.HOVER] = false;
}
2016-10-09 20:26:51 -04:00
if (context._isWithActiveTrigger()) {
return;
}
clearTimeout(context._timeout);
2016-10-09 20:26:51 -04:00
context._hoverState = HoverState.OUT;
2016-10-09 20:26:51 -04:00
if (!context.config.delay || !context.config.delay.hide) {
context.hide();
return;
}
2016-10-09 20:26:51 -04:00
context._timeout = setTimeout(function () {
if (context._hoverState === HoverState.OUT) {
context.hide();
}
2016-10-09 20:26:51 -04:00
}, context.config.delay.hide);
};
2016-10-09 20:26:51 -04:00
Tooltip.prototype._isWithActiveTrigger = function _isWithActiveTrigger() {
for (var trigger in this._activeTrigger) {
if (this._activeTrigger[trigger]) {
return true;
}
}
2016-10-09 20:26:51 -04:00
return false;
};
Tooltip.prototype._getConfig = function _getConfig(config) {
config = $.extend({}, this.constructor.Default, $(this.element).data(), config);
2015-05-13 17:46:50 -04:00
2016-10-09 20:26:51 -04:00
if (config.delay && typeof config.delay === 'number') {
config.delay = {
show: config.delay,
hide: config.delay
};
}
2016-10-09 20:26:51 -04:00
2017-04-01 22:18:29 -04:00
if (config.title && typeof config.title === 'number') {
config.title = config.title.toString();
}
if (config.content && typeof config.content === 'number') {
config.content = config.content.toString();
}
2016-10-09 20:26:51 -04:00
Util.typeCheckConfig(NAME, config, this.constructor.DefaultType);
return config;
};
Tooltip.prototype._getDelegateConfig = function _getDelegateConfig() {
var config = {};
if (this.config) {
for (var key in this.config) {
if (this.constructor.Default[key] !== this.config[key]) {
config[key] = this.config[key];
}
}
}
2015-08-13 00:12:03 -04:00
2016-10-09 20:26:51 -04:00
return config;
};
2015-08-13 00:12:03 -04:00
2016-10-09 20:26:51 -04:00
// static
2015-08-13 00:12:03 -04:00
2016-10-09 20:26:51 -04:00
Tooltip._jQueryInterface = function _jQueryInterface(config) {
return this.each(function () {
var data = $(this).data(DATA_KEY);
2016-11-25 18:00:23 -05:00
var _config = (typeof config === 'undefined' ? 'undefined' : _typeof(config)) === 'object' && config;
2016-10-16 22:44:11 -04:00
if (!data && /dispose|hide/.test(config)) {
2016-10-09 20:26:51 -04:00
return;
}
2016-10-09 20:26:51 -04:00
if (!data) {
data = new Tooltip(this, _config);
$(this).data(DATA_KEY, data);
}
if (typeof config === 'string') {
if (data[config] === undefined) {
throw new Error('No method named "' + config + '"');
2015-08-13 00:12:03 -04:00
}
2016-10-09 20:26:51 -04:00
data[config]();
}
});
};
_createClass(Tooltip, null, [{
2015-08-13 00:12:03 -04:00
key: 'VERSION',
get: function get() {
return VERSION;
}
}, {
key: 'Default',
2015-08-13 00:12:03 -04:00
get: function get() {
return Default;
}
2015-05-12 17:28:11 -04:00
}, {
key: 'NAME',
2015-08-13 00:12:03 -04:00
get: function get() {
2015-05-12 17:28:11 -04:00
return NAME;
}
}, {
key: 'DATA_KEY',
2015-08-13 00:12:03 -04:00
get: function get() {
2015-05-12 17:28:11 -04:00
return DATA_KEY;
}
}, {
key: 'Event',
2015-08-13 00:12:03 -04:00
get: function get() {
2015-05-12 17:28:11 -04:00
return Event;
}
2015-05-13 15:48:34 -04:00
}, {
key: 'EVENT_KEY',
2015-08-13 00:12:03 -04:00
get: function get() {
2015-05-13 15:48:34 -04:00
return EVENT_KEY;
}
2015-05-13 17:46:50 -04:00
}, {
key: 'DefaultType',
2015-08-13 00:12:03 -04:00
get: function get() {
2015-05-13 17:46:50 -04:00
return DefaultType;
}
}]);
return Tooltip;
2016-10-09 20:26:51 -04:00
}();
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
$.fn[NAME] = Tooltip._jQueryInterface;
$.fn[NAME].Constructor = Tooltip;
$.fn[NAME].noConflict = function () {
$.fn[NAME] = JQUERY_NO_CONFLICT;
return Tooltip._jQueryInterface;
};
return Tooltip;
2016-10-09 20:26:51 -04:00
}(jQuery); /* global Tether */
2015-08-13 00:12:03 -04:00
//# sourceMappingURL=tooltip.js.map