Blame view

bower_components/paper-behaviors/paper-ripple-behavior.html 3.8 KB
eb240478   Luigi Serra   public room cards...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
  <!--
  @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-ripple/paper-ripple.html">
  
  <script>
  
    /**
     * `Polymer.PaperRippleBehavior` dynamically implements a ripple
     * when the element has focus via pointer or keyboard.
     *
     * NOTE: This behavior is intended to be used in conjunction with and after
     * `Polymer.IronButtonState` and `Polymer.IronControlState`.
     *
     * @polymerBehavior Polymer.PaperRippleBehavior
     */
    Polymer.PaperRippleBehavior = {
  
      properties: {
        /**
         * If true, the element will not produce a ripple effect when interacted
         * with via the pointer.
         */
        noink: {
          type: Boolean,
          observer: '_noinkChanged'
        },
  
        /**
         * @type {Element|undefined}
         */
        _rippleContainer: {
          type: Object,
        }
      },
  
      /**
       * Ensures a `<paper-ripple>` element is available when the element is
       * focused.
       */
      _buttonStateChanged: function() {
        if (this.focused) {
          this.ensureRipple();
        }
      },
  
      /**
       * In addition to the functionality provided in `IronButtonState`, ensures
       * a ripple effect is created when the element is in a `pressed` state.
       */
      _downHandler: function(event) {
        Polymer.IronButtonStateImpl._downHandler.call(this, event);
        if (this.pressed) {
          this.ensureRipple(event);
        }
      },
  
      /**
       * Ensures this element contains a ripple effect. For startup efficiency
       * the ripple effect is dynamically on demand when needed.
       * @param {!Event=} opt_triggeringEvent (optional) event that triggered the
       * ripple.
       */
      ensureRipple: function(opt_triggeringEvent) {
        if (!this.hasRipple()) {
          this._ripple = this._createRipple();
          this._ripple.noink = this.noink;
          var rippleContainer = this._rippleContainer || this.root;
          if (rippleContainer) {
            Polymer.dom(rippleContainer).appendChild(this._ripple);
          }
          var domContainer = rippleContainer === this.shadyRoot ? this :
            rippleContainer;
          if (opt_triggeringEvent) {
            var target = opt_triggeringEvent.target;
            if (domContainer.contains(/** @type {Node} */(target))) {
              this._ripple.uiDownAction(opt_triggeringEvent);
            }
          }
        }
      },
  
      /**
       * Returns the `<paper-ripple>` element used by this element to create
       * ripple effects. The element's ripple is created on demand, when
       * necessary, and calling this method will force the
       * ripple to be created.
       */
      getRipple: function() {
        this.ensureRipple();
        return this._ripple;
      },
  
      /**
       * Returns true if this element currently contains a ripple effect.
       * @return {boolean}
       */
      hasRipple: function() {
        return Boolean(this._ripple);
      },
  
      /**
       * Create the element's ripple effect via creating a `<paper-ripple>`.
       * Override this method to customize the ripple element.
       * @return {!PaperRippleElement} Returns a `<paper-ripple>` element.
       */
      _createRipple: function() {
        return /** @type {!PaperRippleElement} */ (
            document.createElement('paper-ripple'));
      },
  
      _noinkChanged: function(noink) {
        if (this.hasRipple()) {
          this._ripple.noink = noink;
        }
      }
  
    };
  
  </script>