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

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

@@ -1,16 +1,23 @@
 <!--
-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
+@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.txt
+subject to an additional IP rights grant found at http://polymer.github.io/PATENTS
 -->
 
+<link rel="import" href="../paper-styles/paper-styles.html">
+<link rel="import" href="../iron-flex-layout/iron-flex-layout.html">
+<link rel="import" href="../iron-behaviors/iron-control-state.html">
+<link rel="import" href="../paper-progress/paper-progress.html">
+<link rel="import" href="../paper-input/paper-input.html">
+
 <!--
 `paper-slider` allows user to select a value from a range of values by
-moving the slider thumb.  The interactive nature of the slider makes it a 
-great choice for settings that reflect intensity levels, such as volume, 
+moving the slider thumb.  The interactive nature of the slider makes it a
+great choice for settings that reflect intensity levels, such as volume,
 brightness, or color saturation.
 
 Example:
@@ -27,329 +34,402 @@ Styling slider:
 
 To change the slider progress bar color:
 
-    paper-slider::shadow #sliderBar::shadow #activeProgress {
-      background-color: #0f9d58;
+    paper-slider {
+      --paper-slider-active-color: #0f9d58;
     }
 
 To change the slider knob color:
 
-    paper-slider::shadow #sliderKnobInner {
-      background-color: #0f9d58;
+    paper-slider {
+      --paper-slider-knob-color: #0f9d58;
     }
 
 To change the slider pin color:
 
-    paper-slider::shadow #sliderKnobInner::before {
-      background-color: #0f9d58;
+    paper-slider {
+      --paper-slider-pin-color: #0f9d58;
     }
 
 To change the slider pin's font color:
 
-    paper-slider::shadow #sliderKnob > #sliderKnobInner::after {
-      color: #0f9d58
+    paper-slider {
+      --paper-slider-pin-font-color: #0f9d58;
     }
 
 To change the slider secondary progress bar color:
 
-    paper-slider::shadow #sliderBar::shadow #secondaryProgress {
-      background-color: #0f9d58;
+    paper-slider {
+      --paper-slider-secondary-color: #0f9d58;
     }
 
-@group Paper Elements
-@element paper-slider
-@extends core-range
-@homepage github.io
--->
-
-<link rel="import" href="../core-a11y-keys/core-a11y-keys.html">
-<link rel="import" href="../paper-progress/paper-progress.html">
-<link rel="import" href="../paper-input/paper-input.html">
+To change the slider disabled active color:
 
-<polymer-element name="paper-slider" extends="core-range" attributes="snaps pin disabled secondaryProgress editable immediateValue" role="slider" tabindex="0" aria-valuemin="0" aria-valuemax="100">
-<template>
+    paper-slider {
+      --paper-slider-disabled-active-color: #ccc;
+    }
 
-  <link rel="stylesheet" href="paper-slider.css">
+To change the slider disabled secondary progress bar color:
 
-  <template if="{{!disabled}}">
-    <core-a11y-keys target="{{}}" keys="left down pagedown home" on-keys-pressed="{{decrementKey}}"></core-a11y-keys>
-    <core-a11y-keys target="{{}}" keys="right up pageup end" on-keys-pressed="{{incrementKey}}"></core-a11y-keys>
-  </template>
+    paper-slider {
+      --paper-slider-disabled-secondary-color: #ccc;
+    }
 
-  <div id="sliderContainer" class="{{ {disabled: disabled, pin: pin, snaps: snaps, ring: immediateValue <= min, expand: expand, dragging: dragging, transiting: transiting, editable: editable} | tokenList }}">
+@group Paper Elements
+@element paper-slider
+@demo demo/index.html
+@hero hero.svg
+-->
 
