diff --git a/docs/content/guide/$location.ngdoc b/docs/content/guide/$location.ngdoc index 241bed03f2fe..78b1ae957571 100644 --- a/docs/content/guide/$location.ngdoc +++ b/docs/content/guide/$location.ngdoc @@ -210,6 +210,10 @@ facilitate the browser URL change and history management. ## Hashbang mode (default mode) In this mode, `$location` uses Hashbang URLs in all browsers. +Angular also does not intercept and rewrite links in this mode. I.e. links work +as expected and also perform full page reloads when other parts of the url +than the hash fragment was changed. + ### Example @@ -249,6 +253,10 @@ having to worry about whether the browser displaying your app supports the histo - Opening a regular URL in a legacy browser -> redirects to a hashbang URL - Opening hashbang URL in a modern browser -> rewrites to a regular URL +Note that in this mode, Angular intercepts all links and updates the url in a way +that never performs a full page reload (see "Html link rewriting" below). + + ### Example ```js @@ -297,7 +305,7 @@ history API or not; the `$location` service makes this transparent to you. ### Html link rewriting -When you use HTML5 history API mode, you will need different links in different browsers, but all you +When you use HTML5 history API mode, you will not need different links in different browsers, but all you have to do is specify regular URL links, such as: `link` When a user clicks on this link, @@ -313,17 +321,9 @@ reload to the original link. Example: `link` - Absolute links that go to a different domain
Example: `link` -- Links starting with '/' that lead to a different base path when base is defined
+- Links starting with '/' that lead to a different base path
Example: `link` -When running Angular in the root of a domain, along side perhaps a normal application in the same -directory, the "otherwise" route handler will try to handle all the URLs, including ones that map -to static files. - -To prevent this, you can set your base href for the app to `` and then prefix links -to URLs that should be handled with `.`. Now, links to locations, which are not to be routed by Angular, -are not prefixed with `.` and will not be intercepted by the `otherwise` rule in your `$routeProvider`. - ### Relative links