| Index: third_party/polymer/v1_0/components-chromium/carbon-route/carbon-location.html
|
| diff --git a/third_party/polymer/v1_0/components-chromium/carbon-route/carbon-location.html b/third_party/polymer/v1_0/components-chromium/carbon-route/carbon-location.html
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..d5af13e1993f380f75f7132890e3e3a9267209e3
|
| --- /dev/null
|
| +++ b/third_party/polymer/v1_0/components-chromium/carbon-route/carbon-location.html
|
| @@ -0,0 +1,61 @@
|
| +<!--
|
| +@license
|
| +Copyright (c) 2016 The Polymer Project Authors. All rights reserved.
|
| +This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt
|
| +The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt
|
| +The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt
|
| +Code distributed by Google as part of the polymer project is also
|
| +subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt
|
| +--><html><head><link rel="import" href="../polymer/polymer.html">
|
| +<link rel="import" href="../iron-location/iron-location.html">
|
| +<link rel="import" href="../iron-location/iron-query-params.html">
|
| +<link rel="import" href="carbon-route-converter.html">
|
| +
|
| +<!--
|
| +`carbon-location` is an element that provides synchronization between the
|
| +browser location bar and the state of an app. When created, `carbon-location`
|
| +elements will automatically watch the global location for changes. As changes
|
| +occur, `carbon-location` produces and updates an object called `route`. This
|
| +`route` object is suitable for passing into a `carbon-route`, and other similar
|
| +elements.
|
| +
|
| +An example of a route object that describes the URL
|
| +`https://elements.polymer-project.org/elements/carbon-route-converter?foo=bar&baz=qux`:
|
| +
|
| + {
|
| + prefix: '',
|
| + path: '/elements/carbon-route-converter'
|
| + }
|
| +
|
| +Example Usage:
|
| +
|
| + <carbon-location route="{{route}}"></carbon-location>
|
| + <carbon-route route="{{route}}" pattern="/:page" data="{{data}}"></carbon-route>
|
| +
|
| +As you can see above, the `carbon-location` element produces a `route` and that
|
| +property is then bound into the `carbon-route` element. The bindings are two-
|
| +directional, so when changes to the `route` object occur within `carbon-route`,
|
| +they automatically reflect back to the global location.
|
| +
|
| +A `carbon-location` can be configured to use the hash part of a URL as the
|
| +canonical source for path information.
|
| +
|
| +Example:
|
| +
|
| + <carbon-location route="{{route}}" use-hash-as-path></carbon-location>
|
| +
|
| +@element carbon-location
|
| +@demo demo/index.html
|
| +-->
|
| +
|
| +</head><body><dom-module id="carbon-location">
|
| + <template>
|
| + <iron-location path="{{__path}}" query="{{__query}}" hash="{{__hash}}" url-space-regex="{{urlSpaceRegex}}">
|
| + </iron-location>
|
| + <iron-query-params params-string="{{__query}}" params-object="{{__queryParams}}">
|
| + </iron-query-params>
|
| + <carbon-route-converter on-path-changed="__onPathChanged" path="[[__computeRoutePath(__path, __hash, useHashAsPath)]]" query-params="{{__queryParams}}" route="{{route}}">
|
| + </carbon-route-converter>
|
| + </template>
|
| + </dom-module>
|
| +<script src="carbon-location-extracted.js"></script></body></html>
|
|
|