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