Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(16)

Side by Side Diff: third_party/polymer/v0_8/components/iron-iconset-svg/iron-iconset-svg.html

Issue 1082403004: Import Polymer 0.8 and several key elements. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Also remove polymer/explainer Created 5 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
(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>
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698