polymer-paper-rails 0.2.6 → 1.0.0.pre.rc.1

data/app/assets/components/paper-spinner/paper-spinner.html

@@ -1,157 +1,222 @@
 <!--
-    @license
-    Copyright (c) 2014 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
+@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="../paper-styles/color.html">
+<link rel="import" href="../iron-flex-layout/iron-flex-layout.html">
 
 <!--
 Element providing material design circular spinner.
 
-##### Example
-
     <paper-spinner active></paper-spinner>
 
-The default spinner cycles between blue, red, yellow and green. It can be customized so
-that it uses one color only.
+The default spinner cycles between four layers of colors; by default they are
+blue, red, yellow and green. It can be customized so that it uses one color only
+by setting all the layer colors to the same value.
 
-##### Example
-
-    <style shim-shadowdom>
-      paper-spinner.blue::shadow .circle {
-        border-color: #4285f4;
-      }
-    </style>
-
-    <paper-spinner class="blue" active></paper-spinner>
+### Accessibility
 
 Alt attribute should be set to provide adequate context for accessibility. If not provided,
 it defaults to 'loading'.
 Empty alt can be provided to mark the element as decorative if alternative content is provided
 in another form (e.g. a text block following the spinner).
 
-##### Example
-  <paper-spinner alt="Loading contacts list" active></paper-spinner>
+    <paper-spinner alt="Loading contacts list" active></paper-spinner>
+
+### Styling
+
+The following custom properties and mixins are available for styling:
 
+Custom property | Description | Default
+----------------|-------------|----------
+`--paper-spinner-layer-1-color` | Color of the first spinner rotation | `--google-blue-500`
+`--paper-spinner-layer-2-color` | Color of the second spinner rotation | `--google-red-500`
+`--paper-spinner-layer-3-color` | Color of the third spinner rotation | `--google-yellow-500`
+`--paper-spinner-layer-4-color` | Color of the fourth spinner rotation | `--google-green-500`
+
+@group Paper Elements
 @element paper-spinner
-@blurb Element providing material design circular spinner.
-@status alpha
-@homepage http://polymerlabs.github.io/paper-spinner
+@hero hero.svg
+@demo demo/index.html
 -->
 
-<polymer-element name="paper-spinner" attributes="active alt" role="progressbar">
+<dom-module id="paper-spinner">
+
+  <link rel="import" type="css" href="paper-spinner.css">
+
   <template>
-    <link rel="stylesheet" href="paper-spinner.css">
 
-    <div id="spinnerContainer">
-      <div class="spinner-layer blue">
+    <div id="spinnerContainer" class-name="[[_spinnerContainerClassName]]">
+      <div class="spinner-layer layer-1">
         <div class="circle-clipper left">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="gap-patch">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="circle-clipper right">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div>
       </div>
 
-      <div class="spinner-layer red">
+      <div class="spinner-layer layer-2">
         <div class="circle-clipper left">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="gap-patch">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="circle-clipper right">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div>
       </div>
 
-      <div class="spinner-layer yellow">
+      <div class="spinner-layer layer-3">
         <div class="circle-clipper left">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="gap-patch">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="circle-clipper right">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div>
       </div>
 
-      <div class="spinner-layer green">
+      <div class="spinner-layer layer-4">
         <div class="circle-clipper left">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="gap-patch">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div><div class="circle-clipper right">
-          <div class="circle" fit></div>
+          <div class="circle"></div>
         </div>
       </div>
     </div>
+
   </template>
 
   <script>
