Any issues or pull requests will not be addressed. Please consider forking your own version if changes are needed.
Ripple effect wrapper for Android Views
compile 'com.balysv:material-ripple:1.0.2'Check for latest version number on the widget below or visit Releases
Use static initializer on your View (see xml attributes below for customization)
MaterialRippleLayout.on(view) .rippleColor(Color.BLACK) .create();Or wrap your View with MaterialRippleLayout in your layout file:
<com.balysv.materialripple.MaterialRippleLayout android:id="@+id/ripple"android:layout_width="match_parent"android:layout_height="wrap_content"> <Buttonandroid:layout_width="match_parent"android:layout_height="wrap_content"android:layout_gravity="center"android:text="Button inside a ripple"/> </com.balysv.materialripple.MaterialRippleLayout>If using in an AdapterView you must set rippleInAdapter to true
Configure using xml attributes or setters in code:
app:mrl_rippleOverlay="true"// if true, ripple is drawn in foreground; false - backgroundapp:mrl_rippleColor="#ff0000"// color of rippleapp:mrl_rippleAlpha="0.1"// alpha of rippleapp:mrl_rippleDimension="10dp"// radius of hover and starting rippleapp:mrl_rippleHover="true"// if true, a hover effect is drawn when view is touchedapp:mrl_rippleRoundedCorners="10dp"// radius of corners of ripples. Note: it uses software rendering pipeline for API 17 and belowapp:mrl_rippleInAdapter="true"// if true, MaterialRippleLayout will optimize for use in AdapterViewsapp:mrl_rippleDuration="350"// duration of ripple animationapp:mrl_rippleFadeDuration="75"// duration of fade out effect on rippleapp:mrl_rippleDelayClick="true"// if true, delays calls to OnClickListeners until ripple effect endsapp:mrl_rippleBackground="#FFFFFF"// background under ripple drawable; used with rippleOverlay="false"app:mrl_ripplePersistent="true"// if true, ripple background color persists after animation, until setRadius(0) is calledSet an OnClickListener to MaterialRippleLayout:
findViewById(R.id.ripple).setOnClickListener(newView.OnClickListener(){@OverridepublicvoidonClick(Viewv){// handle me } });Or if using in an AdapterView, simply use OnItemClickListener
For those unlucky developers that need to support older versions than 14, there's a way to do it.
You can use this library in addition with Jake Wharton's animation backport (http://nineoldandroids.com/) changing the imports from import android.animation.*; to: import com.nineoldandroids.animation.*; , import android.util.Property; to import com.nineoldandroids.util.Property; and in MaterialRippleLayout.java file, calling function shouldDelayChildPressedState() only if you're using api greater than 14.
Balys Valentukevicius
Copyright 2015 Balys Valentukevicius Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.