<!-- @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>