@@ -211,6 +211,10 @@ facilitate the browser URL change and history management.
211
211
## Hashbang mode (default mode)
212
212
213
213
In this mode, `$location` uses Hashbang URLs in all browsers.
214
+ Angular also does not intercept and rewrite links in this mode. I.e. links work
215
+ as expected and also perform full page reloads when other parts of the url
216
+ than the hash fragment was changed.
217
+
214
218
215
219
### Example
216
220
@@ -250,6 +254,10 @@ having to worry about whether the browser displaying your app supports the histo
250
254
- Opening a regular URL in a legacy browser -> redirects to a hashbang URL
251
255
- Opening hashbang URL in a modern browser -> rewrites to a regular URL
252
256
257
+ Note that in this mode, Angular intercepts all links (subject to the "Html link rewriting" rules below)
258
+ and updates the url in a way that never performs a full page reload.
259
+
260
+
253
261
### Example
254
262
255
263
```js
@@ -298,8 +306,8 @@ history API or not; the `$location` service makes this transparent to you.
298
306
299
307
### Html link rewriting
300
308
301
- When you use HTML5 history API mode, you will need different links in different browsers, but all you
302
- have to do is specify regular URL links, such as: `<a href="/some?foo=bar">link</a>`
309
+ When you use HTML5 history API mode, you will not need special hashbang links. All you have to do
310
+ is specify regular URL links, such as: `<a href="/some?foo=bar">link</a>`
303
311
304
312
When a user clicks on this link,
305
313
@@ -314,17 +322,9 @@ reload to the original link.
314
322
Example: `<a href="/ext/link?a=b" target="_self">link</a>`
315
323
- Absolute links that go to a different domain<br>
316
324
Example: `<a href="http://angularjs.org/">link</a>`
317
- - Links starting with '/' that lead to a different base path when base is defined <br>
325
+ - Links starting with '/' that lead to a different base path<br>
318
326
Example: `<a href="/not-my-base/link">link</a>`
319
327
320
- When running Angular in the root of a domain, along side perhaps a normal application in the same
321
- directory, the "otherwise" route handler will try to handle all the URLs, including ones that map
322
- to static files.
323
-
324
- To prevent this, you can set your base href for the app to `<base href=".">` and then prefix links
325
- to URLs that should be handled with `.`. Now, links to locations, which are not to be routed by Angular,
326
- are not prefixed with `.` and will not be intercepted by the `otherwise` rule in your `$routeProvider`.
327
-
328
328
329
329
### Relative links
330
330
0 commit comments