PolymerElements/iron-location

Name: iron-location

Owner: PolymerElements

Description: A Polymer element that manages binding to the page's URL.

Created: 2015-10-19 20:52:59.0

Updated: 2018-05-08 15:16:11.0

Pushed: 2018-05-23 02:31:00.0

Homepage: null

Size: 245

Language: HTML

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Demo and API docs

Changes in 2.0

• URL Polyfill no longer a dependency. Small workaround implemented.

<iron-location>

The iron-location element manages binding to and from the current URL.

iron-location is the first, and lowest level element in the Polymer team's routing system. This is a beta release of iron-location as we continue work on higher level elements, and as such iron-location may undergo breaking changes.

Properties

When the URL is: /search?query=583#details iron-location's properties will be:

• path: '/search'
• query: 'query=583'
• hash: 'details'

These bindings are bidirectional. Modifying them will in turn modify the URL.

iron-location is only active while it is attached to the document.

Links

While iron-location is active in the document it will intercept clicks on links within your site, updating the URL pushing the updated URL out through the databinding system. iron-location only intercepts clicks with the intent to open in the same window, so middle mouse clicks and ctrl/cmd clicks work fine.

You can customize this behavior with the urlSpaceRegex.

Dwell Time

iron-location protects against accidental history spamming by only adding entries to the user's history if the URL stays unchanged for dwellTime milliseconds.