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

data/app/assets/components/iron-jsonp-library/iron-jsonp-library.html

@@ -0,0 +1,257 @@
+<!--
+@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">
+
+<script>
+(function() {
+  "use strict";
+  /**
+    `Polymer.IronJsonpLibraryBehavior` loads a jsonp library.
+    Multiple components can request same library, only one copy will load.
+
+    Some libraries require a specific global function be defined.
+    If this is the case, specify the `callbackName` property.
+
+    You should use an HTML Import to load library dependencies
+    when possible instead of using this element.
+
+    @hero hero.svg
+    @polymerBehavior
+   */
+  Polymer.IronJsonpLibraryBehavior = {
+
+    properties: {
+      /**
+       * True if library has been successfully loaded
+       */
+      libraryLoaded: {
+        type: Boolean,
+        value: false,
+        notify: true,
+        readOnly: true
+      },
+      /**
+       * Not null if library has failed to load
+       */
+      libraryErrorMessage: {
+        type: String,
+        value: null,
+        notify: true,
+        readOnly: true
+      }
+      // Following properties are to be set by behavior users
+      /**
+       * Library url. Must contain string `%%callback_name%%`.
+       *
+       * `%%callback_name%%` is a placeholder for jsonp wrapper function name
+       *
+       * Ex: https://maps.googleapis.com/maps/api/js?callback=%%callback%%
+       * @property libraryUrl
+       */
+      /**
+       * Set if library requires specific callback name.
+       * Name will be automatically generated if not set.
+       * @property callbackName
+       */
+      /**
+       * name of event to be emitted when library loads. Standard is `api-load`
+       * @property notifyEvent
+       */
+      /**
+       * event with name specified in `notifyEvent` attribute
+       * will fire upon successful load2
+       * @event `notifyEvent`
+       */
+    },
+
+    _libraryLoadCallback: function(err, result) {
+      if (err) {
+        console.warn("Library load failed:", err.message);
+        this._setLibraryErrorMessage(err.message);
+      }
+      else {
+        this._setLibraryErrorMessage(null);
+        this._setLibraryLoaded(true);
+        if (this.notifyEvent)
+          this.fire( this.notifyEvent, result);
+      }
+    },
+
+    /** loads the library, and fires this.notifyEvent upon completion */
+    _loadLibrary: function() {
+      LoaderMap.require(
+        this.libraryUrl,
+        this._libraryLoadCallback.bind(this),
+        this.callbackName
+      );
+    },
+
+    ready: function() {
+      this._loadLibrary();
+    }
+  };
+
+  /*
+   * LoaderMap keeps track of all Loaders
+   */
+  var LoaderMap = {
+    apiMap: {}, // { hash -> Loader }
+
+    /*
+     * @param {function} notifyCallback loaded callback fn(result)
+     * @param {string} jsonpCallbackName name of jsonpcallback. If API does not provide it, leave empty. Optional.
+     */
+    require: function(url, notifyCallback, jsonpCallbackName) {
+
+      // make hashable string form url
+      var name = this.nameFromUrl(url);
+
+      // create a loader as needed
+      if (!this.apiMap[name])
+        this.apiMap[name] = new Loader(name, url, jsonpCallbackName);
+
+      // ask for notification
+      this.apiMap[name].requestNotify(notifyCallback);
+    },
+
+    nameFromUrl: function(url) {
+      return url.replace(/[\:\/\%\?\&\.\=\-\,]/g, '_') + '_api';
+    }
+  };
+
+  var Loader = function(name, url, callbackName) {
+    this.notifiers = [];  // array of notifyFn [ notifyFn* ]
+
+    // callback is specified either as callback name
+    // or computed dynamically if url has callbackMacro in it
+    if (!callbackName) {
+      if (url.indexOf(this.callbackMacro) >= 0) {
+        callbackName = name + '_loaded';
+        url = url.replace(this.callbackMacro, callbackName);
+      } else {
+        this.error = new Error('IronJsonpLibraryBehavior a %%callback_name%% parameter is required in libraryUrl');
+        // TODO(sjmiles): we should probably fallback to listening to script.load
+        return;
+      }
+    }
+    this.callbackName = callbackName;
+    window[this.callbackName] = this.success.bind(this);
+    this.addScript(url);
+  };
+
+  Loader.prototype = {
+
+    callbackMacro: '%%callback%%',
+    loaded: false,
+
+    addScript: function(src) {
+      var script = document.createElement('script');
+      script.src = src;
+      script.onerror = this.handleError.bind(this);
+      var s = document.querySelector('script') || document.body;
+      s.parentNode.insertBefore(script, s);
+      this.script = script;
+    },
+
+    removeScript: function() {
+      if (this.script.parentNode) {
+        this.script.parentNode.removeChild(this.script);
+      }
+      this.script = null;
+    },
+
+    handleError: function(ev) {
+      this.error = new Error("Library failed to load");
+      this.notifyAll();
+      this.cleanup();
+    },
+
+    success: function() {
+      this.loaded = true;
+      this.result = Array.prototype.slice.call(arguments);
+      this.notifyAll();
+      this.cleanup();
+    },
+
+    cleanup: function() {
+      delete window[this.callbackName];
+    },
+
+    notifyAll: function(notifyCallback) {
+      this.notifiers.forEach( function(notifyCallback) {
+        notifyCallback(this.error, this.result);
+      }.bind(this));
+      this.notifiers = [];
+    },
+
+    requestNotify: function(notifyCallback) {
+      if (this.loaded || this.error) {
+        notifyCallback( this.error, this.result);
+      } else {
+        this.notifiers.push(notifyCallback);
+      }
+    }
+  };
+})();
+</script>
+
+<!--
+  Loads specified jsonp library.
+
+  Example:
+
+    <iron-jsonp-library
+      library-url="https://apis.google.com/js/plusone.js?onload=%%callback%%"
+      notify-event="api-load"
+      library-loaded="{{loaded}}"></iron-jsonp-library>
+
+  Will emit 'api-load' event when loaded, and set 'loaded' to true
+
+  Implemented by  Polymer.IronJsonpLibraryBehavior. Use it
+  to create specific library loader elements.
+
+  @demo
+-->
+<script>
+  Polymer({
+
+    is: 'iron-jsonp-library',
+
+    behaviors: [ Polymer.IronJsonpLibraryBehavior ],
+
+    properties: {
+      /**
+       * Library url. Must contain string `%%callback_name%%`.
+       *
+       * `%%callback_name%%` is a placeholder for jsonp wrapper function name
+       *
+       * Ex: https://maps.googleapis.com/maps/api/js?callback=%%callback%%
+       */
+      libraryUrl: String,
+      /**
+       * Set if library requires specific callback name.
+       * Name will be automatically generated if not set.
+       */
+      callbackName: String,
+      /**
+       * event with name specified in 'notifyEvent' attribute
+       * will fire upon successful load
+       */
+      notifyEvent: String
+      /**
+       * event with name specified in 'notifyEvent' attribute
+       * will fire upon successful load
+       * @event `notifyEvent`
+       */
+
+    }
+  });
+
+</script>

