RubyGems - polymer-elements-rails - Versions diffs - 1.0.0.pre.rc.1 - Mend

polymer-elements-rails 1.0.0.pre.rc.1

Files changed (973) hide show

data/app/assets/components/iron-iconset-svg/test/index.html ADDED

@@ -0,0 +1,30 @@
+<!doctype html>
+<!--
+Copyright (c) 2015 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>
+  <meta charset="utf-8">
+  <title>Tests</title>
+  <script src="../../web-component-tester/browser.js"></script>
+</head>
+<body>
+  <script>
+    WCT.loadSuites([
+      'iron-iconset-svg.html'
+    ]);
+  </script>
+</body>
+</html>

data/app/assets/components/iron-iconset-svg/test/iron-iconset-svg.html ADDED

@@ -0,0 +1,107 @@
+<!doctype html>
+<!--
+@license
+Copyright (c) 2015 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>
+  <title>iron-iconset-svg</title>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <script src="../../webcomponentsjs/webcomponents-lite.js"></script>
+  <script src="../../web-component-tester/browser.js"></script>
+  <script src="../../test-fixture/test-fixture-mocha.js"></script>
+  <link rel="import" href="../iron-iconset-svg.html">
+  <link rel="import" href="../../iron-meta/iron-meta.html">
+  <link rel="import" href="../../test-fixture/test-fixture.html">
+</head>
+<body>
+  <test-fixture id="TrivialIconsetSvg">
+    <template>
+      <iron-iconset-svg name="foo"></iron-iconset-svg>
+      <iron-meta type="iconset"></iron-meta>
+    </template>
+  </test-fixture>
+  <test-fixture id="StandardIconsetSvg">
+    <template>
+      <iron-iconset-svg name="my-icons" size="20">
+        <svg>
+          <defs>
+            <circle id="circle" cx="20" cy="20" r="10"></circle>
+            <rect id="square" x="0" y="0" width="20" height="20"></rect>
+          </defs>
+        </svg>
+      </iron-iconset-svg>
+      <div></div>
+    </template>
+  </test-fixture>
+  <script>
+    suite('<iron-iconset>', function () {
+      suite('basic behavior', function () {
+        var iconset;
+        var meta;
+        setup(function () {
+          var elements = fixture('TrivialIconsetSvg');
+          iconset = elements[0];
+          meta = elements[1];
+        });
+        test('it can be accessed via iron-meta', function () {
+          expect(meta.byKey('foo')).to.be.equal(iconset);
+        });
+      });
+      suite('when paired with a size and SVG definition', function () {
+        var iconset;
+        var div;
+        setup(function () {
+          var elements = fixture('StandardIconsetSvg');
+          iconset = elements[0];
+          div = elements[1];
+        });
+        test('appends a child to the target element', function () {
+          expect(div.firstElementChild).to.not.be.ok;
+          iconset.applyIcon(div, 'circle');
+          expect(div.firstElementChild).to.be.ok;
+        });
+        test('can be queried for all available icons', function () {
+          expect(iconset.getIconNames()).to.deep.eql(['my-icons:circle', 'my-icons:square']);
+        });
+        test('supports any icon defined in the svg', function () {
+          var lastSvgIcon;
+          iconset.getIconNames().forEach(function (iconName) {
+            iconset.applyIcon(div, iconName.split(':').pop());
+            expect(div.firstElementChild).to.not.be.equal(lastSvgIcon);
+            lastSvgIcon = div.firstElementChild;
+          });
+        });
+      });
+    });
+  </script>
+</body>
+</html>

data/app/assets/components/iron-iconset/README.md ADDED

@@ -0,0 +1,51 @@
+iron-iconset
+============
+The `iron-iconset` element allows users to define their own icon sets.
+The `src` property specifies the url of the icon image. Multiple icons may
+be included in this image and they may be organized into rows.
+The `icons` property is a space separated list of names corresponding to the
+icons. The names must be ordered as the icons are ordered in the icon image.
+Icons are expected to be square and are the size specified by the `size`
+property. The `width` property corresponds to the width of the icon image
+and must be specified if icons are arranged into multiple rows in the image.
+All `iron-iconset` elements are available for use by other `iron-iconset`
+elements via a database keyed by id. Typically, an element author that wants
+to support a set of custom icons uses a `iron-iconset` to retrieve
+and use another, user-defined iconset.
+Example:
+```html
+<iron-iconset id="my-icons" src="my-icons.png" width="96" size="24"
+    icons="location place starta stopb bus car train walk">
+</iron-iconset>
+```
+This will automatically register the icon set "my-icons" to the iconset
+database.  To use these icons from within another element, make a
+`iron-iconset` element and call the `byId` method to retrieve a
+given iconset. To apply a particular icon to an element, use the
+`applyIcon` method. For example:
+```javascript
+iconset.applyIcon(iconNode, 'car');
+```
+Themed icon sets are also supported. The `iron-iconset` can contain child
+`property` elements that specify a theme with an offsetX and offsetY of the
+theme within the icon resource. For example.
+```html
+<iron-iconset id="my-icons" src="my-icons.png" width="96" size="24"
+    icons="location place starta stopb bus car train walk">
+  <property theme="special" offsetX="256" offsetY="24"></property>
+</iron-iconset>
+```
+Then a themed icon can be applied like this:
+```javascript
+iconset.applyIcon(iconNode, 'car', 'special');
+```

