| 1 |
986
|
Ruebenwurz
|
/*
|
| 2 |
|
|
VERSION: Drop Shadow jQuery Plugin 1.6 12-13-2007
|
| 3 |
|
|
|
| 4 |
|
|
REQUIRES: jquery.js (1.2.6 or later)
|
| 5 |
|
|
|
| 6 |
|
|
SYNTAX: $(selector).dropShadow(options); // Creates new drop shadows
|
| 7 |
|
|
$(selector).redrawShadow(); // Redraws shadows on elements
|
| 8 |
|
|
$(selector).removeShadow(); // Removes shadows from elements
|
| 9 |
|
|
$(selector).shadowId(); // Returns an existing shadow's ID
|
| 10 |
|
|
|
| 11 |
|
|
OPTIONS:
|
| 12 |
|
|
|
| 13 |
|
|
left : integer (default = 4)
|
| 14 |
|
|
top : integer (default = 4)
|
| 15 |
|
|
blur : integer (default = 2)
|
| 16 |
|
|
opacity : decimal (default = 0.5)
|
| 17 |
|
|
color : string (default = "black")
|
| 18 |
|
|
swap : boolean (default = false)
|
| 19 |
|
|
|
| 20 |
|
|
The left and top parameters specify the distance and direction, in pixels, to
|
| 21 |
|
|
offset the shadow. Zero values position the shadow directly behind the element.
|
| 22 |
|
|
Positive values shift the shadow to the right and down, while negative values
|
| 23 |
|
|
shift the shadow to the left and up.
|
| 24 |
|
|
|
| 25 |
|
|
The blur parameter specifies the spread, or dispersion, of the shadow. Zero
|
| 26 |
|
|
produces a sharp shadow, one or two produces a normal shadow, and three or four
|
| 27 |
|
|
produces a softer shadow. Higher values increase the processing load.
|
| 28 |
|
|
|
| 29 |
|
|
The opacity parameter should be a decimal value, usually less than one. You can
|
| 30 |
|
|
use a value higher than one in special situations, e.g. with extreme blurring.
|
| 31 |
|
|
|
| 32 |
|
|
Color is specified in the usual manner, with a color name or hex value. The
|
| 33 |
|
|
color parameter does not apply with transparent images.
|
| 34 |
|
|
|
| 35 |
|
|
The swap parameter reverses the stacking order of the original and the shadow.
|
| 36 |
|
|
This can be used for special effects, like an embossed or engraved look.
|
| 37 |
|
|
|
| 38 |
|
|
EXPLANATION:
|
| 39 |
|
|
|
| 40 |
|
|
This jQuery plug-in adds soft drop shadows behind page elements. It is only
|
| 41 |
|
|
intended for adding a few drop shadows to mostly stationary objects, like a
|
| 42 |
|
|
page heading, a photo, or content containers.
|
| 43 |
|
|
|
| 44 |
|
|
The shadows it creates are not bound to the original elements, so they won't
|
| 45 |
|
|
move or change size automatically if the original elements change. A window
|
| 46 |
|
|
resize event listener is assigned, which should re-align the shadows in many
|
| 47 |
|
|
cases, but if the elements otherwise move or resize you will have to handle
|
| 48 |
|
|
those events manually. Shadows can be redrawn with the redrawShadow() method
|
| 49 |
|
|
or removed with the removeShadow() method. The redrawShadow() method uses the
|
| 50 |
|
|
same options used to create the original shadow. If you want to change the
|
| 51 |
|
|
options, you should remove the shadow first and then create a new shadow.
|
| 52 |
|
|
|
| 53 |
|
|
The dropShadow method returns a jQuery collection of the new shadow(s). If
|
| 54 |
|
|
further manipulation is required, you can store it in a variable like this:
|
| 55 |
|
|
|
| 56 |
|
|
var myShadow = $("#myElement").dropShadow();
|
| 57 |
|
|
|
| 58 |
|
|
You can also read the ID of the shadow from the original element at a later
|
| 59 |
|
|
time. To get a shadow's ID, either read the shadowId attribute of the
|
| 60 |
|
|
original element or call the shadowId() method. For example:
|
| 61 |
|
|
|
| 62 |
|
|
var myShadowId = $("#myElement").attr("shadowId"); or
|
| 63 |
|
|
var myShadowId = $("#myElement").shadowId();
|
| 64 |
|
|
|
| 65 |
|
|
If the original element does not already have an ID assigned, a random ID will
|
| 66 |
|
|
be generated for the shadow. However, if the original does have an ID, the
|
| 67 |
|
|
shadow's ID will be the original ID and "_dropShadow". For example, if the
|
| 68 |
|
|
element's ID is "myElement", the shadow's ID would be "myElement_dropShadow".
|
| 69 |
|
|
|
| 70 |
|
|
If you have a long piece of text and the user resizes the window so that the
|
| 71 |
|
|
text wraps or unwraps, the shape of the text changes and the words are no
|
| 72 |
|
|
longer in the same positions. In that case, you can either preset the height
|
| 73 |
|
|
and width, so that it becomes a fixed box, or you can shadow each word
|
| 74 |
|
|
separately, like this:
|
| 75 |
|
|
|
| 76 |
|
|
<h1><span>Your</span> <span>Page</span> <span>Title</span></h1>
|
| 77 |
|
|
|
| 78 |
|
|
$("h1 span").dropShadow();
|
| 79 |
|
|
|
| 80 |
|
|
The dropShadow method attempts to determine whether the selected elements have
|
| 81 |
|
|
transparent backgrounds. If you want to shadow the content inside an element,
|
| 82 |
|
|
like text or a transparent image, it must not have a background-color or
|
| 83 |
|
|
background-image style. If the element has a solid background it will create a
|
| 84 |
|
|
rectangular shadow around the outside box.
|
| 85 |
|
|
|
| 86 |
|
|
The shadow elements are positioned absolutely one layer below the original
|
| 87 |
|
|
element, which is positioned relatively (unless it's already absolute).
|
| 88 |
|
|
|
| 89 |
|
|
*** All shadows have the "dropShadow" class, for selecting with CSS or jQuery.
|
| 90 |
|
|
|
| 91 |
|
|
ISSUES:
|
| 92 |
|
|
|
| 93 |
|
|
1) Limited styling of shadowed elements by ID. Because IDs must be unique,
|
| 94 |
|
|
and the shadows have their own ID, styles applied by ID won't transfer
|
| 95 |
|
|
to the shadows. Instead, style elements by class or use inline styles.
|
| 96 |
|
|
2) Sometimes shadows don't align properly. Elements may need to be wrapped
|
| 97 |
|
|
in container elements, margins or floats changed, etc. or you may just
|
| 98 |
|
|
have to tweak the left and top offsets to get them to align. For example,
|
| 99 |
|
|
with draggable objects, you have to wrap them inside two divs. Make the
|
| 100 |
|
|
outer div draggable and set the inner div's position to relative. Then
|
| 101 |
|
|
you can create a shadow on the element inside the inner div.
|
| 102 |
|
|
3) If the user changes font sizes it will throw the shadows off. Browsers
|
| 103 |
|
|
do not expose an event for font size changes. The only known way to
|
| 104 |
|
|
detect a user font size change is to embed an invisible text element and
|
| 105 |
|
|
then continuously poll for changes in size.
|
| 106 |
|
|
4) Safari support is shaky, and may require even more tweaks/wrappers, etc.
|
| 107 |
|
|
|
| 108 |
|
|
The bottom line is that this is a gimick effect, not PFM, and if you push it
|
| 109 |
|
|
too hard or expect it to work in every possible situation on every browser,
|
| 110 |
|
|
you will be disappointed. Use it sparingly, and don't use it for anything
|
| 111 |
|
|
critical. Otherwise, have fun with it!
|
| 112 |
|
|
|
| 113 |
|
|
AUTHOR: Larry Stevens (McLars@eyebulb.com) This work is in the public domain,
|
| 114 |
|
|
and it is not supported in any way. Use it at your own risk.
|
| 115 |
|
|
*/
|
| 116 |
|
|
|
| 117 |
|
|
|
| 118 |
|
|
(function($){
|
| 119 |
|
|
|
| 120 |
|
|
var dropShadowZindex = 1; //z-index counter
|
| 121 |
|
|
|
| 122 |
|
|
$.fn.dropShadow = function(options)
|
| 123 |
|
|
{
|
| 124 |
|
|
// Default options
|
| 125 |
|
|
var opt = $.extend({
|
| 126 |
|
|
left: 4,
|
| 127 |
|
|
top: 4,
|
| 128 |
|
|
blur: 2,
|
| 129 |
|
|
opacity: .5,
|
| 130 |
|
|
color: "black",
|
| 131 |
|
|
swap: false
|
| 132 |
|
|
}, options);
|
| 133 |
|
|
var jShadows = $([]); //empty jQuery collection
|
| 134 |
|
|
|
| 135 |
|
|
// Loop through original elements
|
| 136 |
|
|
this.not(".dropShadow").each(function()
|
| 137 |
|
|
{
|
| 138 |
|
|
var jthis = $(this);
|
| 139 |
|
|
var shadows = [];
|
| 140 |
|
|
var blur = (opt.blur <= 0) ? 0 : opt.blur;
|
| 141 |
|
|
var opacity = (blur == 0) ? opt.opacity : opt.opacity / (blur * 8);
|
| 142 |
|
|
var zOriginal = (opt.swap) ? dropShadowZindex : dropShadowZindex + 1;
|
| 143 |
|
|
var zShadow = (opt.swap) ? dropShadowZindex + 1 : dropShadowZindex;
|
| 144 |
|
|
|
| 145 |
|
|
// Create ID for shadow
|
| 146 |
|
|
var shadowId;
|
| 147 |
|
|
if (this.id) {
|
| 148 |
|
|
shadowId = this.id + "_dropShadow";
|
| 149 |
|
|
}
|
| 150 |
|
|
else {
|
| 151 |
|
|
shadowId = "ds" + (1 + Math.floor(9999 * Math.random()));
|
| 152 |
|
|
}
|
| 153 |
|
|
|
| 154 |
|
|
// Modify original element
|
| 155 |
|
|
$.data(this, "shadowId", shadowId); //store id in expando
|
| 156 |
|
|
$.data(this, "shadowOptions", options); //store options in expando
|
| 157 |
|
|
jthis
|
| 158 |
|
|
.attr("shadowId", shadowId)
|
| 159 |
|
|
.css("zIndex", zOriginal);
|
| 160 |
|
|
if (jthis.css("position") != "absolute") {
|
| 161 |
|
|
jthis.css({
|
| 162 |
|
|
position: "relative",
|
| 163 |
|
|
zoom: 1 //for IE layout
|
| 164 |
|
|
});
|
| 165 |
|
|
}
|
| 166 |
|
|
|
| 167 |
|
|
// Create first shadow layer
|
| 168 |
|
|
bgColor = jthis.css("backgroundColor");
|
| 169 |
|
|
if (bgColor == "rgba(0, 0, 0, 0)") bgColor = "transparent"; //Safari
|
| 170 |
|
|
if (bgColor != "transparent" || jthis.css("backgroundImage") != "none"
|
| 171 |
|
|
|| this.nodeName == "SELECT"
|
| 172 |
|
|
|| this.nodeName == "INPUT"
|
| 173 |
|
|
|| this.nodeName == "TEXTAREA") {
|
| 174 |
|
|
shadows[0] = $("<div></div>")
|
| 175 |
|
|
.css("background", opt.color);
|
| 176 |
|
|
}
|
| 177 |
|
|
else {
|
| 178 |
|
|
shadows[0] = jthis
|
| 179 |
|
|
.clone()
|
| 180 |
|
|
.removeAttr("id")
|
| 181 |
|
|
.removeAttr("name")
|
| 182 |
|
|
.removeAttr("shadowId")
|
| 183 |
|
|
.css("color", opt.color);
|
| 184 |
|
|
}
|
| 185 |
|
|
shadows[0]
|
| 186 |
|
|
.addClass("dropShadow")
|
| 187 |
|
|
.css({
|
| 188 |
|
|
height: jthis.outerHeight(),
|
| 189 |
|
|
left: blur,
|
| 190 |
|
|
opacity: opacity,
|
| 191 |
|
|
position: "absolute",
|
| 192 |
|
|
top: blur,
|
| 193 |
|
|
width: jthis.outerWidth(),
|
| 194 |
|
|
zIndex: zShadow
|
| 195 |
|
|
});
|
| 196 |
|
|
|
| 197 |
|
|
// Create other shadow layers
|
| 198 |
|
|
var layers = (8 * blur) + 1;
|
| 199 |
|
|
for (i = 1; i < layers; i++) {
|
| 200 |
|
|
shadows[i] = shadows[0].clone();
|
| 201 |
|
|
}
|
| 202 |
|
|
|
| 203 |
|
|
// Position layers
|
| 204 |
|
|
var i = 1;
|
| 205 |
|
|
var j = blur;
|
| 206 |
|
|
while (j > 0) {
|
| 207 |
|
|
shadows[i].css({left: j * 2, top: 0}); //top
|
| 208 |
|
|
shadows[i + 1].css({left: j * 4, top: j * 2}); //right
|
| 209 |
|
|
shadows[i + 2].css({left: j * 2, top: j * 4}); //bottom
|
| 210 |
|
|
shadows[i + 3].css({left: 0, top: j * 2}); //left
|
| 211 |
|
|
shadows[i + 4].css({left: j * 3, top: j}); //top-right
|
| 212 |
|
|
shadows[i + 5].css({left: j * 3, top: j * 3}); //bottom-right
|
| 213 |
|
|
shadows[i + 6].css({left: j, top: j * 3}); //bottom-left
|
| 214 |
|
|
shadows[i + 7].css({left: j, top: j}); //top-left
|
| 215 |
|
|
i += 8;
|
| 216 |
|
|
j--;
|
| 217 |
|
|
}
|
| 218 |
|
|
|
| 219 |
|
|
// Create container
|
| 220 |
|
|
var divShadow = $("<div></div>")
|
| 221 |
|
|
.attr("id", shadowId)
|
| 222 |
|
|
.addClass("dropShadow")
|
| 223 |
|
|
.css({
|
| 224 |
|
|
left: jthis.position().left + opt.left - blur,
|
| 225 |
|
|
marginTop: jthis.css("marginTop"),
|
| 226 |
|
|
marginRight: jthis.css("marginRight"),
|
| 227 |
|
|
marginBottom: jthis.css("marginBottom"),
|
| 228 |
|
|
marginLeft: jthis.css("marginLeft"),
|
| 229 |
|
|
position: "absolute",
|
| 230 |
|
|
top: jthis.position().top + opt.top - blur,
|
| 231 |
|
|
zIndex: zShadow
|
| 232 |
|
|
});
|
| 233 |
|
|
|
| 234 |
|
|
// Add layers to container
|
| 235 |
|
|
for (i = 0; i < layers; i++) {
|
| 236 |
|
|
divShadow.append(shadows[i]);
|
| 237 |
|
|
}
|
| 238 |
|
|
|
| 239 |
|
|
// Add container to DOM
|
| 240 |
|
|
jthis.after(divShadow);
|
| 241 |
|
|
|
| 242 |
|
|
// Add shadow to return set
|
| 243 |
|
|
jShadows = jShadows.add(divShadow);
|
| 244 |
|
|
|
| 245 |
|
|
// Re-align shadow on window resize
|
| 246 |
|
|
$(window).resize(function()
|
| 247 |
|
|
{
|
| 248 |
|
|
try {
|
| 249 |
|
|
divShadow.css({
|
| 250 |
|
|
left: jthis.position().left + opt.left - blur,
|
| 251 |
|
|
top: jthis.position().top + opt.top - blur
|
| 252 |
|
|
});
|
| 253 |
|
|
}
|
| 254 |
|
|
catch(e){}
|
| 255 |
|
|
});
|
| 256 |
|
|
|
| 257 |
|
|
// Increment z-index counter
|
| 258 |
|
|
dropShadowZindex += 2;
|
| 259 |
|
|
|
| 260 |
|
|
}); //end each
|
| 261 |
|
|
|
| 262 |
|
|
return this.pushStack(jShadows);
|
| 263 |
|
|
};
|
| 264 |
|
|
|
| 265 |
|
|
|
| 266 |
|
|
$.fn.redrawShadow = function()
|
| 267 |
|
|
{
|
| 268 |
|
|
// Remove existing shadows
|
| 269 |
|
|
this.removeShadow();
|
| 270 |
|
|
|
| 271 |
|
|
// Draw new shadows
|
| 272 |
|
|
return this.each(function()
|
| 273 |
|
|
{
|
| 274 |
|
|
var shadowOptions = $.data(this, "shadowOptions");
|
| 275 |
|
|
$(this).dropShadow(shadowOptions);
|
| 276 |
|
|
});
|
| 277 |
|
|
};
|
| 278 |
|
|
|
| 279 |
|
|
|
| 280 |
|
|
$.fn.removeShadow = function()
|
| 281 |
|
|
{
|
| 282 |
|
|
return this.each(function()
|
| 283 |
|
|
{
|
| 284 |
|
|
var shadowId = $(this).shadowId();
|
| 285 |
|
|
$("div#" + shadowId).remove();
|
| 286 |
|
|
});
|
| 287 |
|
|
};
|
| 288 |
|
|
|
| 289 |
|
|
|
| 290 |
|
|
$.fn.shadowId = function()
|
| 291 |
|
|
{
|
| 292 |
|
|
return $.data(this[0], "shadowId");
|
| 293 |
|
|
};
|
| 294 |
|
|
|
| 295 |
|
|
|
| 296 |
|
|
$(function()
|
| 297 |
|
|
{
|
| 298 |
|
|
// Suppress printing of shadows
|
| 299 |
|
|
var noPrint = "<style type='text/css' media='print'>";
|
| 300 |
|
|
noPrint += ".dropShadow{visibility:hidden;}</style>";
|
| 301 |
|
|
$("head").append(noPrint);
|
| 302 |
|
|
});
|
| 303 |
|
|
|
| 304 |
|
|
})(jQuery);
|