-    <div class="bar-container">
-      <paper-progress id="sliderBar" aria-hidden="true" min="{{min}}" max="{{max}}" value="{{immediateValue}}" secondaryProgress="{{secondaryProgress}}"
-          on-down="{{bardown}}" on-up="{{resetKnob}}" 
-          on-trackstart="{{trackStart}}" on-trackx="{{trackx}}" on-trackend="{{trackEnd}}"></paper-progress>
-    </div>
+<dom-module id="paper-slider">
+  <link rel="import" type="css" href="paper-slider.css">
+  <template>
+    <template is="dom-if" if="{{!disabled}}">
+    </template>
 
-    <template if="{{snaps && !disabled}}">
-      <div class="slider-markers" horizontal layout>
-        <template repeat="{{markers}}">
-          <div flex class="slider-marker"></div>
-        </template>
+    <div id="sliderContainer" class$="[[_getClassNames(disabled, pin, snaps, immediateValue, min, expand, dragging, transiting, editable)]]">
+      <div class="bar-container">
+        <paper-progress id="sliderBar" aria-hidden="true" min="[[min]]" max="[[max]]" value="[[immediateValue]]" secondary-progress="[[secondaryProgress]]"
+          on-down="_bardown" on-up="_resetKnob" on-track="_onTrack"></paper-progress>
       </div>
-    </template>
 
-    <div id="sliderKnob" on-down="{{knobdown}}" on-up="{{resetKnob}}"
-        on-trackstart="{{trackStart}}" on-trackx="{{trackx}}" on-trackend="{{trackEnd}}"
-        on-transitionend="{{knobTransitionEnd}}"
+      <template is="dom-if" if="[[snaps]]">
+        <div class="slider-markers horizontal layout">
+          <template is="dom-repeat" items="[[markers]]">
+            <div class="slider-marker flex"></div>
+          </template>
+        </div>
+      </template>
+
+      <div id="sliderKnob" on-down="_knobdown" on-up="_resetKnob"
+        on-track="_onTrack"
+        on-transitionend="_knobTransitionEnd"
         center-justified center horizontal layout>
 
-      <div id="sliderKnobInner" value="{{immediateValue}}"></div>
-
+        <div id="sliderKnobInner" value$="[[immediateValue]]"></div>
+      </div>
     </div>
 
-  </div>
+    <template is="dom-if" if="[[editable]]">
+      <paper-input id="input" class="slider-input" disabled$="[[disabled]]" on-change="_inputChange"></paper-input>
+    </template>
 
-  <template if="{{editable}}">
-    <paper-input id="input" class="slider-input" value="{{immediateValue}}" disabled?="{{disabled}}" on-change="{{inputChange}}"></paper-input>
   </template>
+</dom-module>
 
-</template>
 <script>
