extranet/www/dashboard/js/jquery.positionBy.js
2009-05-25 16:23:19 +00:00

307 lines
8.4 KiB
JavaScript

/*
* positionBy 1.0.7 (2008-01-29)
*
* Copyright (c) 2006,2007 Jonathan Sharp (http://jdsharp.us)
* Dual licensed under the MIT (MIT-LICENSE.txt)
* and GPL (GPL-LICENSE.txt) licenses.
*
* http://jdsharp.us/
*
* Built upon jQuery 1.2.2 (http://jquery.com)
* This also requires the jQuery dimensions plugin
*/
(function($){
/**
* This function centers an absolutely positioned element
*/
/*
$.fn.positionCenter = function(offsetLeft, offsetTop) {
var offsetLeft = offsetLeft || 1;
var offsetTop = offsetTop || 1;
var ww = $(window).width();
var wh = $(window).height();
var sl = $(window).scrollLeft();
var st = $(window).scrollTop();
return this.each(function() {
var $t = $(this);
// If we are not visible we have to display our element (with a negative position offscreen)
var left = Math.round( ( ww - $t.outerWidth() ) / 2 );
if ( left < 0 ) {
left = 0;
} else {
left *= offsetLeft;
}
left += sl;
var top = Math.round( ( wh - $t.outerHeight() ) / 2 );
if ( top < 0 ) {
top = 0;
} else {
top *= offsetTop;
}
top += st;
$(this).parents().each(function() {
var $this = $(this);
if ( $this.css('position') != 'static' ) {
var o = $this.offset();
left += -o.left;
top += -o.top;
return false;
}
});
$t.css({left: left, top: top});
});
};
*/
// Our range object is used in calculating positions
var Range = function(x1, y1, x2, y2) {
this.x1 = x1; this.x2 = x2;
this.y1 = y1; this.y2 = y2;
};
Range.prototype.contains = function(range) {
return (this.x1 <= range.x1 && range.x2 <= this.x2)
&&
(this.y1 <= range.y1 && range.y2 <= this.y2);
};
Range.prototype.transform = function(x, y) {
return new Range(this.x1 + x, this.y1 + y, this.x2 + x, this.y2 + y);
};
$.fn.positionBy = function(args) {
var date1 = new Date();
if ( this.length == 0 ) {
return this;
}
var args = $.extend({ // The target element to position us relative to
target: null,
// The target's corner, possible values 0-3
targetPos: null,
// The element's corner, possible values 0-3
elementPos: null,
// A raw x,y coordinate
x: null,
y: null,
// Pass in an array of positions that are valid 0-15
positions: null,
// Add the final position class to the element (eg. positionBy0 through positionBy3, positionBy15)
addClass: false,
// Force our element to be at the location we specified (don't try to auto position it)
force: false,
// The element that we will make sure our element doesn't go outside of
container: window,
// Should the element be hidden after positioning?
hideAfterPosition: false
}, args);
if ( args.x != null ) {
var tLeft = args.x;
var tTop = args.y;
var tWidth = 0;
var tHeight = 0;
// Position in relation to an element
} else {
var $target = $( $( args.target )[0] );
var tWidth = $target.outerWidth();
var tHeight = $target.outerHeight();
var tOffset = $target.offset();
var tLeft = tOffset.left;
var tTop = tOffset.top;
}
// Our target right, bottom coord
var tRight = tLeft + tWidth;
var tBottom = tTop + tHeight;
return this.each(function() {
var $element = $( this );
// Position our element in the top left so we can grab its width without triggering scrollbars
if ( !$element.is(':visible') ) {
$element.css({ left: -3000,
top: -3000
})
.show();
}
var eWidth = $element.outerWidth();
var eHeight = $element.outerHeight();
// Holds x1,y1,x2,y2 coordinates for a position in relation to our target element
var position = [];
// Holds a list of alternate positions to try if this one is not in the browser viewport
var next = [];
// Our Positions via ASCII ART
/*
8 9 10 11
+------------+
7 | 15 12 | 0
| |
6 | 14 13 | 1
+------------+
5 4 3 2
*/
position[0] = new Range(tRight, tTop, tRight + eWidth, tTop + eHeight);
next[0] = [1,7,4];
position[1] = new Range(tRight, tBottom - eHeight, tRight + eWidth, tBottom);
next[1] = [0,6,4];
position[2] = new Range(tRight, tBottom, tRight + eWidth, tBottom + eHeight);
next[2] = [1,3,10];
position[3] = new Range(tRight - eWidth, tBottom, tRight, tBottom + eHeight);
next[3] = [1,6,10];
position[4] = new Range(tLeft, tBottom, tLeft + eWidth, tBottom + eHeight);
next[4] = [1,6,9];
position[5] = new Range(tLeft - eWidth, tBottom, tLeft, tBottom + eHeight);
next[5] = [6,4,9];
position[6] = new Range(tLeft - eWidth, tBottom - eHeight, tLeft, tBottom);
next[6] = [7,1,4];
position[7] = new Range(tLeft - eWidth, tTop, tLeft, tTop + eHeight);
next[7] = [6,0,4];
position[8] = new Range(tLeft - eWidth, tTop - eHeight, tLeft, tTop);
next[8] = [7,9,4];
position[9] = new Range(tLeft, tTop - eHeight, tLeft + eWidth, tTop);
next[9] = [0,7,4];
position[10]= new Range(tRight - eWidth, tTop - eHeight, tRight, tTop);
next[10] = [0,7,3];
position[11]= new Range(tRight, tTop - eHeight, tRight + eWidth, tTop);
next[11] = [0,10,3];
position[12]= new Range(tRight - eWidth, tTop, tRight, tTop + eHeight);
next[12] = [13,7,10];
position[13]= new Range(tRight - eWidth, tBottom - eHeight, tRight, tBottom);
next[13] = [12,6,3];
position[14]= new Range(tLeft, tBottom - eHeight, tLeft + eWidth, tBottom);
next[14] = [15,1,4];
position[15]= new Range(tLeft, tTop, tLeft + eWidth, tTop + eHeight);
next[15] = [14,0,9];
if ( args.positions !== null ) {
var pos = args.positions[0];
} else if ( args.targetPos != null && args.elementPos != null ) {
var pos = [];
pos[0] = [];
pos[0][0] = 15;
pos[0][1] = 7;
pos[0][2] = 8;
pos[0][3] = 9;
pos[1] = [];
pos[1][0] = 0;
pos[1][1] = 12;
pos[1][2] = 10;
pos[1][3] = 11;
pos[2] = [];
pos[2][0] = 2;
pos[2][1] = 3;
pos[2][2] = 13;
pos[2][3] = 1;
pos[3] = [];
pos[3][0] = 4;
pos[3][1] = 5;
pos[3][2] = 6;
pos[3][3] = 14;
var pos = pos[args.targetPos][args.elementPos];
}
var ePos = position[pos];
var fPos = pos;
if ( !args.force ) {
// TODO: Do the args.container
// window width & scroll offset
$window = $( window );
var sx = $window.scrollLeft();
var sy = $window.scrollTop();
// TODO: Look at innerWidth & innerHeight
var container = new Range( sx, sy, sx + $window.width(), sy + $window.height() );
// If we are outside of our viewport, see if we are outside vertically or horizontally and push onto the stack
var stack;
if ( args.positions ) {
stack = args.positions;
} else {
stack = [pos];
}
var test = []; // Keeps track of our positions we already tried
while ( stack.length > 0 ) {
var p = stack.shift();
if ( test[p] ) {
continue;
}
test[p] = true;
// If our current position is not within the viewport (eg. window)
// add the next suggested position
if ( !container.contains(position[p]) ) {
if ( args.positions === null ) {
stack = jQuery.merge( stack, next[p] );
}
} else {
ePos = position[p];
break;
}
}
}
// + TODO: Determine if we are going to use absolute left, top, bottom, right
// positions relative to our target
// Take into account any absolute or fixed positioning
// to 'normalize' our coordinates
$element.parents().each(function() {
var $this = $(this);
if ( $this.css('position') != 'static' ) {
var abs = $this.offset();
ePos = ePos.transform( -abs.left, -abs.top );
return false;
}
});
// Finally position our element
var css = { left: ePos.x1, top: ePos.y1 };
if ( args.hideAfterPosition ) {
css['display'] = 'none';
}
$element.css( css );
if ( args.addClass ) {
$element.removeClass( 'positionBy0 positionBy1 positionBy2 positionBy3 positionBy4 positionBy5 '
+ 'positionBy6 positionBy7 positionBy8 positionBy9 positionBy10 positionBy11 '
+ 'positionBy12 positionBy13 positionBy14 positionBy15')
.addClass('positionBy' + p);
}
});
};
})(jQuery);