123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174 |
- // JQuery URL Parser
- // Written by Mark Perkins, mark@allmarkedup.com
- // License: http://unlicense.org/ (i.e. do what you want with it!)
- jQuery.url = function()
- {
- var segments = {};
-
- var parsed = {};
-
- /**
- * Options object. Only the URI and strictMode values can be changed via the setters below.
- */
- var options = {
-
- url : window.location, // default URI is the page in which the script is running
-
- strictMode: false, // 'loose' parsing by default
-
- key: ["source","protocol","authority","userInfo","user","password","host","port","relative","path","directory","file","query","anchor"], // keys available to query
-
- q: {
- name: "queryKey",
- parser: /(?:^|&)([^&=]*)=?([^&]*)/g
- },
-
- parser: {
- strict: /^(?:([^:\/?#]+):)?(?:\/\/((?:(([^:@]*):?([^:@]*))?@)?([^:\/?#]*)(?::(\d*))?))?((((?:[^?#\/]*\/)*)([^?#]*))(?:\?([^#]*))?(?:#(.*))?)/, //less intuitive, more accurate to the specs
- loose: /^(?:(?![^:@]+:[^:@\/]*@)([^:\/?#.]+):)?(?:\/\/)?((?:(([^:@]*):?([^:@]*))?@)?([^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/ // more intuitive, fails on relative paths and deviates from specs
- }
-
- };
-
- /**
- * Deals with the parsing of the URI according to the regex above.
- * Written by Steven Levithan - see credits at top.
- */
- var parseUri = function()
- {
- str = decodeURI( options.url );
-
- var m = options.parser[ options.strictMode ? "strict" : "loose" ].exec( str );
- var uri = {};
- var i = 14;
- while ( i-- ) {
- uri[ options.key[i] ] = m[i] || "";
- }
- uri[ options.q.name ] = {};
- uri[ options.key[12] ].replace( options.q.parser, function ( $0, $1, $2 ) {
- if ($1) {
- uri[options.q.name][$1] = $2;
- }
- });
- return uri;
- };
- /**
- * Returns the value of the passed in key from the parsed URI.
- *
- * @param string key The key whose value is required
- */
- var key = function( key )
- {
- if ( jQuery.isEmptyObject(parsed) )
- {
- setUp(); // if the URI has not been parsed yet then do this first...
- }
- if ( key == "base" )
- {
- if ( parsed.port !== null && parsed.port !== "" )
- {
- return parsed.protocol+"://"+parsed.host+":"+parsed.port+"/";
- }
- else
- {
- return parsed.protocol+"://"+parsed.host+"/";
- }
- }
-
- return ( parsed[key] === "" ) ? null : parsed[key];
- };
-
- /**
- * Returns the value of the required query string parameter.
- *
- * @param string item The parameter whose value is required
- */
- var param = function( item )
- {
- if ( jQuery.isEmptyObject(parsed) )
- {
- setUp(); // if the URI has not been parsed yet then do this first...
- }
- return ( parsed.queryKey[item] === null ) ? null : parsed.queryKey[item];
- };
- /**
- * 'Constructor' (not really!) function.
- * Called whenever the URI changes to kick off re-parsing of the URI and splitting it up into segments.
- */
- var setUp = function()
- {
- parsed = parseUri();
-
- getSegments();
- };
-
- /**
- * Splits up the body of the URI into segments (i.e. sections delimited by '/')
- */
- var getSegments = function()
- {
- var p = parsed.path;
- segments = []; // clear out segments array
- segments = parsed.path.length == 1 ? {} : ( p.charAt( p.length - 1 ) == "/" ? p.substring( 1, p.length - 1 ) : path = p.substring( 1 ) ).split("/");
- };
-
- return {
-
- /**
- * Sets the parsing mode - either strict or loose. Set to loose by default.
- *
- * @param string mode The mode to set the parser to. Anything apart from a value of 'strict' will set it to loose!
- */
- setMode : function( mode )
- {
- options.strictMode = mode == "strict" ? true : false;
- return this;
- },
-
- /**
- * Sets URI to parse if you don't want to to parse the current page's URI.
- * Calling the function with no value for newUri resets it to the current page's URI.
- *
- * @param string newUri The URI to parse.
- */
- setUrl : function( newUri )
- {
- options.url = newUri === undefined ? window.location : newUri;
- setUp();
- return this;
- },
-
- /**
- * Returns the value of the specified URI segment. Segments are numbered from 1 to the number of segments.
- * For example the URI http://test.com/about/company/ segment(1) would return 'about'.
- *
- * If no integer is passed into the function it returns the number of segments in the URI.
- *
- * @param int pos The position of the segment to return. Can be empty.
- */
- segment : function( pos )
- {
- if ( jQuery.isEmptyObject(parsed) )
- {
- setUp(); // if the URI has not been parsed yet then do this first...
- }
- if ( pos === undefined )
- {
- return segments.length;
- }
- return ( segments[pos] === "" || segments[pos] === undefined ) ? null : segments[pos];
- },
-
- attr : key, // provides public access to private 'key' function - see above
-
- param : param // provides public access to private 'param' function - see above
-
- };
-
- }();
|