ÿþ/*

jqURL

by Josh Nathanson



various manipulations on url strings and windows.  

all functions can also take a window object as an argument,

for example {win:opener}

but will default to current window if none is passed.



public functions:



-------------------------

.url({ 

	 win:window object 

	 })

-------------------------

returns the whole url string

like win.location.href



	so if the current window href is "http://www.mysite.com?var1=1&var2=2&var3=3"

	

	$.jqURL.url() returns "http://www.mysite.com?var1=1&var2=2&var3=3"

	

	

------------------------------

.loc(urlstr:string, 

	 { 

	 win:window object, 

	 w:integer, 

	 h:integer, 

	 t:integer,

	 l:integer,

	 wintype:string('_top'[default],'_blank','_parent') )

	})

------------------------------																			 

- directs passed in window to urlstr, which is required

- works like window.location.href = 'myurl'

- but you can also use it to pop open a new window by passing in "_blank" as the wintype

- if popping open a window, defaults to center of screen



	so

	$.jqURL.loc('http://www.google.com',

				{w:200,h:200,wintype:'_blank'});

	would open Google in a new centered 200x200 window

	

	or, locate an url to any named window:

	$.jqURL.loc('http://www.google.com',{ win:mywindow });

	opens Google in mywindow





------------------------------

.qs({ 

	ret:string('string'[default],'object'), 

	win:window object })

------------------------------

returns querystring, either string (pass ret:'string' [default])

or object (pass ret:'object') 



	so if the current window href is "http://www.mysite.com?var1=1&var2=2&var3=3"



	$.jqURL.qs();

	returns "var1=1&var2=2&var3=3"

	

	$.jqURL.qs({ ret:'object' });

	returns Object var1=1,var2=2,var3=3





------------------------------

.strip({ keys:string(list of keys to strip), win:window object })

------------------------------

if passed with no arguments, returns url with '?' and query string removed

if you pass in list of keys, it returns url with the specified key-value pairs removed



	so if the current window href is "http://www.mysite.com?var1=1&var2=2&var3=3"



	$.jqURL.strip();

	will return

	"http://www.mysite.com"

	

	$.jqURL.strip({ keys:'var1,var2' });

	will return

	"http://www.mysite.com?var3=3"

	

	

-------------------------------------

.get(key, {win:window object})

-------------------------------------

returns value of passed in querystring key



	so if the current window href is "http://www.mysite.com?var1=1&var2=2&var3=3"

	$.jqURL.get('var2');

	will return 2



--------------------------------------

.set(hash, {win:window object})

--------------------------------------

returns the window's url, but with the keys/values set in the query string

if the keys already exist, re-sets the value

if they don't exist, they're appended onto the query string



*/



jQuery.jqURL = {



	url : // returns a string

	function(args) {

		args = 

			jQuery.extend({

				win : window

			},

			args);

		return args.win.location.href;

	},

	

	loc : 

	function(urlstr, args) {

		args = 

			jQuery.extend({

				win : window,

				w : 500,

				h : 500,

				wintype : '_top'

			},

			args);

			

		if (!args.t) {

			args.t = screen.height / 2 - args.h / 2;

		}

		if (!args.l) {

			args.l = screen.width / 2 - args.w / 2;

		}

		if (args['wintype'] == '_top') {

			args.win.location.href = urlstr;

		}

		else {			

			open(

			urlstr,

			args['wintype'],

			'width=' + args.w + ',height=' + args.h + ',top=' + args.t + ',left=' + args.l + ',scrollbars,resizable'

			);

		

		}

		return;

	},

	

	qs :

	function(args) {

		args = jQuery.extend({

			ret : 'string',

			win : window

		},

		args);

		

		if (args['ret'] == 'string') {

			return jQuery.jqURL.url({ win:args.win }).split('?')[1];

			}



		else if (args['ret'] == 'object') {

			

			var qsobj = {};

			var thisqs = jQuery.jqURL.url({ win:args.win }).split('?')[1];

			

			if ( thisqs ) {

				var pairs = thisqs.split('&');

				for ( i=0;i<pairs.length;i++ ) {

					var pair = pairs[i].split('=');

					qsobj[pair[0]] = pair[1];

				}

			}

			return qsobj;

		}

	},

	

	strip :

	function(args) {

		args = jQuery.extend({

			keys : '',

			win : window

			},

			args);

		

		if (jQuery.jqURL.url().indexOf('?') == -1) { // no query string found

			return jQuery.jqURL.url({ win:args.win });

		}

		// if no keys passed in, just return url with no querystring

		else if (!args.keys) {

			return jQuery.jqURL.url({ win:args.win }).split('?')[0];

		}

		else { //return stripped url



			var qsobj = jQuery.jqURL.qs({ ret:'object',win:args.win });  // object with key/value pairs		

			var counter = 0;

			var url = jQuery.jqURL.url({ win:args.win }).split('?')[0] + '?';

			var amp = '';

			

			for (var key in qsobj) {

				if (args.keys.indexOf(key) == -1) { 

					// pass test, add this key/value to string

					amp = (counter) ? '&' : '';

					url = url + amp + key + '=' + qsobj[key];

					counter++;

				}

			}

			return url;

		}			

	},

	

	get :

	function(key,args) {

		args = jQuery.extend({

			win : window

			},args);

	

	qsobj =  jQuery.jqURL.qs({ ret:'object', win:args.win });

	return qsobj[key];

	},

	

	set :

	function(hash,args) {

		args = jQuery.extend({

			win : window

			},args);

		

		// get current querystring

		var qsobj =  jQuery.jqURL.qs({ ret:'object',win:args.win });

		

		// add/set values from hash

		for (var i in hash) {

			qsobj[i] = hash[i];

		}

		

		var qstring = '';

		var counter = 0;

		var amp = '';

		

		// turn qsobj into string

		for (var k in qsobj) {

			amp = (counter) ? '&' : '';

			qstring = qstring + amp + k + '=' + qsobj[k];

			counter++;

		}

		return jQuery.jqURL.strip({ win: args.win }) + '?' + qstring;

	}

	

};