-    Polymer({
-      eventDelegates: {
-        'animationend': 'reset',
-        'webkitAnimationEnd': 'reset'
-      },
-      publish: {
-        /**
-         * Displays the spinner.
-         *
-         * @attribute active
-         * @type boolean
-         * @default false
-         */
-        active: {value: false, reflect: true},
-
-        /**
-         * Alternative text content for accessibility support.
-         * If alt is present, it will add an aria-label whose content matches alt when active.
-         * If alt is not present, it will default to 'loading' as the alt value.
-         * @attribute alt
-         * @type string
-         * @default 'loading'
-         */
-        alt: {value: 'loading', reflect: true}
-      },
-
-      ready: function() {
-        // Allow user-provided `aria-label` take preference to any other text alternative.
-        if (this.hasAttribute('aria-label')) {
-          this.alt = this.getAttribute('aria-label');
-        } else {
-          this.setAttribute('aria-label', this.alt);
-        }
-        if (!this.active) {
-          this.setAttribute('aria-hidden', 'true');
-        }
-      },
-
-      activeChanged: function() {
-        if (this.active) {
-          this.$.spinnerContainer.classList.remove('cooldown');
-          this.$.spinnerContainer.classList.add('active');
-          this.removeAttribute('aria-hidden');
-        } else {
-          this.$.spinnerContainer.classList.add('cooldown');
-          this.setAttribute('aria-hidden', 'true');
-        }
-      },
 
-      altChanged: function() {
-        if (this.alt === '') {
-          this.setAttribute('aria-hidden', 'true');
-        } else {
-          this.removeAttribute('aria-hidden');
+    (function() {
+
+      'use strict';
+
+      function classNames(obj) {
+        var classNames = [];
+        for (var key in obj) {
+          if (obj.hasOwnProperty(key) && obj[key]) {
+            classNames.push(key);
+          }
         }
-        this.setAttribute('aria-label', this.alt);
-      },
 
-      reset: function() {
-        this.$.spinnerContainer.classList.remove('active', 'cooldown');
+        return classNames.join(' ');
       }
-    });
+
+      Polymer({
+
+        is: 'paper-spinner',
+
+        listeners: {
+          'animationend': 'reset',
+          'webkitAnimationEnd': 'reset'
+        },
+
+        properties: {
+
+          /**
+           * Displays the spinner.
+           *
+           * @attribute active
+           * @type boolean
+           * @default false
+           */
+          active: {
+            observer: '_activeChanged',
+            type: Boolean,
+            value: false
+          },
+
+          /**
+           * Alternative text content for accessibility support.
+           * If alt is present, it will add an aria-label whose content matches alt when active.
+           * If alt is not present, it will default to 'loading' as the alt value.
+           *
+           * @attribute alt
+           * @type string
+           * @default 'loading'
+           */
+          alt: {
+            observer: '_altChanged',
+            type: String,
+            value: 'loading'
+          },
+
+          /**
+           * True when the spinner is going from active to inactive. This is represented by a fade
+           * to 0% opacity to the user.
+           */
+          _coolingDown: {
+            type: Boolean,
+            value: false
+          },
+
+          _spinnerContainerClassName: {
+            type: String,
+            computed: '_computeSpinnerContainerClassName(active, _coolingDown)'
+          }
+
+        },
+
+        _computeSpinnerContainerClassName: function(active, _coolingDown) {
+          return classNames({
+            active: active || _coolingDown,
+            cooldown: _coolingDown
+          });
+        },
+
+        ready: function() {
+          // Allow user-provided `aria-label` take preference to any other text alternative.
+          if (this.hasAttribute('aria-label')) {
+            this.alt = this.getAttribute('aria-label');
+          } else {
+            this.setAttribute('aria-label', this.alt);
+          }
+
+          if (!this.active) {
+            this.setAttribute('aria-hidden', 'true');
+          }
+        },
+
+        _activeChanged: function() {
+          if (this.active) {
+            this.removeAttribute('aria-hidden');
+          } else {
+            this._coolingDown = true;
+            this.setAttribute('aria-hidden', 'true');
+          }
+        },
+
+        _altChanged: function() {
+          if (this.alt === '') {
+            this.setAttribute('aria-hidden', 'true');
+          } else {
+            this.removeAttribute('aria-hidden');
+          }
+
+          this.setAttribute('aria-label', this.alt);
+        },
+
+        reset: function() {
+          this.active = false;
+          this._coolingDown = false;
+        }
+
+      });
+
+    }());
+
   </script>
-</polymer-element>
+
+</dom-module>

data/app/assets/components/paper-spinner/test/index.html

@@ -0,0 +1,34 @@
+<!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>paper-spinner tests</title>
+
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+    <meta name="viewport" content="width=device-width, minimum-scale=1.0, initial-scale=1, user-scalable=yes">
+
+    <script src="../../web-component-tester/browser.js"></script>
+
+  </head>
+  <body>
+
+    <script>
+
+      WCT.loadSuites([
+        'paper-spinner.html'
+      ]);
+
+    </script>
+
+  </body>
+</html>

data/app/assets/components/paper-spinner/test/paper-spinner.html

@@ -0,0 +1,63 @@
+<!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>
+
+    <meta charset="UTF-8">
+    <title>paper-spinner basic tests</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
+
+    <script src="../../webcomponentsjs/webcomponents.js"></script>
+    <script src="../../web-component-tester/browser.js"></script>
+    <script src="../../test-fixture/test-fixture-mocha.js"></script>
+
+    <link href="../../test-fixture/test-fixture.html" rel="import">
+    <link href="../paper-spinner.html" rel="import">
+
+  </head>
+  <body>
+
+    <test-fixture id="PaperSpinner">
+      <template>
+        <paper-spinner></paper-spinner>
+      </template>
+    </test-fixture>
+
+    <script>
+      'use strict';
+
+      suite('<paper-spinner>', function() {
+
+        suite('an accessible paper spinner', function() {
+          var spinner;
+
+          setup(function() {
+            spinner = fixture('PaperSpinner');
+          });
+
+          test('adds an ARIA label when `alt` is supplied', function() {
+            var ALT_TEXT = 'Loading the next gif...';
+
+            spinner.alt = ALT_TEXT;
+            expect(spinner.getAttribute('aria-label')).to.be.eql(ALT_TEXT);
+          });
+
+          test('hides from ARIA when inactive', function() {
+            spinner.active = false;
+            expect(spinner.getAttribute('aria-hidden')).to.be.eql('true');
+          });
+        });
+
+      });
+    </script>
+
+  </body>
+</html>

data/app/assets/components/paper-styles/README.md

@@ -0,0 +1,3 @@
+# paper-styles
+
+Material design CSS styles.

data/app/assets/components/paper-styles/bower.json

@@ -0,0 +1,27 @@
+{
+  "name": "paper-styles",
+  "version": "1.0.4",
+  "description": "Common (global) styles for Material Design elements.",
+  "authors": [
+    "The Polymer Authors"
+  ],
+  "keywords": [
+    "web-component",
+    "polymer",
+    "style"
+  ],
+  "main": "paper-styles.html",
+  "license": "http://polymer.github.io/LICENSE.txt",
+  "homepage": "https://github.com/polymerelements/paper-styles/",
+  "ignore": [
+    "/.*",
+    "/demo/"
+  ],
+  "dependencies": {
+    "iron-flex-layout": "polymerelements/iron-flex-layout#^1.0.0",
+    "polymer": "Polymer/polymer#^1.0.0"
+  },
+  "devDependencies": {
+    "webcomponentsjs": "webcomponents/webcomponentsjs#^0.7.0"
+  }
+}

data/app/assets/components/paper-styles/classes/global.html

@@ -0,0 +1,96 @@
+<!--
+@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="../paper-styles-classes.html">
+
+<!--
+A set of base styles that are applied to the document and standard elements that
+match the Material Design spec.
+-->
+<style>
+/*
+Note that there is a lot of style duplication here. The hope is that the Polymer
+0.8 styling solution will allow for inheritance of properties so that we can
+eventually avoid it.
+*/
+
+/* Mixins */
+
+/* [paper-font] */
+body {
+  font-family: 'Roboto', 'Noto', sans-serif;
+  -webkit-font-smoothing: antialiased;  /* OS X subpixel AA bleed bug */
+}
+
+/* [paper-font=display2] */
+h1 {
+  font-size: 45px;
+  font-weight: 400;
+  letter-spacing: -.018em;
+  line-height: 48px;
+}
+
+/* [paper-font=display1] */
+h2 {
+  font-size: 34px;
+  font-weight: 400;
+  letter-spacing: -.01em;
+  line-height: 40px;
+}
+
+/* [paper-font=headline] */
+h3 {
+  font-size: 24px;
+  font-weight: 400;
+  letter-spacing: -.012em;
+  line-height: 32px;
+}
+
+/* [paper-font=subhead] */
+h4 {
+  font-size: 16px;
+  font-weight: 400;
+  line-height: 24px;
+}
+
+/* [paper-font=body2] */
+h5, h6 {
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 24px;
+}
+
+/* [paper-font=button] */
+a {
+  font-size: 14px;
+  font-weight: 500;
+  letter-spacing: 0.018em;
+  line-height: 24px;
+  text-transform: uppercase;
+}
+
+/* Overrides */
+
+body, a {
+  color: #212121;
+}
+
+h1, h2, h3, h4, h5, h6, p {
+  margin: 0 0 20px 0;
+}
+
+h1, h2, h3, h4, h5, h6, a {
+  text-rendering: optimizeLegibility;
+}
+
+a {
+  text-decoration: none;
+}
+
+</style>