data/app/assets/components/iron-localstorage/README.md

@@ -0,0 +1,13 @@
+iron-localstorage
+=================
+
+Element access to localStorage.  The "name" property
+is the key to the data ("value" property) stored in localStorage.
+
+`iron-localstorage` automatically saves the value to localStorage when
+value is changed.  Note that if value is an object auto-save will be
+triggered only when value is a different instance.
+
+```html
+<iron-localstorage name="my-app-storage" value="{{value}}"></iron-localstorage>
+```

data/app/assets/components/iron-localstorage/bower.json

@@ -0,0 +1,22 @@
+{
+  "name": "iron-localstorage",
+  "version": "1.0.0",
+  "description": "Provides access to local storage",
+  "keywords": [
+    "web-component",
+    "polymer",
+    "storage"
+  ],
+  "main": "iron-localstorage.html",
+  "license": "http://polymer.github.io/LICENSE.txt",
+  "homepage": "https://github.com/PolymerElements/iron-localstorage/",
+  "dependencies": {
+    "polymer": "Polymer/polymer#^1.0.0"
+  },
+  "devDependencies": {
+    "iron-component-page": "PolymerElements/iron-component-page#^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-localstorage/demo/index.html

@@ -0,0 +1,38 @@
+<!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-localstorage</title>
+
+  <script src="../../webcomponentsjs/webcomponents-lite.js"></script>
+
+  <link rel="import" href="../iron-localstorage.html">
+
+</head>
+<body>
+
+  <template is="dom-bind">
+    <p>string entered below will be stored in localStorage and automatically retrived from localStorage when the page is reloaded</p>
+    <p>If you open another window with this test, changes in one window will propagate to
+    the other immediately.</p>
+    <input value="{{value::change}}">
+    <iron-localstorage name="polymer-localstorage-x-test1" value="{{value}}"></iron-localstorage>
+  </template>
+
+
+  <template is="dom-bind">
+    <input type="checkbox" checked="{{mode::change}}">
+    <iron-localstorage name="polymer-localstorage-x-test2" value="{{mode}}"></iron-localstorage>
+  </template>
+
+</body>
+</html>

data/app/assets/components/iron-localstorage/hero.svg

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 17.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 225 126" enable-background="new 0 0 225 126" xml:space="preserve">
+<g id="background" display="none">
+	<rect display="inline" fill="#B0BEC5" width="225" height="126"/>
+</g>
+<g id="label">
+</g>
+<g id="art">
+	<path d="M124,45.3c-0.5-0.6-4.7-1.6-12-1.6s-11.5,1.1-12,1.6c0,0,0.1-0.3,0.1-0.3h-2c0-3,10.7-3.4,14-3.4s14,0.4,14,3.4h-2
+		C124,45,124,45.3,124,45.3z"/>
+	<path d="M112,83c-3.3,0-14-0.2-14-3.4l0-7.6l0-1.6l2,0c0-0.2-0.1-0.3-0.1-0.3c0.5,0.6,4.7,1.6,12,1.6s11.5-1.1,12-1.6
+		c0,0-0.1,0.1-0.1,0.3l2,0l0,1.5l0,7.7C126,82.8,115.3,83,112,83z M100,79.4c0.8,0.6,4.9,1.6,12,1.6s11.2-1,12-1.6l0-7
+		c-3.2,1.3-9.6,1.4-12,1.4c-2.4,0-8.8-0.1-12-1.4L100,79.4z"/>
+	<path d="M112,70c-3.3,0-14-0.2-14-3.4l0-7.6l0-1.6l2,0c0-0.2-0.1-0.3-0.1-0.3c0.5,0.6,4.7,1.6,12,1.6s11.5-1.1,12-1.6
+		c0,0-0.1,0.1-0.1,0.3l2,0l0,1.5l0,7.7C126,69.8,115.3,70,112,70z M100,66.4c0.8,0.6,4.9,1.6,12,1.6s11.2-1,12-1.6l0-7
+		c-3.2,1.3-9.6,1.4-12,1.4c-2.4,0-8.8-0.1-12-1.4L100,66.4z"/>
+	<path d="M112,57c-3.3,0-14-0.2-14-3.4l0-7.6l0-1.6l2,0c0-0.2-0.1-0.3-0.1-0.3c0.5,0.6,4.7,1.6,12,1.6s11.5-1.1,12-1.6
+		c0,0-0.1,0.1-0.1,0.3l2,0l0,1.5l0,7.7C126,56.8,115.3,57,112,57z M100,53.4c0.8,0.6,4.9,1.6,12,1.6s11.2-1,12-1.6l0-7
+		c-3.2,1.3-9.6,1.4-12,1.4c-2.4,0-8.8-0.1-12-1.4L100,53.4z"/>
+	<path d="M151,99H73V27h78V99z M75,97h74V29H75V97z"/>
+	<circle cx="74" cy="28" r="4"/>
+	<circle cx="150" cy="28" r="4"/>
+	<circle cx="150" cy="98" r="4"/>
+	<circle cx="74" cy="98" r="4"/>
+	<circle cx="113" cy="98" r="4"/>
+	<circle cx="113" cy="28" r="4"/>
+	<circle cx="74" cy="63" r="4"/>
+	<circle cx="150" cy="63" r="4"/>
+	<g id="ic_x5F_add_x0D_">
+	</g>
+</g>
+<g id="Guides">
+</g>
+</svg>

data/app/assets/components/iron-localstorage/index.html

@@ -0,0 +1,23 @@
+<!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>
+
+  <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-localstorage/iron-localstorage.html

@@ -0,0 +1,196 @@
+<!--
+@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">
+
+<!--
+Element access to Web Storage API (window.localStorage).
+
+Keeps `value` is sync with a localStorage key.
+
+Direct assignments to `value` are automatically detected and saved.
+Subproperty assignments are not (ex: `value.bar='foo'`).
+Call `save()` manually to commit your changes after modifying subproperties.
+
+Value is saved in localStorage as JSON by default.
+
+If you set the value to null, storage key will be deleted.
+
+    <iron-localstorage name="my-app-storage" value="{{value}}">
+    </iron-localstorage>
+
+
+<b>Warning</b>: do not pass subproperty bindings to iron-localstorage until Polymer
+[bug 1550](https://github.com/Polymer/polymer/issues/1550)
+is resolved. Local storage will be blown away.
+No `<iron-localstorage value="{{foo.bar}}"`.
+
+@group Iron Elements
+@demo demo/index.html
+@hero hero.svg
+@element iron-localstorage
+-->
+<dom-module id="iron-localstorage"></dom-module>
+<script>
+
+  Polymer({
+    is: 'iron-localstorage',
+
+    /**
+     * Fired when value loads from localStorage.
+     *
+     * @param {Object} detail
+     * @param {Boolean} detail.externalChange true if change occured in different window
+     * @event iron-localstorage-load
+     */
+
+    /**
+     * Fired when loaded value is null.
+     * You can use event handler to initialize default value.
+     *
+     * @event iron-localstorage-load-empty
+     */
+    properties: {
+      /**
+       * The key to the data stored in localStorage.
+       */
+      name: {
+        type: String,
+        value: ''
+      },
+      /**
+       * The data associated with this storage.
+       * If value is set to null, and storage is in useRaw mode, item will be deleted
+       */
+      value: {
+        type: Object,
+        notify: true
+      },
+
+      /**
+       * Value is stored and retrieved without JSON parse if true
+       */
+      useRaw: {
+        type: Boolean,
+        value: false
+      },
+
+      /**
+       * Auto save is disabled if true. Default to false.
+       */
+      autoSaveDisabled: {
+        type: Boolean,
+        value: false
+      },
+      /**
+       * Last error encountered while saving/loading items. Null otherwise
+       */
+      errorMessage: {
+        type: String,
+        notify: true
+      },
+      /*
+       * True if value was loaded
+       */
+      _loaded: {
+        type: Boolean,
+        value: false
+      }
+    },
+
+    observers: [
+      'reload(name,useRaw)',
+      '_trySaveValue(value, _loaded, autoSaveDisabled)'
+    ],
+
+    ready: function() {
+      this._boundHandleStorage = this._handleStorage.bind(this);
+    },
+
+    attached: function() {
+      window.addEventListener('storage', this._boundHandleStorage);
+    },
+
+    detached: function() {
+      window.removeEventListener('storage', this._boundHandleStorage);
+    },
+
+    _handleStorage: function(ev) {
+      if (ev.key == this.name) {
+        this._load(true);
+      }
+    },
+
+    _trySaveValue: function(value, _loaded, autoSaveDisabled) {
+      if (this._justLoaded) { // guard against saving after _load()
+        this._justLoaded = false;
+        return;
+      }
+      if (_loaded && !autoSaveDisabled) {
+        this.save();
+      }
+    },
+
+    /**
+     * Loads the value again. Use if you modify
+     * localStorage using DOM calls, and want to
+     * keep this element in sync.
+     */
+    reload: function() {
+      this._load();
+    },
+
+    /**
+     * loads value from local storage
+     * @param {Boolean} externalChange true if loading changes from a different window
+     */
+    _load: function(externalChange) {
+      var v = localStorage.getItem(this.name);
+
+      if (v === null) {
+        this.fire('iron-localstorage-load-empty');
+      } else if (!this.useRaw) {
+        try {
+          v = JSON.parse(v);
+        } catch(x) {
+          this.errorMessage = "Could not parse local storage value";
+          console.error("could not parse local storage value", v);
+        }
+      }
+
+      this._justLoaded = true;
+      this._loaded = true;
+      this.value = v;
+      this.fire('iron-localstorage-load', { externalChange: externalChange});
+    },
+
+    /**
+     * Saves the value to localStorage. Call to save if autoSaveDisabled is set.
+     * If `value` is null, deletes localStorage.
+     */
+    save: function() {
+      var v = this.useRaw ? this.value : JSON.stringify(this.value);
+      try {
+        if (this.value === null) {
+          localStorage.removeItem(this.name);
+        } else {
+          localStorage.setItem(this.name, v);
+        }
+      }
+      catch(ex) {
+        // Happens in Safari incognito mode,
+        this.errorMessage = ex.message;
+        console.error("localStorage could not be saved. Safari incoginito mode?", ex);
+      }
+    }
+
+  });
+
+</script>

data/app/assets/components/iron-localstorage/test/basic.html

@@ -0,0 +1,88 @@
+<!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>iron-localstorage-basic</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 rel="import" href="../../test-fixture/test-fixture.html">
+  <link rel="import" href="../iron-localstorage.html">
+
+</head>
+<body>
+
+  <test-fixture id="fixture">
+    <template>
+      <iron-localstorage id="localstorage" name="iron-localstorage-test"></iron-localstorage>
+    </template>
+  </test-fixture>
+
+  <script>
+    var storage;
+
+    suite('basic', function() {
+
+      setup(function() {
+        window.localStorage.setItem('iron-localstorage-test', '{"foo":"bar"}');
+        document.getElementById('fixture').create();
+        storage = document.getElementById('localstorage');
+      });
+
+      teardown(function() {
+        window.localStorage.removeItem('iron-localstorage-test');
+      });
+
+      test('load', function() {
+        assert.isNotNull(storage.value);
+        assert.equal(storage.value.foo, 'bar');
+      });
+
+      test('save', function() {
+        var newValue = {'foo': 'zot'};
+        storage.value = newValue;
+        var v = window.localStorage.getItem(storage.name);
+        v = JSON.parse(v);
+        assert.equal(v.foo, newValue.foo);
+      });
+
+      test('delete', function() {
+        storage.value = null;
+        var v = window.localStorage.getItem(storage.name);
+        assert.isNull(v);
+      });
+
+      test('event iron-localstorage-load', function(done) {
+        var ls = document.createElement('iron-localstorage');
+        ls.addEventListener('iron-localstorage-load', function() {
+          done();
+        });
+        ls.name = 'iron-localstorage-test';
+      });
+
+      test('event iron-localstorage-load-empty', function(done) {
+        var ls = document.createElement('iron-localstorage');
+        ls.addEventListener('iron-localstorage-load-empty', function() {
+          done();
+        });
+        ls.name = 'iron-localstorage-not-exist';
+      });
+
+    });
+
+  </script>
+
+</body>
+</html>