+  /**
+   * Fired when the slider's value changes.
+   *
+   * @event value-change
+   */
+
+  /**
+   * Fired when the slider's immediateValue changes.
+   *
+   * @event immediate-value-change
+   */
+
+  /**
+   * Fired when the slider's value changes due to user interaction.
+   *
+   * Changes to the slider's value due to changes in an underlying
+   * bound variable will not trigger this event.
+   *
+   * @event change
+   */
+
+  Polymer({
+    is: 'paper-slider',
+
+    behaviors: [
+      Polymer.IronRangeBehavior,
+      Polymer.IronControlState
+    ],
+
+    properties: {
+
+      /**
+       * If true, the slider thumb snaps to tick marks evenly spaced based
+       * on the `step` property value.
+       */
+      snaps: {
+        type: Boolean,
+        value: false,
+        notify: true
+      },
+
+      /**
+       * If true, a pin with numeric value label is shown when the slider thumb
+       * is pressed.  Use for settings for which users need to know the exact
+       * value of the setting.
+       */
+      pin: {
+        type: Boolean,
+        value: false,
+        notify: true
+      },
+
+      /**
+       * The number that represents the current secondary progress.
+       */
+      secondaryProgress: {
+        type: Number,
+        value: 0,
+        notify: true,
+        observer: '_secondaryProgressChanged'
+      },
+
+      /**
+       * If true, an input is shown and user can use it to set the slider value.
+       */
+      editable: {
+        type: Boolean,
+        value: false
+      },
+
+      /**
+       * The immediate value of the slider.  This value is updated while the user
+       * is dragging the slider.
+       */
+      immediateValue: {
+        type: Number,
+        value: 0,
+        readOnly: true
+      },
+
+      /**
+       * The maximum number of markers
+       */
+      maxMarkers: {
+        type: Number,
+        value: 0,
+        notify: true,
+        observer: '_maxMarkersChanged'
+      },
+
+      /**
+       * If true, the knob is expanded
+       */
+      expand: {
+        type: Boolean,
+        value: false,
+        readOnly: true
+      },
+
+      /**
+       * True when the user is dragging the slider.
+       */
+      dragging: {
+        type: Boolean,
+        value: false,
+        readOnly: true
+      },
+
+      transiting: {
+        type: Boolean,
+        value: false,
+        readOnly: true
+      },
+
+      markers: {
+        readOnly: true,
+        value: []
+      },
+    },
 
-  Polymer('paper-slider', {
-
-    /**
-     * Fired when the slider's value changes.
-     *
-     * @event core-change
-     */
-     
-    /**
-     * Fired when the slider's immediateValue changes.
-     *
-     * @event immediate-value-change
-     */
-
-    /**
-     * Fired when the slider's value changes due to user interaction.
-     *
-     * Changes to the slider's value due to changes in an underlying
-     * bound variable will not trigger this event.
-     *
-     * @event change
-     */
-
-    /**
-     * If true, the slider thumb snaps to tick marks evenly spaced based
-     * on the `step` property value.
-     *
-     * @attribute snaps
-     * @type boolean
-     * @default false
-     */
-    snaps: false,
-
-    /**
-     * If true, a pin with numeric value label is shown when the slider thumb 
-     * is pressed.  Use for settings for which users need to know the exact 
-     * value of the setting.
-     *
-     * @attribute pin
-     * @type boolean
-     * @default false
-     */
-    pin: false,
-
-    /**
-     * If true, this slider is disabled.  A disabled slider cannot be tapped
-     * or dragged to change the slider value.
-     *
-     * @attribute disabled
-     * @type boolean
-     * @default false
-     */
-    disabled: false,
+    observers: [
+      '_updateKnob(value, min, max, snaps, step)',
+      '_minChanged(min)',
+      '_maxChanged(max)',
+      '_valueChanged(value)',
+      '_immediateValueChanged(immediateValue)'
+    ],
 
-    /**
-     * The number that represents the current secondary progress.
-     *
-     * @attribute secondaryProgress
-     * @type number
-     * @default 0
-     */
-    secondaryProgress: 0,
-
-    /**
-     * If true, an input is shown and user can use it to set the slider value.
-     *
-     * @attribute editable
-     * @type boolean
-     * @default false
-     */
-    editable: false,
+    ready: function() {
+      // issue polymer/polymer#1305
+      this.async(function() {
+        this._updateKnob(this.value);
+        this._updateInputValue();
+      }, 1);
+    },
 
     /**
-     * The immediate value of the slider.  This value is updated while the user
-     * is dragging the slider.
-     *
-     * @attribute immediateValue
-     * @type number
-     * @default 0
+     * Increases value by `step` but not above `max`.
+     * @method increment
      */
-    maxMarkers: 100,
+    increment: function() {
+      this.value = this._clampValue(this.value + this.step);
+    },
 
     /**
-     * True when the user is dragging the slider.
-     *
-     * @attribute dragging
-     * @type boolean
-     * @default false
+     * Decreases value by `step` but not below `min`.
+     * @method decrement
      */
-    dragging: false,
-
-    observe: {
-      'step snaps': 'update'
-    },
-
-    ready: function() {
-      this.update();
+    decrement: function() {
+      this.value = this._clampValue(this.value - this.step);
     },
 
-    update: function() {
-      this.positionKnob(this.calcRatio(this.value));
-      this.updateMarkers();
+    _updateKnob: function(value) {
+      this._positionKnob(this._calcRatio(value));
     },
 
-    minChanged: function() {
-      this.update();
+    _minChanged: function() {
       this.setAttribute('aria-valuemin', this.min);
     },
 
-    maxChanged: function() {
-      this.update();
+    _maxChanged: function() {
       this.setAttribute('aria-valuemax', this.max);
     },
 
-    valueChanged: function() {
-      this.update();
+    _valueChanged: function() {
       this.setAttribute('aria-valuenow', this.value);
-      this.fire('core-change');
+      this.fire('value-change');
     },
 
-    disabledChanged: function() {
-      if (this.disabled) {
-        this.removeAttribute('tabindex');
-      } else {
-        this.tabIndex = 0;
-      }
-    },
-
-    immediateValueChanged: function() {
+    _immediateValueChanged: function() {
       if (!this.dragging) {
         this.value = this.immediateValue;
       }
+      this._updateInputValue();
       this.fire('immediate-value-change');
     },
 
-    expandKnob: function() {
-      this.expand = true;
+    _secondaryProgressChanged: function() {
+      this.secondaryProgress = this._clampValue(this.secondaryProgress);
     },
 
-    resetKnob: function() {
-      this.expandJob && this.expandJob.stop();
-      this.expand = false;
+    _updateInputValue: function() {
+      if (this.editable) {
+        this.$$('#input').value = this.immediateValue;
+      }
     },
 
-    positionKnob: function(ratio) {
-      this.immediateValue = this.calcStep(this.calcKnobPosition(ratio)) || 0;
-      this._ratio = this.snaps ? this.calcRatio(this.immediateValue) : ratio;
-      this.$.sliderKnob.style.left = this._ratio * 100 + '%';
+    _expandKnob: function() {
+      this._setExpand(true);
     },
 
-    inputChange: function() {
-      this.value = this.$.input.value;
+    _resetKnob: function() {
+      this._expandJob && this._expandJob.stop();
+      this._setExpand(false);
+    },
+
+    _positionKnob: function(ratio) {
+      this._setImmediateValue(this._calcStep(this._calcKnobPosition(ratio)) || 0);
+      this._setRatio(this.snaps ? this._calcRatio(this.immediateValue) : ratio);
+      this.$.sliderKnob.style.left = this.ratio * 100 + '%';
+    },
+
+    _inputChange: function() {
+      this.value = this.$$('#input').value;
       this.fire('change');
     },
 
-    calcKnobPosition: function(ratio) {
+    _calcKnobPosition: function(ratio) {
       return (this.max - this.min) * ratio + this.min;
     },
 
-    trackStart: function(e) {
+    _onTrack: function(e) {
+      switch (event.detail.state) {
+        case 'end':
+          this._trackEnd(event);
+          break;
+        case 'track':
+          this._trackX(event);
+          break;
+        case 'start':
+          this._trackStart(event);
+          break;
+      }
+    },
+
+    _trackStart: function(e) {
       this._w = this.$.sliderBar.offsetWidth;
-      this._x = this._ratio * this._w;
+      this._x = this.ratio * this._w;
       this._startx = this._x || 0;
       this._minx = - this._startx;
       this._maxx = this._w - this._startx;
       this.$.sliderKnob.classList.add('dragging');
-      this.dragging = true;
-      e.preventTap();
+      this._setDragging(true);
+      e.preventDefault();
     },
 
-    trackx: function(e) {
-      var x = Math.min(this._maxx, Math.max(this._minx, e.dx));
+    _trackX: function(e) {
+      if (!this.dragging) {
+        this._trackStart(e);
+      }
+      var x = Math.min(this._maxx, Math.max(this._minx, e.detail.dx));
       this._x = this._startx + x;
-      this.immediateValue = this.calcStep(
-          this.calcKnobPosition(this._x / this._w)) || 0;
+      this._setImmediateValue(this._calcStep(
+          this._calcKnobPosition(this._x / this._w)) || 0);
       var s =  this.$.sliderKnob.style;
-      s.transform = s.webkitTransform = 'translate3d(' + (this.snaps ? 
-          (this.calcRatio(this.immediateValue) * this._w) - this._startx : x) + 'px, 0, 0)';
+      s.transform = s.webkitTransform = 'translate3d(' + (this.snaps ?
+          (this._calcRatio(this.immediateValue) * this._w) - this._startx : x) + 'px, 0, 0)';
     },
 
-    trackEnd: function() {
+    _trackEnd: function() {
       var s =  this.$.sliderKnob.style;
       s.transform = s.webkitTransform = '';
       this.$.sliderKnob.classList.remove('dragging');
-      this.dragging = false;
-      this.resetKnob();
+      this._setDragging(false);
+      this._resetKnob();
       this.value = this.immediateValue;
       this.fire('change');
     },
-    
-    knobdown: function(e) {
+
+    _knobdown: function(e) {
       e.preventDefault();
-      this.expandKnob();
+      this._expandKnob();
     },
 
-    bardown: function(e) {
+    _bardown: function(e) {
       e.preventDefault();
-      this.transiting = true;
+      this._setTransiting(true);
       this._w = this.$.sliderBar.offsetWidth;
       var rect = this.$.sliderBar.getBoundingClientRect();
-      var ratio = (e.x - rect.left) / this._w;
-      this.positionKnob(ratio);
-      this.expandJob = this.job(this.expandJob, this.expandKnob, 60);
-      this.asyncFire('change');
+      var ratio = (e.detail.x - rect.left) / this._w;
+      this._positionKnob(ratio);
+      this._expandJob = this.debounce(this._expandJob, this._expandKnob, 60);
+
+      this.async(function() {
+        this.fire('change');
+      });
     },
 
-    knobTransitionEnd: function(e) {
+    _knobTransitionEnd: function(e) {
       if (e.target === this.$.sliderKnob) {
-        this.transiting = false;
+        this._setTransiting(false);
       }
     },
 
-    updateMarkers: function() {
-      this.markers = [];
+    _maxMarkersChanged: function(maxMarkers) {
       var l = (this.max - this.min) / this.step;
-      if (!this.snaps && l > this.maxMarkers) {
-        return;
-      }
-      for (var i = 0; i < l; i++) {
-        this.markers.push('');
+      if (!this.snaps && l > maxMarkers) {
+        this._setMarkers([]);
+      } else {
+        this._setMarkers(new Array(l));
       }
     },
 
-    /**
-     * Increases value by `step` but not above `max`.
-     * @method increment
-     */
-    increment: function() {
-      this.value = this.clampValue(this.value + this.step);
-    },
-
-    /**
-     * Decreases value by `step` but not below `min`.
-     * @method decrement
-     */
-    decrement: function() {
-      this.value = this.clampValue(this.value - this.step);
+    _getClassNames: function() {
+      var classes = {};
+
+      classes['disabled'] = this.disabled;
+      classes['pin'] = this.pin;
+      classes['snaps'] = this.snaps;
+      classes['ring'] = this.immediateValue <= this.min;
+      classes['expand'] = this.expand;
+      classes['dragging'] = this.dragging;
+      classes['transiting'] = this.transiting;
+      classes['editable'] = this.editable;
+
+      return Object.keys(classes).filter(
+        function(className) {
+          return classes[className];
+        }).join(' ');
     },
 
-    incrementKey: function(ev, keys) {
-      if (keys.key === "end") {
+    _incrementKey: function(ev, keys) {
+      if (keys.key === 'end') {
         this.value = this.max;
       } else {
         this.increment();
@@ -357,16 +437,13 @@ To change the slider secondary progress bar color:
       this.fire('change');
     },
 
-    decrementKey: function(ev, keys) {
-      if (keys.key === "home") {
+    _decrementKey: function(ev, keys) {
+      if (keys.key === 'home') {
         this.value = this.min;
       } else {
         this.decrement();
       }
       this.fire('change');
     }
-
-  });
-
+  })
 </script>
-</polymer-element>