1 /* ===========================================================
2 * bootstrap-tooltip.js v2.0.4
3 * http://twitter.github.com/bootstrap/javascript.html#tooltips
4 * Inspired by the original jQuery.tipsy by Jason Frame
5 * ===========================================================
6 * Copyright 2012 Twitter, Inc.
8 * Licensed under the Apache License, Version 2.0 (the "License");
9 * you may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
12 * http://www.apache.org/licenses/LICENSE-2.0
14 * Unless required by applicable law or agreed to in writing, software
15 * distributed under the License is distributed on an "AS IS" BASIS,
16 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 * See the License for the specific language governing permissions and
18 * limitations under the License.
19 * ========================================================== */
24 "use strict"; // jshint ;_;
27 /* TOOLTIP PUBLIC CLASS DEFINITION
28 * =============================== */
30 var Tooltip = function (element, options) {
31 this.init('tooltip', element, options)
38 , init: function (type, element, options) {
43 this.$element = $(element)
44 this.options = this.getOptions(options)
47 if (this.options.trigger != 'manual') {
48 eventIn = this.options.trigger == 'hover' ? 'mouseenter' : 'focus'
49 eventOut = this.options.trigger == 'hover' ? 'mouseleave' : 'blur'
50 this.$element.on(eventIn, this.options.selector, $.proxy(this.enter, this))
51 this.$element.on(eventOut, this.options.selector, $.proxy(this.leave, this))
54 this.options.selector ?
55 (this._options = $.extend({}, this.options, { trigger: 'manual', selector: '' })) :
59 , getOptions: function (options) {
60 options = $.extend({}, $.fn[this.type].defaults, options, this.$element.data())
62 if (options.delay && typeof options.delay == 'number') {
72 , enter: function (e) {
73 var self = $(e.currentTarget)[this.type](this._options).data(this.type)
75 if (!self.options.delay || !self.options.delay.show) return self.show()
77 clearTimeout(this.timeout)
78 self.hoverState = 'in'
79 this.timeout = setTimeout(function() {
80 if (self.hoverState == 'in') self.show()
81 }, self.options.delay.show)
84 , leave: function (e) {
85 var self = $(e.currentTarget)[this.type](this._options).data(this.type)
87 if (this.timeout) clearTimeout(this.timeout)
88 if (!self.options.delay || !self.options.delay.hide) return self.hide()
90 self.hoverState = 'out'
91 this.timeout = setTimeout(function() {
92 if (self.hoverState == 'out') self.hide()
93 }, self.options.delay.hide)
105 if (this.hasContent() && this.enabled) {
109 if (this.options.animation) {
110 $tip.addClass('fade')
113 placement = typeof this.options.placement == 'function' ?
114 this.options.placement.call(this, $tip[0], this.$element[0]) :
115 this.options.placement
117 inside = /in/.test(placement)
121 .css({ top: 0, left: 0, display: 'block' })
122 .appendTo(inside ? this.$element : document.body)
124 pos = this.getPosition(inside)
126 actualWidth = $tip[0].offsetWidth
127 actualHeight = $tip[0].offsetHeight
129 switch (inside ? placement.split(' ')[1] : placement) {
131 tp = {top: pos.top + pos.height, left: pos.left + pos.width / 2 - actualWidth / 2}
134 tp = {top: pos.top - actualHeight, left: pos.left + pos.width / 2 - actualWidth / 2}
137 tp = {top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left - actualWidth}
140 tp = {top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left + pos.width}
151 , isHTML: function(text) {
152 // html string detection logic adapted from jQuery
153 return typeof text != 'string'
154 || ( text.charAt(0) === "<"
155 && text.charAt( text.length - 1 ) === ">"
157 ) || /^(?:[^<]*<[\w\W]+>[^>]*$)/.exec(text)
160 , setContent: function () {
161 var $tip = this.tip()
162 , title = this.getTitle()
164 $tip.find('.tooltip-inner')[this.isHTML(title) ? 'html' : 'text'](title)
165 $tip.removeClass('fade in top bottom left right')
168 , hide: function () {
172 $tip.removeClass('in')
174 function removeWithAnimation() {
175 var timeout = setTimeout(function () {
176 $tip.off($.support.transition.end).remove()
179 $tip.one($.support.transition.end, function () {
180 clearTimeout(timeout)
185 $.support.transition && this.$tip.hasClass('fade') ?
186 removeWithAnimation() :
190 , fixTitle: function () {
191 var $e = this.$element
192 if ($e.attr('title') || typeof($e.attr('data-original-title')) != 'string') {
193 $e.attr('data-original-title', $e.attr('title') || '').removeAttr('title')
197 , hasContent: function () {
198 return this.getTitle()
201 , getPosition: function (inside) {
202 return $.extend({}, (inside ? {top: 0, left: 0} : this.$element.offset()), {
203 width: this.$element[0].offsetWidth
204 , height: this.$element[0].offsetHeight
208 , getTitle: function () {
213 title = $e.attr('data-original-title')
214 || (typeof o.title == 'function' ? o.title.call($e[0]) : o.title)
220 return this.$tip = this.$tip || $(this.options.template)
223 , validate: function () {
224 if (!this.$element[0].parentNode) {
231 , enable: function () {
235 , disable: function () {
239 , toggleEnabled: function () {
240 this.enabled = !this.enabled
243 , toggle: function () {
244 this[this.tip().hasClass('in') ? 'hide' : 'show']()
250 /* TOOLTIP PLUGIN DEFINITION
251 * ========================= */
253 $.fn.tooltip = function ( option ) {
254 return this.each(function () {
256 , data = $this.data('tooltip')
257 , options = typeof option == 'object' && option
258 if (!data) $this.data('tooltip', (data = new Tooltip(this, options)))
259 if (typeof option == 'string') data[option]()
263 $.fn.tooltip.Constructor = Tooltip
265 $.fn.tooltip.defaults = {
269 , template: '<div class="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'