Every time I turn around I run across yet another cool feature of Spry. I'm going to have to force myself to sit down and read the docs cover to cover because I'm sure there is a lot that I'm missing. Today's discover is the URL Utils library. As you can probably guess, this utility library helps you work with URLs.
There are two main functions you will use to examine URL variables: Spry.Utils.getLocationParamsAsObject and Spry.Utils.getLocationHashParamsAsObject. The first function grabs 'regular' URL parameters. Consider this URL:
http://www.raymondcamden.com/foo.cfm?paris=truediva&lindsey=lush
We can grab the URL parameters like so:
<script src="/spryjs/SpryURLUtils.js"></script>
<script>
var params = Spry.Utils.getLocationParamsAsObject();
alert(params.paris);
alert(params.lindsey);
alert(params.nicole);
</script>
<p>
This page left intentionally blank.
</p>
The first line of code loads the utility library. I then grab the parameters as an object. Once done, it acts just like using the URL scope in ColdFusion. As you can see - I alert each value, including a third one. If you run this code, and supply both URL parameters like I did above, you will get their values in the alerts, and an undefined string for the third test.
The getLocationHashParametersAsObject works with hash parameters in a URL, like so:
http://www.coldfusionjedi.com/index.cfm#ray=1
Using getLocationHasParametersAsObject would let me find the value of ray in the URL above.
Both of these functions work with the current URL. To supply a URL, you would use Spry.Utils.getURLParamsAsObject and Spry.Utils.getURLHashParamsAsObject.
Lastly, you can work with a partial URL string (like foo=1&goo=2) with the Spry.Utils.urlComponentToObject function.
So - what is a real use case for this? Where things get interesting is when you mix them with Spry Datasets. Because it is easy to introspect the URL, you can do things like presetting a row in the dataset based on URL parameters. (Don't forget Spry lets you run functions before and after a dataset has loaded.) For a good set of examples, see:
Using URL Parameters to Control Data Regions
The full documentation for this utility may be found here:
Thanks go to the use V1 Fusion and his forum post here.