angular.service.$location.html

<h1>angular.service.$location</h1>
<fieldset class="workInProgress"><legend>Work in Progress</legend>
This page is currently being revised. It might be incomplete or contain inaccuracies.</fieldset>
<h2>Description</h2>
<p>Parses the browser location url and makes it available to your application.
Any changes to the url are reflected into $location service and changes to
$location are reflected to url.
Notice that using browser's forward/back buttons changes the $location.</p><h2>Dependencies</h2>
<ul class="dependencies"><li>$browser</li>
</ul>
<h2>Methods</h2>
<ul class="methods"><li><h3>update(href)</h3>
<p>Update location object
Does not immediately update the browser
Browser is updated at the end of $eval()</p><h4>Parameters</h4>
<ul class="parameters"><li><code ng:non-bindable="">href – {(string|Object)} – </code>
Full href as a string or object with properties</li>
</ul>
<h4>Example</h4>
<div ng:non-bindable=""><pre class="brush: js; html-script: true;">scope.$location.update('http://www.angularjs.org/path#hash?search=x');
scope.$location.update({host: 'www.google.com', protocol: 'https'});
scope.$location.update({hashPath: '/path', hashSearch: {a: 'b', x: true}});</pre>
</div>
</li>
<li><h3>updateHash(path, search)</h3>
<p>Update location hash part</p><h4>Parameters</h4>
<ul class="parameters"><li><code ng:non-bindable="">path – {(string|Object)} – </code>
A hashPath or hashSearch object</li>
<li><code ng:non-bindable="">search<i>(optional)</i> – {Object} – </code>
A hashSearch object</li>
</ul>
<h4>Example</h4>
<div ng:non-bindable=""><pre class="brush: js; html-script: true;">scope.$location.updateHash('/hp')
  ==&gt; update({hashPath: '/hp'})

scope.$location.updateHash({a: true, b: 'val'})
  ==&gt; update({hashSearch: {a: true, b: 'val'}})

scope.$location.updateHash('/hp', {a: true})
  ==&gt; update({hashPath: '/hp', hashSearch: {a: true}})</pre>
</div>
</li>
</ul>
<h2>Properties</h2>
<ul class="properties"><li><h3>href</h3>
</li>
<li><h3>protocol</h3>
</li>
<li><h3>host</h3>
</li>
<li><h3>port</h3>
</li>
<li><h3>path</h3>
</li>
<li><h3>search</h3>
</li>
<li><h3>hash</h3>
</li>
<li><h3>hashPath</h3>
</li>
<li><h3>hashSearch</h3>
</li>
</ul>
<h2>Example</h2>
<doc:example><doc:source>&lt;a href="#"&gt;clear hash&lt;/a&gt; | 
&lt;a href="#myPath?name=misko"&gt;test hash&lt;/a&gt;&lt;br/&gt;
&lt;input type='text' name="$location.hash"/&gt;
&lt;pre&gt;$location = {{$location}}&lt;/pre&gt;</doc:source>
</doc:example>