| 1 | /* |
|---|
| 2 | * TipTip |
|---|
| 3 | * Copyright 2010 Drew Wilson |
|---|
| 4 | * www.drewwilson.com |
|---|
| 5 | * code.drewwilson.com/entry/tiptip-jquery-plugin |
|---|
| 6 | * |
|---|
| 7 | * Version 1.3 - Updated: Mar. 23, 2010 |
|---|
| 8 | * |
|---|
| 9 | * This Plug-In will create a custom tooltip to replace the default |
|---|
| 10 | * browser tooltip. It is extremely lightweight and very smart in |
|---|
| 11 | * that it detects the edges of the browser window and will make sure |
|---|
| 12 | * the tooltip stays within the current window size. As a result the |
|---|
| 13 | * tooltip will adjust itself to be displayed above, below, to the left |
|---|
| 14 | * or to the right depending on what is necessary to stay within the |
|---|
| 15 | * browser window. It is completely customizable as well via CSS. |
|---|
| 16 | * |
|---|
| 17 | * This TipTip jQuery plug-in is dual licensed under the MIT and GPL licenses: |
|---|
| 18 | * http://www.opensource.org/licenses/mit-license.php |
|---|
| 19 | * http://www.gnu.org/licenses/gpl.html |
|---|
| 20 | */ |
|---|
| 21 | |
|---|
| 22 | (function($){ |
|---|
| 23 | $.fn.tipTip = function(options) { |
|---|
| 24 | var defaults = { |
|---|
| 25 | activation: "hover", |
|---|
| 26 | keepAlive: false, |
|---|
| 27 | maxWidth: "200px", |
|---|
| 28 | edgeOffset: 3, |
|---|
| 29 | defaultPosition: "bottom", |
|---|
| 30 | delay: 400, |
|---|
| 31 | fadeIn: 200, |
|---|
| 32 | fadeOut: 200, |
|---|
| 33 | attribute: "title", |
|---|
| 34 | content: false, // HTML or String to fill TipTIp with |
|---|
| 35 | enter: function(){}, |
|---|
| 36 | exit: function(){} |
|---|
| 37 | }; |
|---|
| 38 | var opts = $.extend(defaults, options); |
|---|
| 39 | |
|---|
| 40 | // Setup tip tip elements and render them to the DOM |
|---|
| 41 | if($("#tiptip_holder").length <= 0){ |
|---|
| 42 | var tiptip_holder = $('<div id="tiptip_holder" style="max-width:'+ opts.maxWidth +';"></div>'); |
|---|
| 43 | var tiptip_content = $('<div id="tiptip_content"></div>'); |
|---|
| 44 | var tiptip_arrow = $('<div id="tiptip_arrow"></div>'); |
|---|
| 45 | $("body").append(tiptip_holder.html(tiptip_content).prepend(tiptip_arrow.html('<div id="tiptip_arrow_inner"></div>'))); |
|---|
| 46 | } else { |
|---|
| 47 | var tiptip_holder = $("#tiptip_holder"); |
|---|
| 48 | var tiptip_content = $("#tiptip_content"); |
|---|
| 49 | var tiptip_arrow = $("#tiptip_arrow"); |
|---|
| 50 | } |
|---|
| 51 | |
|---|
| 52 | return this.each(function(){ |
|---|
| 53 | var org_elem = $(this); |
|---|
| 54 | if(opts.content){ |
|---|
| 55 | var org_title = opts.content; |
|---|
| 56 | } else { |
|---|
| 57 | var org_title = org_elem.attr(opts.attribute); |
|---|
| 58 | } |
|---|
| 59 | if(org_title != ""){ |
|---|
| 60 | if(!opts.content){ |
|---|
| 61 | org_elem.removeAttr(opts.attribute); //remove original Attribute |
|---|
| 62 | } |
|---|
| 63 | var timeout = false; |
|---|
| 64 | |
|---|
| 65 | if(opts.activation == "hover"){ |
|---|
| 66 | org_elem.hover(function(){ |
|---|
| 67 | active_tiptip(); |
|---|
| 68 | }, function(){ |
|---|
| 69 | if(!opts.keepAlive){ |
|---|
| 70 | deactive_tiptip(); |
|---|
| 71 | } |
|---|
| 72 | }); |
|---|
| 73 | if(opts.keepAlive){ |
|---|
| 74 | tiptip_holder.hover(function(){}, function(){ |
|---|
| 75 | deactive_tiptip(); |
|---|
| 76 | }); |
|---|
| 77 | } |
|---|
| 78 | } else if(opts.activation == "focus"){ |
|---|
| 79 | org_elem.focus(function(){ |
|---|
| 80 | active_tiptip(); |
|---|
| 81 | }).blur(function(){ |
|---|
| 82 | deactive_tiptip(); |
|---|
| 83 | }); |
|---|
| 84 | } else if(opts.activation == "click"){ |
|---|
| 85 | org_elem.click(function(){ |
|---|
| 86 | active_tiptip(); |
|---|
| 87 | return false; |
|---|
| 88 | }).hover(function(){},function(){ |
|---|
| 89 | if(!opts.keepAlive){ |
|---|
| 90 | deactive_tiptip(); |
|---|
| 91 | } |
|---|
| 92 | }); |
|---|
| 93 | if(opts.keepAlive){ |
|---|
| 94 | tiptip_holder.hover(function(){}, function(){ |
|---|
| 95 | deactive_tiptip(); |
|---|
| 96 | }); |
|---|
| 97 | } |
|---|
| 98 | } |
|---|
| 99 | |
|---|
| 100 | function active_tiptip(){ |
|---|
| 101 | opts.enter.call(this); |
|---|
| 102 | tiptip_content.html(org_title); |
|---|
| 103 | tiptip_holder.hide().removeAttr("class").css("margin","0"); |
|---|
| 104 | tiptip_arrow.removeAttr("style"); |
|---|
| 105 | |
|---|
| 106 | var top = parseInt(org_elem.offset()['top']); |
|---|
| 107 | var left = parseInt(org_elem.offset()['left']); |
|---|
| 108 | var org_width = parseInt(org_elem.outerWidth()); |
|---|
| 109 | var org_height = parseInt(org_elem.outerHeight()); |
|---|
| 110 | var tip_w = tiptip_holder.outerWidth(); |
|---|
| 111 | var tip_h = tiptip_holder.outerHeight(); |
|---|
| 112 | var w_compare = Math.round((org_width - tip_w) / 2); |
|---|
| 113 | var h_compare = Math.round((org_height - tip_h) / 2); |
|---|
| 114 | var marg_left = Math.round(left + w_compare); |
|---|
| 115 | var marg_top = Math.round(top + org_height + opts.edgeOffset); |
|---|
| 116 | var t_class = ""; |
|---|
| 117 | var arrow_top = ""; |
|---|
| 118 | var arrow_left = Math.round(tip_w - 12) / 2; |
|---|
| 119 | |
|---|
| 120 | if(opts.defaultPosition == "bottom"){ |
|---|
| 121 | t_class = "_bottom"; |
|---|
| 122 | } else if(opts.defaultPosition == "top"){ |
|---|
| 123 | t_class = "_top"; |
|---|
| 124 | } else if(opts.defaultPosition == "left"){ |
|---|
| 125 | t_class = "_left"; |
|---|
| 126 | } else if(opts.defaultPosition == "right"){ |
|---|
| 127 | t_class = "_right"; |
|---|
| 128 | } |
|---|
| 129 | |
|---|
| 130 | var right_compare = (w_compare + left) < parseInt($(window).scrollLeft()); |
|---|
| 131 | var left_compare = (tip_w + left) > parseInt($(window).width()); |
|---|
| 132 | |
|---|
| 133 | if((right_compare && w_compare < 0) || (t_class == "_right" && !left_compare) || (t_class == "_left" && left < (tip_w + opts.edgeOffset + 5))){ |
|---|
| 134 | t_class = "_right"; |
|---|
| 135 | arrow_top = Math.round(tip_h - 13) / 2; |
|---|
| 136 | arrow_left = -12; |
|---|
| 137 | marg_left = Math.round(left + org_width + opts.edgeOffset); |
|---|
| 138 | marg_top = Math.round(top + h_compare); |
|---|
| 139 | } else if((left_compare && w_compare < 0) || (t_class == "_left" && !right_compare)){ |
|---|
| 140 | t_class = "_left"; |
|---|
| 141 | arrow_top = Math.round(tip_h - 13) / 2; |
|---|
| 142 | arrow_left = Math.round(tip_w); |
|---|
| 143 | marg_left = Math.round(left - (tip_w + opts.edgeOffset + 5)); |
|---|
| 144 | marg_top = Math.round(top + h_compare); |
|---|
| 145 | } |
|---|
| 146 | |
|---|
| 147 | var top_compare = (top + org_height + opts.edgeOffset + tip_h + 8) > parseInt($(window).height() + $(window).scrollTop()); |
|---|
| 148 | var bottom_compare = ((top + org_height) - (opts.edgeOffset + tip_h + 8)) < 0; |
|---|
| 149 | |
|---|
| 150 | if(top_compare || (t_class == "_bottom" && top_compare) || (t_class == "_top" && !bottom_compare)){ |
|---|
| 151 | if(t_class == "_top" || t_class == "_bottom"){ |
|---|
| 152 | t_class = "_top"; |
|---|
| 153 | } else { |
|---|
| 154 | t_class = t_class+"_top"; |
|---|
| 155 | } |
|---|
| 156 | arrow_top = tip_h; |
|---|
| 157 | marg_top = Math.round(top - (tip_h + 5 + opts.edgeOffset)); |
|---|
| 158 | } else if(bottom_compare | (t_class == "_top" && bottom_compare) || (t_class == "_bottom" && !top_compare)){ |
|---|
| 159 | if(t_class == "_top" || t_class == "_bottom"){ |
|---|
| 160 | t_class = "_bottom"; |
|---|
| 161 | } else { |
|---|
| 162 | t_class = t_class+"_bottom"; |
|---|
| 163 | } |
|---|
| 164 | arrow_top = -12; |
|---|
| 165 | marg_top = Math.round(top + org_height + opts.edgeOffset); |
|---|
| 166 | } |
|---|
| 167 | |
|---|
| 168 | if(t_class == "_right_top" || t_class == "_left_top"){ |
|---|
| 169 | marg_top = marg_top + 5; |
|---|
| 170 | } else if(t_class == "_right_bottom" || t_class == "_left_bottom"){ |
|---|
| 171 | marg_top = marg_top - 5; |
|---|
| 172 | } |
|---|
| 173 | if(t_class == "_left_top" || t_class == "_left_bottom"){ |
|---|
| 174 | marg_left = marg_left + 5; |
|---|
| 175 | } |
|---|
| 176 | tiptip_arrow.css({"margin-left": arrow_left+"px", "margin-top": arrow_top+"px"}); |
|---|
| 177 | tiptip_holder.css({"margin-left": marg_left+"px", "margin-top": marg_top+"px"}).attr("class","tip"+t_class); |
|---|
| 178 | |
|---|
| 179 | if (timeout){ clearTimeout(timeout); } |
|---|
| 180 | timeout = setTimeout(function(){ tiptip_holder.stop(true,true).fadeIn(opts.fadeIn); }, opts.delay); |
|---|
| 181 | } |
|---|
| 182 | |
|---|
| 183 | function deactive_tiptip(){ |
|---|
| 184 | opts.exit.call(this); |
|---|
| 185 | if (timeout){ clearTimeout(timeout); } |
|---|
| 186 | tiptip_holder.fadeOut(opts.fadeOut); |
|---|
| 187 | } |
|---|
| 188 | } |
|---|
| 189 | }); |
|---|
| 190 | } |
|---|
| 191 | })(jQuery); |
|---|