data/app/assets/components/iron-iconset/bower.json ADDED

@@ -0,0 +1,21 @@
+{
+  "name": "iron-iconset",
+  "version": "1.0.0",
+  "license": "http://polymer.github.io/LICENSE.txt",
+  "description": "Represents a set of icons",
+  "authors": [
+    "The Polymer Authors"
+  ],
+  "private": true,
+  "dependencies": {
+    "iron-meta": "PolymerElements/iron-meta#^1.0.0",
+    "polymer": "Polymer/polymer#^1.0.0"
+  },
+  "devDependencies": {
+    "iron-component-page": "polymerelements/iron-component-page#^1.0.0",
+    "iron-icon": "polymerelements/iron-icon#^1.0.0",
+    "test-fixture": "PolymerElements/test-fixture#^1.0.0",
+    "web-component-tester": "*",
+    "webcomponentsjs": "webcomponents/webcomponentsjs#^0.7.0"
+  }
+}

data/app/assets/components/iron-iconset/demo/index.html ADDED

@@ -0,0 +1,63 @@
+<!doctype html>
+<!--
+Copyright (c) 2015 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>
+  <title>iron-iconset</title>
+  <meta name="viewport" content="width=device-width, minimum-scale=1.0, initial-scale=1.0, user-scalable=yes">
+  <script src="../../webcomponentsjs/webcomponents-lite.js"></script>
+  <link rel="import" href="../iron-iconset.html">
+  <link rel="import" href="../../iron-icon/iron-icon.html">
+</head>
+<body>
+  <!-- Register an icon set; you can do this anywhere, including an HTMLImport! -->
+  <iron-iconset name="my-icons" src="my-icons.png" width="96" size="24"
+      icons="location place starta stopb bus car train walk">
+  </iron-iconset>
+  <iron-iconset name="my-icons-big" src="my-icons-big.png" width="192" size="48"
+      icons="location place starta stopb bus car train walk">
+  </iron-iconset>
+  <!-- Now create a bunch of icons using our iconset -->
+  <iron-icon icon="my-icons:location"></iron-icon>
+  <iron-icon icon="my-icons:place"></iron-icon>
+  <iron-icon icon="my-icons:starta"></iron-icon>
+  <iron-icon icon="my-icons:stopb"></iron-icon>
+  <iron-icon icon="my-icons:bus"></iron-icon>
+  <iron-icon icon="my-icons:car"></iron-icon>
+  <iron-icon icon="my-icons:train"></iron-icon>
+  <iron-icon icon="my-icons:walk"></iron-icon>
+  <br>
+  <!-- icons may also be specified by index -->
+  <style>
+    .embiggen iron-icon {
+      width: 48px;
+      height: 48px;
+    }
+  </style>
+  <div class="embiggen">
+    <iron-icon icon="my-icons-big:0"></iron-icon>
+    <iron-icon icon="my-icons-big:1"></iron-icon>
+    <iron-icon icon="my-icons-big:2"></iron-icon>
+    <iron-icon icon="my-icons-big:3"></iron-icon>
+    <iron-icon icon="my-icons-big:4"></iron-icon>
+    <iron-icon icon="my-icons-big:5"></iron-icon>
+    <iron-icon icon="my-icons-big:6"></iron-icon>
+    <iron-icon icon="my-icons-big:7"></iron-icon>
+  </div>
+ </body>
+</html>

data/app/assets/components/iron-iconset/demo/my-icons-big.png ADDED

Binary file

data/app/assets/components/iron-iconset/demo/my-icons.png ADDED

Binary file

data/app/assets/components/iron-iconset/index.html ADDED

@@ -0,0 +1,27 @@
+<!doctype html>
+<!--
+@license
+Copyright (c) 2015 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
+The complete set of authors may be found at http://polymer.github.io/AUTHORS
+The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS
+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
+-->
+<html>
+<head>
+  <title>iron-iconset</title>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, minimum-scale=1.0, initial-scale=1.0, user-scalable=yes">
+  <script src="../webcomponentsjs/webcomponents-lite.js"></script>
+  <link rel="import" href="../iron-component-page/iron-component-page.html">
+</head>
+<body>
+  <iron-component-page></iron-component-page>
+</body>
+</html>

