RippleBackground Library

Beautiful ripple animation

License	MIT
GroupId	com.skyfishjy.ripplebackground
ArtifactId	library
Last Version	1.0.1
Release Date	Nov 8, 2014
Type	aar
Description	RippleBackground Library Beautiful ripple animation
Project URL	https://github.com/skyfishjy/android-ripple-background
Source Code Management	https://github.com/skyfishjy/android-ripple-background

Download library

Filename	Size
library-1.0.1.pom
library-1.0.1.aar	5 KB
library-1.0.1-sources.jar	2 KB
library-1.0.1-javadoc.jar	36 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.skyfishjy.ripplebackground/library/ -->
<dependency>
    <groupId>com.skyfishjy.ripplebackground</groupId>
    <artifactId>library</artifactId>
    <version>1.0.1</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.skyfishjy.ripplebackground/library/
implementation 'com.skyfishjy.ripplebackground:library:1.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.skyfishjy.ripplebackground/library/
implementation ("com.skyfishjy.ripplebackground:library:1.0.1")

Apache Buildr

'com.skyfishjy.ripplebackground:library:aar:1.0.1'

Apache Ivy

<dependency org="com.skyfishjy.ripplebackground" name="library" rev="1.0.1">
  <artifact name="library" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.skyfishjy.ripplebackground', module='library', version='1.0.1')
)

Scala SBT

libraryDependencies += "com.skyfishjy.ripplebackground" % "library" % "1.0.1"

Leiningen

[com.skyfishjy.ripplebackground/library "1.0.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Android Ripple Background

A beautiful ripple animation for your app. You can easily change its color, speed of wave, one ripple or multiple ripples. See demo below.

　　　　　　

##Usage

###Step 1

####Install with Gradle

dependencies {
        compile 'com.skyfishjy.ripplebackground:library:1.0.1'
}

###Step 2 ####RippleBackground

Add RippleBackground to your layout with content you want, like an ImageView. Configure the view customization elements using styleable attributes.

<com.skyfishjy.library.RippleBackground
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/content"
    app:rb_color="#0099CC"
    app:rb_radius="32dp"
    app:rb_rippleAmount="4"
    app:rb_duration="3000"
    app:rb_scale="6">
    <ImageView
        android:layout_width="64dp"
        android:layout_height="64dp"
        android:layout_centerInParent="true"
        android:id="@+id/centerImage"
        android:src="@drawable/demoImage"/>
</com.skyfishjy.library.RippleBackground>

Start animation:

    final RippleBackground rippleBackground=(RippleBackground)findViewById(R.id.content);
    ImageView imageView=(ImageView)findViewById(R.id.centerImage);
    imageView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            rippleBackground.startRippleAnimation();
        }
    });

Stop animation:

    rippleBackground.stopRippleAnimation();

##Theming

• app:rb_color [color def:@android:color/holo_blue_dark] --> Color of the ripple
• app:rb_radius [dimension def:64dp ] --> Radius of the ripple
• app:rb_duration [integer def:3000 ] --> Duration of one ripple animation (millisecond)
• app:rb_rippleAmount [integer def:6] --> Max amount of ripples at one screen
• app:rb_scale [interger def:6] --> Scale of ripple at the end of one animation cycle
• app:rb_type [enum (fillRipple, strokeRipple) def:fillRipple] --> Filled circle or ring
• app:rb_strokeWidth [dimension def:2dp] --> Stroke width of the ripple, ONLY work when rb_type="strokeRipple"

Versions

Version
1.0.1 Nov 8, 2014
1.0.0 Nov 7, 2014