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

620 lines
17 KiB
JavaScript
Raw Normal View History

2015-11-11 01:59:59 -05:00
/* global Tether */
'use strict';
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; }; })();
function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError('Cannot call a class as a function'); } }
/**
* --------------------------------------------------------------------------
2016-09-05 15:41:44 -04:00
* Bootstrap (v4.0.0-alpha.4): tooltip.js
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
2015-05-12 17:28:11 -04:00
var Tooltip = (function ($) {
/**
* Check for Tether dependency
2016-10-09 15:39:56 -04:00
* Tether - http://tether.io/
*/
2015-11-16 02:53:03 -05:00
if (window.Tether === undefined) {
2016-10-09 15:39:56 -04:00
throw new Error('Bootstrap tooltips require Tether (http://tether.io/)');
}
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
var NAME = 'tooltip';
2016-09-05 15:41:44 -04:00
var VERSION = '4.0.0-alpha.4';
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';
var Default = {
animation: true,
template: '<div class="tooltip" role="tooltip">' + '<div class="tooltip-arrow"></div>' + '<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',
2015-05-13 17:46:50 -04:00
constraints: []
};
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',
constraints: 'array'
};
2015-05-12 17:28:11 -04:00
var AttachmentMap = {
TOP: 'bottom center',
RIGHT: 'middle left',
BOTTOM: 'top center',
LEFT: 'middle right'
};
var HoverState = {
IN: 'in',
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',
IN: 'in'
};
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
* ------------------------------------------------------------------------
*/
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
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
// getters
_createClass(Tooltip, [{
key: 'enable',
// public
value: function enable() {
this._isEnabled = true;
}
}, {
key: 'disable',
value: function disable() {
this._isEnabled = false;
}
}, {
key: 'toggleEnabled',
value: function toggleEnabled() {
this._isEnabled = !this._isEnabled;
}
}, {
key: 'toggle',
value: function toggle(event) {
if (event) {
2015-08-18 23:28:28 -04:00
var dataKey = this.constructor.DATA_KEY;
var context = $(event.currentTarget).data(dataKey);
if (!context) {
context = new this.constructor(event.currentTarget, this._getDelegateConfig());
2015-05-12 17:28:11 -04:00
$(event.currentTarget).data(dataKey, context);
}
context._activeTrigger.click = !context._activeTrigger.click;
if (context._isWithActiveTrigger()) {
context._enter(null, context);
} else {
context._leave(null, context);
}
} else {
2015-08-18 23:28:28 -04:00
if ($(this.getTipElement()).hasClass(ClassName.IN)) {
this._leave(null, this);
return;
}
this._enter(null, this);
}
}
}, {
2015-05-13 15:48:34 -04:00
key: 'dispose',
value: function dispose() {
clearTimeout(this._timeout);
2015-05-12 17:28:11 -04:00
2015-05-13 15:48:34 -04:00
this.cleanupTether();
2015-05-12 17:28:11 -04:00
2015-05-13 15:48:34 -04:00
$.removeData(this.element, this.constructor.DATA_KEY);
$(this.element).off(this.constructor.EVENT_KEY);
if (this.tip) {
$(this.tip).remove();
}
this._isEnabled = null;
this._timeout = null;
this._hoverState = null;
this._activeTrigger = null;
this._tether = null;
this.element = null;
this.config = null;
this.tip = null;
}
}, {
key: 'show',
value: function show() {
2015-05-13 15:48:34 -04:00
var _this = this;
2015-05-12 17:28:11 -04:00
var showEvent = $.Event(this.constructor.Event.SHOW);
if (this.isWithContent() && this._isEnabled) {
$(this.element).trigger(showEvent);
var isInTheDom = $.contains(this.element.ownerDocument.documentElement, this.element);
if (showEvent.isDefaultPrevented() || !isInTheDom) {
return;
}
var tip = this.getTipElement();
2015-05-12 17:28:11 -04:00
var tipId = Util.getUID(this.constructor.NAME);
tip.setAttribute('id', tipId);
this.element.setAttribute('aria-describedby', tipId);
this.setContent();
if (this.config.animation) {
$(tip).addClass(ClassName.FADE);
}
2015-05-12 17:28:11 -04:00
var placement = typeof this.config.placement === 'function' ? this.config.placement.call(this, tip, this.element) : this.config.placement;
2015-05-12 17:28:11 -04:00
var attachment = this._getAttachment(placement);
2015-05-12 17:28:11 -04:00
$(tip).data(this.constructor.DATA_KEY, this).appendTo(document.body);
2015-05-12 17:28:11 -04:00
$(this.element).trigger(this.constructor.Event.INSERTED);
2015-05-12 17:28:11 -04:00
this._tether = new Tether({
2015-08-18 23:28:28 -04:00
attachment: attachment,
2015-05-12 17:28:11 -04:00
element: tip,
target: this.element,
classes: TetherClass,
classPrefix: CLASS_PREFIX,
offset: this.config.offset,
constraints: this.config.constraints,
addTargetClasses: false
});
Util.reflow(tip);
2015-05-12 17:28:11 -04:00
this._tether.position();
$(tip).addClass(ClassName.IN);
var complete = function complete() {
2015-05-13 15:48:34 -04:00
var prevHoverState = _this._hoverState;
_this._hoverState = null;
2015-05-13 15:48:34 -04:00
$(_this.element).trigger(_this.constructor.Event.SHOWN);
if (prevHoverState === HoverState.OUT) {
2015-05-13 15:48:34 -04:00
_this._leave(null, _this);
}
};
2015-08-18 23:28:28 -04:00
if (Util.supportsTransitionEnd() && $(this.tip).hasClass(ClassName.FADE)) {
$(this.tip).one(Util.TRANSITION_END, complete).emulateTransitionEnd(Tooltip._TRANSITION_DURATION);
return;
}
complete();
}
}
}, {
key: 'hide',
value: function hide(callback) {
2015-05-13 15:48:34 -04:00
var _this2 = this;
var tip = this.getTipElement();
2015-05-12 17:28:11 -04:00
var hideEvent = $.Event(this.constructor.Event.HIDE);
var complete = function complete() {
2015-05-13 15:48:34 -04:00
if (_this2._hoverState !== HoverState.IN && tip.parentNode) {
tip.parentNode.removeChild(tip);
}
2015-05-13 15:48:34 -04:00
_this2.element.removeAttribute('aria-describedby');
$(_this2.element).trigger(_this2.constructor.Event.HIDDEN);
_this2.cleanupTether();
if (callback) {
callback();
}
};
$(this.element).trigger(hideEvent);
if (hideEvent.isDefaultPrevented()) {
return;
}
$(tip).removeClass(ClassName.IN);
if (Util.supportsTransitionEnd() && $(this.tip).hasClass(ClassName.FADE)) {
$(tip).one(Util.TRANSITION_END, complete).emulateTransitionEnd(TRANSITION_DURATION);
} else {
complete();
}
this._hoverState = '';
}
// protected
2015-08-13 00:12:03 -04:00
}, {
key: 'isWithContent',
value: function isWithContent() {
2015-08-18 23:28:28 -04:00
return Boolean(this.getTitle());
}
}, {
key: 'getTipElement',
value: function getTipElement() {
return this.tip = this.tip || $(this.config.template)[0];
}
}, {
key: 'setContent',
value: function setContent() {
2015-08-29 17:03:55 -04:00
var $tip = $(this.getTipElement());
2015-08-29 17:03:55 -04:00
this.setElementContent($tip.find(Selector.TOOLTIP_INNER), this.getTitle());
2015-08-29 17:03:55 -04:00
$tip.removeClass(ClassName.FADE).removeClass(ClassName.IN);
this.cleanupTether();
}
2015-08-29 17:03:55 -04:00
}, {
key: 'setElementContent',
value: function setElementContent($element, content) {
var html = this.config.html;
if (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);
}
} else {
$element.text($(content).text());
}
} else {
$element[html ? 'html' : 'text'](content);
}
}
}, {
key: 'getTitle',
value: function getTitle() {
var title = this.element.getAttribute('data-original-title');
if (!title) {
title = typeof this.config.title === 'function' ? this.config.title.call(this.element) : this.config.title;
}
return title;
}
}, {
key: 'cleanupTether',
value: function cleanupTether() {
2015-05-12 17:28:11 -04:00
if (this._tether) {
this._tether.destroy();
}
}
// private
2015-08-13 00:12:03 -04:00
}, {
key: '_getAttachment',
2015-05-12 17:28:11 -04:00
value: function _getAttachment(placement) {
return AttachmentMap[placement.toUpperCase()];
}
}, {
key: '_setListeners',
value: function _setListeners() {
2015-05-13 15:48:34 -04:00
var _this3 = this;
var triggers = this.config.trigger.split(' ');
triggers.forEach(function (trigger) {
if (trigger === 'click') {
2015-05-13 15:48:34 -04:00
$(_this3.element).on(_this3.constructor.Event.CLICK, _this3.config.selector, $.proxy(_this3.toggle, _this3));
2015-05-12 17:28:11 -04:00
} else if (trigger !== Trigger.MANUAL) {
2015-08-18 23:28:28 -04:00
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;
2015-05-13 15:48:34 -04:00
$(_this3.element).on(eventIn, _this3.config.selector, $.proxy(_this3._enter, _this3)).on(eventOut, _this3.config.selector, $.proxy(_this3._leave, _this3));
}
});
if (this.config.selector) {
this.config = $.extend({}, this.config, {
trigger: 'manual',
selector: ''
});
} else {
this._fixTitle();
}
}
}, {
key: '_fixTitle',
value: 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', '');
}
}
}, {
key: '_enter',
value: function _enter(event, context) {
2015-05-12 17:28:11 -04:00
var dataKey = this.constructor.DATA_KEY;
context = context || $(event.currentTarget).data(dataKey);
if (!context) {
context = new this.constructor(event.currentTarget, this._getDelegateConfig());
2015-05-12 17:28:11 -04:00
$(event.currentTarget).data(dataKey, context);
}
if (event) {
2015-08-18 23:28:28 -04:00
context._activeTrigger[event.type === 'focusin' ? Trigger.FOCUS : Trigger.HOVER] = true;
}
2015-05-12 17:28:11 -04:00
if ($(context.getTipElement()).hasClass(ClassName.IN) || context._hoverState === HoverState.IN) {
context._hoverState = HoverState.IN;
return;
}
clearTimeout(context._timeout);
context._hoverState = HoverState.IN;
if (!context.config.delay || !context.config.delay.show) {
context.show();
return;
}
context._timeout = setTimeout(function () {
if (context._hoverState === HoverState.IN) {
context.show();
}
}, context.config.delay.show);
}
}, {
key: '_leave',
value: function _leave(event, context) {
2015-05-12 17:28:11 -04:00
var dataKey = this.constructor.DATA_KEY;
context = context || $(event.currentTarget).data(dataKey);
if (!context) {
context = new this.constructor(event.currentTarget, this._getDelegateConfig());
2015-05-12 17:28:11 -04:00
$(event.currentTarget).data(dataKey, context);
}
if (event) {
2015-08-18 23:28:28 -04:00
context._activeTrigger[event.type === 'focusout' ? Trigger.FOCUS : Trigger.HOVER] = false;
}
if (context._isWithActiveTrigger()) {
return;
}
clearTimeout(context._timeout);
context._hoverState = HoverState.OUT;
if (!context.config.delay || !context.config.delay.hide) {
context.hide();
return;
}
context._timeout = setTimeout(function () {
if (context._hoverState === HoverState.OUT) {
context.hide();
}
}, context.config.delay.hide);
}
}, {
key: '_isWithActiveTrigger',
value: function _isWithActiveTrigger() {
for (var trigger in this._activeTrigger) {
if (this._activeTrigger[trigger]) {
return true;
}
}
return false;
}
}, {
key: '_getConfig',
value: function _getConfig(config) {
2015-05-12 17:28:11 -04:00
config = $.extend({}, this.constructor.Default, $(this.element).data(), config);
if (config.delay && typeof config.delay === 'number') {
config.delay = {
2015-05-12 17:28:11 -04:00
show: config.delay,
hide: config.delay
};
}
2015-05-13 17:46:50 -04:00
Util.typeCheckConfig(NAME, config, this.constructor.DefaultType);
return config;
}
}, {
key: '_getDelegateConfig',
value: function _getDelegateConfig() {
var config = {};
if (this.config) {
for (var key in this.config) {
2015-08-18 23:28:28 -04:00
if (this.constructor.Default[key] !== this.config[key]) {
config[key] = this.config[key];
}
}
}
return config;
}
2015-08-13 00:12:03 -04:00
// static
}], [{
2015-08-13 00:12:03 -04:00
key: '_jQueryInterface',
value: function _jQueryInterface(config) {
return this.each(function () {
var data = $(this).data(DATA_KEY);
var _config = typeof config === 'object' ? config : null;
if (!data && /destroy|hide/.test(config)) {
return;
}
2015-08-13 00:12:03 -04:00
if (!data) {
data = new Tooltip(this, _config);
$(this).data(DATA_KEY, data);
}
2015-08-13 00:12:03 -04:00
if (typeof config === 'string') {
2015-10-10 00:03:43 -04:00
if (data[config] === undefined) {
throw new Error('No method named "' + config + '"');
}
2015-08-13 00:12:03 -04:00
data[config]();
}
});
}
}, {
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;
})();
$.fn[NAME] = Tooltip._jQueryInterface;
$.fn[NAME].Constructor = Tooltip;
$.fn[NAME].noConflict = function () {
$.fn[NAME] = JQUERY_NO_CONFLICT;
return Tooltip._jQueryInterface;
};
return Tooltip;
})(jQuery);
2015-08-13 00:12:03 -04:00
//# sourceMappingURL=tooltip.js.map