data/app/assets/components/iron-iconset/iron-iconset.html ADDED

@@ -0,0 +1,336 @@
+<!--
+@license
+Copyright (c) 2015 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
+-->
+<link rel="import" href="../polymer/polymer.html">
+<link rel="import" href="../iron-meta/iron-meta.html">
+<!--
+The `iron-iconset` element allows users to define their own icon sets.
+The `src` property specifies the url of the icon image. Multiple icons may
+be included in this image and they may be organized into rows.
+The `icons` property is a space separated list of names corresponding to the
+icons. The names must be ordered as the icons are ordered in the icon image.
+Icons are expected to be square and are the size specified by the `size`
+property. The `width` property corresponds to the width of the icon image
+and must be specified if icons are arranged into multiple rows in the image.
+All `iron-iconset` elements are available for use by other `iron-iconset`
+elements via a database keyed by id. Typically, an element author that wants
+to support a set of custom icons uses a `iron-iconset` to retrieve
+and use another, user-defined iconset.
+Example:
+    <iron-iconset id="my-icons" src="my-icons.png" width="96" size="24"
+        icons="location place starta stopb bus car train walk">
+    </iron-iconset>
+This will automatically register the icon set "my-icons" to the iconset
+database.  To use these icons from within another element, make a
+`iron-iconset` element and call the `byId` method to retrieve a
+given iconset. To apply a particular icon to an element, use the
+`applyIcon` method. For example:
+    iconset.applyIcon(iconNode, 'car');
+Themed icon sets are also supported. The `iron-iconset` can contain child
+`property` elements that specify a theme with an offsetX and offsetY of the
+theme within the icon resource. For example.
+    <iron-iconset id="my-icons" src="my-icons.png" width="96" size="24"
+        icons="location place starta stopb bus car train walk">
+      <property theme="special" offsetX="256" offsetY="24"></property>
+    </iron-iconset>
+Then a themed icon can be applied like this:
+    iconset.applyIcon(iconNode, 'car', 'special');
+@element iron-iconset
+-->
+<script>
+  Polymer({
+    is: 'iron-iconset',
+    properties: {
+      /**
+       * The URL of the iconset image.
+       *
+       * @attribute src
+       * @type string
+       * @default ''
+       */
+      src: {
+        type: String,
+        observer: '_srcChanged'
+      },
+      /**
+       * The name of the iconset.
+       *
+       * @attribute name
+       * @type string
+       * @default 'no-name'
+       */
+      name: {
+        type: String,
+        observer: '_nameChanged'
+      },
+      /**
+       * The width of the iconset image. This must only be specified if the
+       * icons are arranged into separate rows inside the image.
+       *
+       * @attribute width
+       * @type number
+       * @default 0
+       */
+      width: {
+        type: Number,
+        value: 0
+      },
+      /**
+       * A space separated list of names corresponding to icons in the iconset
+       * image file. This list must be ordered the same as the icon images
+       * in the image file.
+       *
+       * @attribute icons
+       * @type string
+       * @default ''
+       */
+      icons: {
+        type: String
+      },
+      /**
+       * The size of an individual icon. Note that icons must be square.
+       *
+       * @attribute size
+       * @type number
+       * @default 24
+       */
+      size: {
+        type: Number,
+        value: 24
+      },
+      /**
+       * The horizontal offset of the icon images in the inconset src image.
+       * This is typically used if the image resource contains additional images
+       * beside those intended for the iconset.
+       *
+       * @attribute offset-x
+       * @type number
+       * @default 0
+       */
+      _offsetX: {
+        type: Number,
+        value: 0
+      },
+      /**
+       * The vertical offset of the icon images in the inconset src image.
+       * This is typically used if the image resource contains additional images
+       * beside those intended for the iconset.
+       *
+       * @attribute offset-y
+       * @type number
+       * @default 0
+       */
+      _offsetY: {
+        type: Number,
+        value: 0
+      },
+      /**
+       * Array of fully-qualified names of icons in this set.
+       */
+      iconNames: {
+        type: Array,
+        notify: true
+      }
+    },
+    hostAttributes: {
+      // non-visual
+      style: 'display: none;'
+    },
+    ready: function() {
+      // theme data must exist at ready-time
+      this._themes = this._mapThemes();
+    },
+    /**
+     * Applies an icon to the given element as a css background image. This
+     * method does not size the element, and it's usually necessary to set
+     * the element's height and width so that the background image is visible.
+     *
+     * @method applyIcon
+     * @param {Element} element The element to which the icon is applied.
+     * @param {String|Number} icon The name or index of the icon to apply.
+     * @param {String} theme (optional) The name or index of the icon to apply.
+     * @param {Number} scale (optional, defaults to 1) Icon scaling factor.
+     * @return {Element} The applied icon element.
+     */
+    applyIcon: function(element, icon, theme, scale) {
+      this._validateIconMap();
+      var offset = this._getThemedOffset(icon, theme);
+      if (element && offset) {
+        this._addIconStyles(element, this._srcUrl, offset, scale || 1,
+          this.size, this.width);
+      }
+    },
+    /**
+     * Remove an icon from the given element by undoing the changes effected
+     * by `applyIcon`.
+     *
+     * @param {Element} element The element from which the icon is removed.
+     */
+    removeIcon: function(element) {
+      this._removeIconStyles(element.style);
+    },
+    _mapThemes: function() {
+      var themes = Object.create(null);
+      Polymer.dom(this).querySelectorAll('property[theme]')
+        .forEach(function(property) {
+          var offsetX = window.parseInt(
+            property.getAttribute('offset-x'), 10
+          ) || 0;
+          var offsetY = window.parseInt(
+            property.getAttribute('offset-y'), 10
+          ) || 0;
+          themes[property.getAttribute('theme')] = {
+            offsetX: offsetX,
+            offsetY: offsetY
+          };
+        });
+      return themes;
+    },
+    _srcChanged: function(src) {
+      // ensure `srcUrl` is always relative to the main document
+      this._srcUrl = this.ownerDocument !== document
+        ? this.resolveUrl(src) : src;
+      this._prepareIconset();
+    },
+    _nameChanged: function(name) {
+      this._prepareIconset();
+    },
+    _prepareIconset: function() {
+      new Polymer.IronMeta({type: 'iconset', key: this.name, value: this});
+    },
+    _invalidateIconMap: function() {
+      this._iconMapValid = false;
+    },
+    _validateIconMap: function() {
+      if (!this._iconMapValid) {
+        this._recomputeIconMap();
+        this._iconMapValid = true;
+      }
+    },
+    _recomputeIconMap: function() {
+      this.iconNames = this._computeIconNames(this.icons);
+      this.iconMap = this._computeIconMap(this._offsetX, this._offsetY,
+        this.size, this.width, this.iconNames);
+    },
+    _computeIconNames: function(icons) {
+      return icons.split(/\s+/g);
+    },
+    _computeIconMap: function(offsetX, offsetY, size, width, iconNames) {
+      var iconMap = {};
+      if (offsetX !== undefined && offsetY !== undefined) {
+        var x0 = offsetX;
+        iconNames.forEach(function(iconName) {
+          iconMap[iconName] = {
+            offsetX: offsetX,
+            offsetY: offsetY
+          };
+          if ((offsetX + size) < width) {
+            offsetX += size;
+          } else {
+            offsetX = x0;
+            offsetY += size;
+          }
+        }, this);
+      }
+      return iconMap;
+    },
+    /**
+     * Returns an object containing `offsetX` and `offsetY` properties which
+     * specify the pixel location in the iconset's src file for the given
+     * `icon` and `theme`. It's uncommon to call this method. It is useful,
+     * for example, to manually position a css backgroundImage to the proper
+     * offset. It's more common to use the `applyIcon` method.
+     *
+     * @method getThemedOffset
+     * @param {String|Number} identifier The name of the icon or the index of
+     * the icon within in the icon image.
+     * @param {String} theme The name of the theme.
+     * @returns {Object} An object specifying the offset of the given icon
+     * within the icon resource file; `offsetX` is the horizontal offset and
+     * `offsetY` is the vertical offset. Both values are in pixel units.
+     */
+    _getThemedOffset: function(identifier, theme) {
+      var iconOffset = this._getIconOffset(identifier);
+      var themeOffset = this._themes[theme];
+      if (iconOffset && themeOffset) {
+        return {
+          offsetX: iconOffset.offsetX + themeOffset.offsetX,
+          offsetY: iconOffset.offsetY + themeOffset.offsetY
+        };
+      }
+      return iconOffset;
+    },
+    _getIconOffset: function(identifier) {
+      // TODO(sjmiles): consider creating offsetArray (indexed by Number)
+      // and having iconMap map names to indices, then and index is just
+      // iconMap[identifier] || identifier (be careful of zero, store indices
+      // as 1-based)
+      return this.iconMap[identifier] ||
+             this.iconMap[this.iconNames[Number(identifier)]];
+    },
+    _addIconStyles: function(element, url, offset, scale, size, width) {
+      var style = element.style;
+      style.backgroundImage = 'url(' + url + ')';
+      style.backgroundPosition =
+        (-offset.offsetX * scale + 'px') + ' ' +
+        (-offset.offsetY * scale + 'px');
+      style.backgroundSize = (scale === 1) ? 'auto' : width * scale + 'px';
+      style.width = size + 'px';
+      style.height = size + 'px';
+      element.setAttribute('role', 'img');
+    },
+    _removeIconStyles: function(style) {
+      style.background = '';
+    }
+  });
+</script>