← Back to branch summary

~lss-team/lilsoftstats/trunk

« back to all changes in this revision

Viewing changes to js/jquery/jquery.tooltip.js

  • Committer: Nick
  • Date: 2011-11-14 04:10:28 UTC
  • Revision ID: nick@little-apps.org-20111114041028-cvmpwq6z6hx3pkya
first commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
js/jquery/jquery.tooltip.js
 
1
/*
 
2
 * jQuery Tooltip plugin 1.3
 
3
 *
 
4
 * http://bassistance.de/jquery-plugins/jquery-plugin-tooltip/
 
5
 * http://docs.jquery.com/Plugins/Tooltip
 
6
 *
 
7
 * Copyright (c) 2006 - 2008 Jörn Zaefferer
 
8
 *
 
9
 * $Id: jquery.tooltip.js 5741 2008-06-21 15:22:16Z joern.zaefferer $
 
10
 * 
 
11
 * Dual licensed under the MIT and GPL licenses:
 
12
 *   http://www.opensource.org/licenses/mit-license.php
 
13
 *   http://www.gnu.org/licenses/gpl.html
 
14
 */
 
15
 
 
16
;(function($) {
 
17
        
 
18
                // the tooltip element
 
19
        var helper = {},
 
20
                // the current tooltipped element
 
21
                current,
 
22
                // the title of the current element, used for restoring
 
23
                title,
 
24
                // timeout id for delayed tooltips
 
25
                tID,
 
26
                // IE 5.5 or 6
 
27
                IE = $.browser.msie && /MSIE\s(5\.5|6\.)/.test(navigator.userAgent),
 
28
                // flag for mouse tracking
 
29
                track = false;
 
30
        
 
31
        $.tooltip = {
 
32
                blocked: false,
 
33
                defaults: {
 
34
                        delay: 200,
 
35
                        fade: false,
 
36
                        showURL: true,
 
37
                        extraClass: "",
 
38
                        top: 15,
 
39
                        left: 15,
 
40
                        id: "tooltip"
 
41
                },
 
42
                block: function() {
 
43
                        $.tooltip.blocked = !$.tooltip.blocked;
 
44
                }
 
45
        };
 
46
        
 
47
        $.fn.extend({
 
48
                tooltip: function(settings) {
 
49
                        settings = $.extend({}, $.tooltip.defaults, settings);
 
50
                        createHelper(settings);
 
51
                        return this.each(function() {
 
52
                                        $.data(this, "tooltip", settings);
 
53
                                        this.tOpacity = helper.parent.css("opacity");
 
54
                                        // copy tooltip into its own expando and remove the title
 
55
                                        this.tooltipText = this.title;
 
56
                                        $(this).removeAttr("title");
 
57
                                        // also remove alt attribute to prevent default tooltip in IE
 
58
                                        this.alt = "";
 
59
                                })
 
60
                                .mouseover(save)
 
61
                                .mouseout(hide)
 
62
                                .click(hide);
 
63
                },
 
64
                fixPNG: IE ? function() {
 
65
                        return this.each(function () {
 
66
                                var image = $(this).css('backgroundImage');
 
67
                                if (image.match(/^url\(["']?(.*\.png)["']?\)$/i)) {
 
68
                                        image = RegExp.$1;
 
69
                                        $(this).css({
 
70
                                                'backgroundImage': 'none',
 
71
                                                'filter': "progid:DXImageTransform.Microsoft.AlphaImageLoader(enabled=true, sizingMethod=crop, src='" + image + "')"
 
72
                                        }).each(function () {
 
73
                                                var position = $(this).css('position');
 
74
                                                if (position != 'absolute' && position != 'relative')
 
75
                                                        $(this).css('position', 'relative');
 
76
                                        });
 
77
                                }
 
78
                        });
 
79
                } : function() { return this; },
 
80
                unfixPNG: IE ? function() {
 
81
                        return this.each(function () {
 
82
                                $(this).css({'filter': '', backgroundImage: ''});
 
83
                        });
 
84
                } : function() { return this; },
 
85
                hideWhenEmpty: function() {
 
86
                        return this.each(function() {
 
87
                                $(this)[ $(this).html() ? "show" : "hide" ]();
 
88
                        });
 
89
                },
 
90
                url: function() {
 
91
                        return this.attr('href') || this.attr('src');
 
92
                }
 
93
        });
 
94
        
 
95
        function createHelper(settings) {
 
96
                // there can be only one tooltip helper
 
97
                if( helper.parent )
 
98
                        return;
 
99
                // create the helper, h3 for title, div for url
 
100
                helper.parent = $('<div id="' + settings.id + '"><h3></h3><div class="body"></div><div class="url"></div></div>')
 
101
                        // add to document
 
102
                        .appendTo(document.body)
 
103
                        // hide it at first
 
104
                        .hide();
 
105
                        
 
106
                // apply bgiframe if available
 
107
                if ( $.fn.bgiframe )
 
108
                        helper.parent.bgiframe();
 
109
                
 
110
                // save references to title and url elements
 
111
                helper.title = $('h3', helper.parent);
 
112
                helper.body = $('div.body', helper.parent);
 
113
                helper.url = $('div.url', helper.parent);
 
114
        }
 
115
        
 
116
        function settings(element) {
 
117
                return $.data(element, "tooltip");
 
118
        }
 
119
        
 
120
        // main event handler to start showing tooltips
 
121
        function handle(event) {
 
122
                // show helper, either with timeout or on instant
 
123
                if( settings(this).delay )
 
124
                        tID = setTimeout(show, settings(this).delay);
 
125
                else
 
126
                        show();
 
127
                
 
128
                // if selected, update the helper position when the mouse moves
 
129
                track = !!settings(this).track;
 
130
                $(document.body).bind('mousemove', update);
 
131
                        
 
132
                // update at least once
 
133
                update(event);
 
134
        }
 
135
        
 
136
        // save elements title before the tooltip is displayed
 
137
        function save() {
 
138
                // if this is the current source, or it has no title (occurs with click event), stop
 
139
                if ( $.tooltip.blocked || this == current || (!this.tooltipText && !settings(this).bodyHandler) )
 
140
                        return;
 
141
 
 
142
                // save current
 
143
                current = this;
 
144
                title = this.tooltipText;
 
145
                
 
146
                if ( settings(this).bodyHandler ) {
 
147
                        helper.title.hide();
 
148
                        var bodyContent = settings(this).bodyHandler.call(this);
 
149
                        if (bodyContent.nodeType || bodyContent.jquery) {
 
150
                                helper.body.empty().append(bodyContent)
 
151
                        } else {
 
152
                                helper.body.html( bodyContent );
 
153
                        }
 
154
                        helper.body.show();
 
155
                } else if ( settings(this).showBody ) {
 
156
                        var parts = title.split(settings(this).showBody);
 
157
                        helper.title.html(parts.shift()).show();
 
158
                        helper.body.empty();
 
159
                        for(var i = 0, part; (part = parts[i]); i++) {
 
160
                                if(i > 0)
 
161
                                        helper.body.append("<br/>");
 
162
                                helper.body.append(part);
 
163
                        }
 
164
                        helper.body.hideWhenEmpty();
 
165
                } else {
 
166
                        helper.title.html(title).show();
 
167
                        helper.body.hide();
 
168
                }
 
169
                
 
170
                // if element has href or src, add and show it, otherwise hide it
 
171
                if( settings(this).showURL && $(this).url() )
 
172
                        helper.url.html( $(this).url().replace('http://', '') ).show();
 
173
                else 
 
174
                        helper.url.hide();
 
175
                
 
176
                // add an optional class for this tip
 
177
                helper.parent.addClass(settings(this).extraClass);
 
178
 
 
179
                // fix PNG background for IE
 
180
                if (settings(this).fixPNG )
 
181
                        helper.parent.fixPNG();
 
182
                        
 
183
                handle.apply(this, arguments);
 
184
        }
 
185
        
 
186
        // delete timeout and show helper
 
187
        function show() {
 
188
                tID = null;
 
189
                if ((!IE || !$.fn.bgiframe) && settings(current).fade) {
 
190
                        if (helper.parent.is(":animated"))
 
191
                                helper.parent.stop().show().fadeTo(settings(current).fade, current.tOpacity);
 
192
                        else
 
193
                                helper.parent.is(':visible') ? helper.parent.fadeTo(settings(current).fade, current.tOpacity) : helper.parent.fadeIn(settings(current).fade);
 
194
                } else {
 
195
                        helper.parent.show();
 
196
                }
 
197
                update();
 
198
        }
 
199
        
 
200
        /**
 
201
         * callback for mousemove
 
202
         * updates the helper position
 
203
         * removes itself when no current element
 
204
         */
 
205
        function update(event)  {
 
206
                if($.tooltip.blocked)
 
207
                        return;
 
208
                
 
209
                if (event && event.target.tagName == "OPTION") {
 
210
                        return;
 
211
                }
 
212
                
 
213
                // stop updating when tracking is disabled and the tooltip is visible
 
214
                if ( !track && helper.parent.is(":visible")) {
 
215
                        $(document.body).unbind('mousemove', update)
 
216
                }
 
217
                
 
218
                // if no current element is available, remove this listener
 
219
                if( current == null ) {
 
220
                        $(document.body).unbind('mousemove', update);
 
221
                        return; 
 
222
                }
 
223
                
 
224
                // remove position helper classes
 
225
                helper.parent.removeClass("viewport-right").removeClass("viewport-bottom");
 
226
                
 
227
                var left = helper.parent[0].offsetLeft;
 
228
                var top = helper.parent[0].offsetTop;
 
229
                if (event) {
 
230
                        // position the helper 15 pixel to bottom right, starting from mouse position
 
231
                        left = event.pageX + settings(current).left;
 
232
                        top = event.pageY + settings(current).top;
 
233
                        var right='auto';
 
234
                        if (settings(current).positionLeft) {
 
235
                                right = $(window).width() - left;
 
236
                                left = 'auto';
 
237
                        }
 
238
                        helper.parent.css({
 
239
                                left: left,
 
240
                                right: right,
 
241
                                top: top
 
242
                        });
 
243
                }
 
244
                
 
245
                var v = viewport(),
 
246
                        h = helper.parent[0];
 
247
                // check horizontal position
 
248
                if (v.x + v.cx < h.offsetLeft + h.offsetWidth) {
 
249
                        left -= h.offsetWidth + 20 + settings(current).left;
 
250
                        helper.parent.css({left: left + 'px'}).addClass("viewport-right");
 
251
                }
 
252
                // check vertical position
 
253
                if (v.y + v.cy < h.offsetTop + h.offsetHeight) {
 
254
                        top -= h.offsetHeight + 20 + settings(current).top;
 
255
                        helper.parent.css({top: top + 'px'}).addClass("viewport-bottom");
 
256
                }
 
257
        }
 
258
        
 
259
        function viewport() {
 
260
                return {
 
261
                        x: $(window).scrollLeft(),
 
262
                        y: $(window).scrollTop(),
 
263
                        cx: $(window).width(),
 
264
                        cy: $(window).height()
 
265
                };
 
266
        }
 
267
        
 
268
        // hide helper and restore added classes and the title
 
269
        function hide(event) {
 
270
                if($.tooltip.blocked)
 
271
                        return;
 
272
                // clear timeout if possible
 
273
                if(tID)
 
274
                        clearTimeout(tID);
 
275
                // no more current element
 
276
                current = null;
 
277
                
 
278
                var tsettings = settings(this);
 
279
                function complete() {
 
280
                        helper.parent.removeClass( tsettings.extraClass ).hide().css("opacity", "");
 
281
                }
 
282
                if ((!IE || !$.fn.bgiframe) && tsettings.fade) {
 
283
                        if (helper.parent.is(':animated'))
 
284
                                helper.parent.stop().fadeTo(tsettings.fade, 0, complete);
 
285
                        else
 
286
                                helper.parent.stop().fadeOut(tsettings.fade, complete);
 
287
                } else
 
288
                        complete();
 
289
                
 
290
                if( settings(this).fixPNG )
 
291
                        helper.parent.unfixPNG();
 
292
        }
 
293
        
 
294
})(jQuery);