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 <!-- |
| 11 /** |
| 12 * @group Iron Elements |
| 13 * |
| 14 * The `iron-iconset-svg` element allows users to define their own icon sets |
| 15 * that contain svg icons. The svg icon elements should be children of the |
| 16 * `iron-iconset-svg` element. Multiple icons should be given distinct id's. |
| 17 * |
| 18 * Using svg elements to create icons has a few advantages over traditional |
| 19 * bitmap graphics like jpg or png. Icons that use svg are vector based so they |
| 20 * are resolution independent and should look good on any device. They are |
| 21 * stylable via css. Icons can be themed, colorized, and even animated. |
| 22 * |
| 23 * Example: |
| 24 * |
| 25 * <iron-iconset-svg id="my-svg-icons" iconSize="24"> |
| 26 * <svg> |
| 27 * <defs> |
| 28 * <g id="shape"> |
| 29 * <rect x="50" y="50" width="50" height="50" /> |
| 30 * <circle cx="50" cy="50" r="50" /> |
| 31 * </g> |
| 32 * </defs> |
| 33 * </svg> |
| 34 * </iron-iconset-svg> |
| 35 * |
| 36 * This will automatically register the icon set "my-svg-icons" to the iconset |
| 37 * database. To use these icons from within another element, make a |
| 38 * `iron-iconset` element and call the `byId` method |
| 39 * to retrieve a given iconset. To apply a particular icon inside an |
| 40 * element use the `applyIcon` method. For example: |
| 41 * |
| 42 * iconset.applyIcon(iconNode, 'car'); |
| 43 * |
| 44 * @element iron-iconset-svg |
| 45 */ |
| 46 --> |
| 47 |
| 48 <link rel="import" href="../polymer/polymer.html"> |
| 49 |
| 50 <script> |
| 51 |
| 52 Polymer({ |
| 53 |
| 54 is: 'iron-iconset-svg', |
| 55 |
| 56 properties: { |
| 57 |
| 58 /** |
| 59 * The name of the iconset. |
| 60 * |
| 61 * @attribute name |
| 62 * @type string |
| 63 * @default '' |
| 64 */ |
| 65 name: { |
| 66 type: String, |
| 67 observer: '_nameChanged' |
| 68 }, |
| 69 |
| 70 /** |
| 71 * Array of fully-qualitifed icon names in the iconset. |
| 72 */ |
| 73 iconNames: { |
| 74 type: Array, |
| 75 notify: true |
| 76 }, |
| 77 |
| 78 /** |
| 79 * The size of an individual icon. Note that icons must be square. |
| 80 * |
| 81 * @attribute iconSize |
| 82 * @type number |
| 83 * @default 24 |
| 84 */ |
| 85 size: { |
| 86 type: Number, |
| 87 value: 24 |
| 88 } |
| 89 |
| 90 }, |
| 91 |
| 92 /** |
| 93 * Applies an icon to the given element. |
| 94 * |
| 95 * An svg icon is prepended to the element's shadowRoot if it exists, |
| 96 * otherwise to the element itself. |
| 97 * |
| 98 * @method applyIcon |
| 99 * @param {Element} element Element to which the icon is applied. |
| 100 * @param {String} icon Name of the icon to apply. |
| 101 * @return {Element} The svg element which renders the icon. |
| 102 */ |
| 103 applyIcon: function(element, iconName) { |
| 104 // insert svg element into shadow root, if it exists |
| 105 element = element.root || element; |
| 106 // Remove old svg element |
| 107 this.removeIcon(element); |
| 108 // install new svg element |
| 109 var svg = this._cloneIcon(iconName); |
| 110 if (svg) { |
| 111 // TODO(sjmiles): I know, `with` is the devil ... except it isn't |
| 112 with (Polymer.dom(element)) { |
| 113 insertBefore(svg, childNodes[0]); |
| 114 } |
| 115 return element._svgIcon = svg; |
| 116 } |
| 117 }, |
| 118 |
| 119 /** |
| 120 * Remove an icon from the given element by undoing the changes effected |
| 121 * by `applyIcon`. |
| 122 * |
| 123 * @param {Element} element The element from which the icon is removed. |
| 124 */ |
| 125 removeIcon: function(element) { |
| 126 // Remove old svg element |
| 127 if (element._svgIcon) { |
| 128 Polymer.dom(element).removeChild(element._svgIcon); |
| 129 element._svgIcon = null; |
| 130 } |
| 131 }, |
| 132 |
| 133 /** |
| 134 * |
| 135 * When name is changed, either register a new iconset with the included |
| 136 * icons, or if there are no children, set up a meta-iconset. |
| 137 * |
| 138 */ |
| 139 _nameChanged: function() { |
| 140 new Polymer.IronMeta({type: 'iconset', key: this.name, value: this}); |
| 141 // icons (descendents) must exist a-priori |
| 142 this._icons = this._createIconMap(); |
| 143 this.iconNames = this._getIconNames(); |
| 144 }, |
| 145 |
| 146 /** |
| 147 * Array of all icon names in this iconset. |
| 148 * |
| 149 * @return {Array} Array of icon names. |
| 150 */ |
| 151 _getIconNames: function() { |
| 152 return Object.keys(this._icons).map(function(n) { |
| 153 return this.name + ':' + n; |
| 154 }, this); |
| 155 }, |
| 156 |
| 157 /** |
| 158 * Create a map of child SVG elements by id. |
| 159 * |
| 160 * @return {Object} Map of id's to SVG elements. |
| 161 */ |
| 162 _createIconMap: function() { |
| 163 // Objects chained to Object.prototype (`{}`) have members. Specifically, |
| 164 // on FF there is a `watch` method that confuses the icon map, so we |
| 165 // need to use a null-based object here. |
| 166 var icons = Object.create(null); |
| 167 Polymer.dom(this).querySelectorAll('[id]') |
| 168 .forEach(function(icon) { |
| 169 icons[icon.id] = icon; |
| 170 }); |
| 171 return icons; |
| 172 }, |
| 173 |
| 174 /** |
| 175 * Produce installable clone of the SVG element matching `id` in this |
| 176 * iconset, or `undefined` if there is no matching element. |
| 177 * |
| 178 * @return {Object} Returns an installable clone of the SVG element |
| 179 * matching `id`. |
| 180 */ |
| 181 _cloneIcon: function(id) { |
| 182 return this._prepareSvgClone(this._icons[id], this.size); |
| 183 }, |
| 184 |
| 185 _prepareSvgClone: function(sourceSvg, size) { |
| 186 if (sourceSvg) { |
| 187 var svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg'); |
| 188 svg.setAttribute('viewBox', ['0', '0', size, size].join(' ')); |
| 189 svg.setAttribute('preserveAspectRatio', 'xMidYMid meet'); |
| 190 // TODO(dfreedm): `pointer-events: none` works around https://crbug.com/
370136 |
| 191 // TODO(sjmiles): inline style may not be ideal, but avoids requiring a
shadow-root |
| 192 svg.style.cssText = 'pointer-events: none; display: block; width: 100%;
height: 100%;'; |
| 193 svg.appendChild(sourceSvg.cloneNode(true)).removeAttribute('id'); |
| 194 return svg; |
| 195 } |
| 196 } |
| 197 |
| 198 }); |
| 199 </script> |
OLD | NEW |