OLD | NEW |
(Empty) | |
| 1 |
| 2 <!--- |
| 3 |
| 4 This README is automatically generated from the comments in these files: |
| 5 iron-page-url.html |
| 6 |
| 7 Edit those files, and our readme bot will duplicate them over here! |
| 8 Edit this file, and the bot will squash your changes :) |
| 9 |
| 10 --> |
| 11 |
| 12 [![Build Status](https://travis-ci.org/PolymerElements/iron-page-url.svg?branch=
master)](https://travis-ci.org/PolymerElements/iron-page-url) |
| 13 |
| 14 _[Demo and API Docs](https://elements.polymer-project.org/elements/iron-page-url
)_ |
| 15 |
| 16 |
| 17 ##<iron-page-url> |
| 18 |
| 19 |
| 20 |
| 21 The `iron-page-url` element manages binding to and from the current URL. |
| 22 |
| 23 iron-page-url is the first, and lowest level element in the Polymer team's |
| 24 routing system. This is a beta release of iron-page-url as we continue work |
| 25 on higher level elements, and as such iron-page-url may undergo breaking |
| 26 changes. |
| 27 |
| 28 #### Properties |
| 29 |
| 30 When the URL is: `/search?query=583#details` iron-page-url's properties will be: |
| 31 |
| 32 - path: `'/search'` |
| 33 - query: `'query=583'` |
| 34 - hash: `'details'` |
| 35 |
| 36 These bindings are bidirectional. Modifying them will in turn modify the URL. |
| 37 |
| 38 iron-page-url is only active while it is attached to the document. |
| 39 |
| 40 #### Links |
| 41 |
| 42 While iron-page-url is active in the document it will intercept clicks on links |
| 43 within your site, updating the URL pushing the updated URL out through the |
| 44 databinding system. iron-page-url only intercepts clicks with the intent to |
| 45 open in the same window, so middle mouse clicks and ctrl/cmd clicks work fine. |
| 46 |
| 47 You can customize this behavior with the `urlSpaceRegex`. |
| 48 |
| 49 #### Dwell Time |
| 50 |
| 51 iron-page-url protects against accidental history spamming by only adding |
| 52 entries to the user's history if the URL stays unchanged for `dwellTime` |
| 53 milliseconds. |
| 54 |
| 55 |
OLD | NEW |