OLD | NEW |
(Empty) | |
| 1 <!-- |
| 2 Copyright (c) 2015 The Polymer Project Authors. All rights reserved. |
| 3 This code may only be used under the BSD style license found at http://polymer.g
ithub.io/LICENSE.txt |
| 4 The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt |
| 5 The complete set of contributors may be found at http://polymer.github.io/CONTRI
BUTORS.txt |
| 6 Code distributed by Google as part of the polymer project is also |
| 7 subject to an additional IP rights grant found at http://polymer.github.io/PATEN
TS.txt |
| 8 --><!-- |
| 9 /** |
| 10 * @group Iron Elements |
| 11 * |
| 12 * The `iron-iconset` element allows users to define their own icon sets. |
| 13 * The `src` property specifies the url of the icon image. Multiple icons may |
| 14 * be included in this image and they may be organized into rows. |
| 15 * The `icons` property is a space separated list of names corresponding to the |
| 16 * icons. The names must be ordered as the icons are ordered in the icon image. |
| 17 * Icons are expected to be square and are the size specified by the `size` |
| 18 * property. The `width` property corresponds to the width of the icon image |
| 19 * and must be specified if icons are arranged into multiple rows in the image. |
| 20 * |
| 21 * All `iron-iconset` elements are available for use by other `iron-iconset` |
| 22 * elements via a database keyed by id. Typically, an element author that wants |
| 23 * to support a set of custom icons uses a `iron-iconset` to retrieve |
| 24 * and use another, user-defined iconset. |
| 25 * |
| 26 * Example: |
| 27 * |
| 28 * <iron-iconset id="my-icons" src="my-icons.png" width="96" size="24" |
| 29 * icons="location place starta stopb bus car train walk"> |
| 30 * </iron-iconset> |
| 31 * |
| 32 * This will automatically register the icon set "my-icons" to the iconset |
| 33 * database. To use these icons from within another element, make a |
| 34 * `iron-iconset` element and call the `byId` method to retrieve a |
| 35 * given iconset. To apply a particular icon to an element, use the |
| 36 * `applyIcon` method. For example: |
| 37 * |
| 38 * iconset.applyIcon(iconNode, 'car'); |
| 39 * |
| 40 * Themed icon sets are also supported. The `iron-iconset` can contain child |
| 41 * `property` elements that specify a theme with an offsetX and offsetY of the |
| 42 * theme within the icon resource. For example. |
| 43 * |
| 44 * <iron-iconset id="my-icons" src="my-icons.png" width="96" size="24" |
| 45 * icons="location place starta stopb bus car train walk"> |
| 46 * <property theme="special" offsetX="256" offsetY="24"></property> |
| 47 * </iron-iconset> |
| 48 * |
| 49 * Then a themed icon can be applied like this: |
| 50 * |
| 51 * iconset.applyIcon(iconNode, 'car', 'special'); |
| 52 * |
| 53 * @element iron-iconset |
| 54 */ |
| 55 --><html><head><link rel="import" href="../polymer/polymer.html"> |
| 56 <link rel="import" href="../iron-meta/iron-meta.html"> |
| 57 |
| 58 </head><body><script src="iron-iconset-extracted.js"></script></body></html> |
OLD | NEW |