Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/varunest/sparkbutton

Android library to create buttons with Twitter's heart like animation.
https://github.com/varunest/sparkbutton

android animation enhancement java library twitter-heart-animation ui

Last synced: 7 days ago
JSON representation

Android library to create buttons with Twitter's heart like animation.

Awesome Lists containing this project

README 

        

[![platform](https://img.shields.io/badge/platform-Android-yellow.svg)](https://www.android.com)

[![API](https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=14)

[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?style=flat-square)](https://www.apache.org/licenses/LICENSE-2.0.html)

[![](https://jitpack.io/v/varunest/sparkbutton.svg)](https://jitpack.io/#varunest/sparkbutton)

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-SparkButton-red.svg?style=flat)](http://android-arsenal.com/details/1/3876)

[![Build Status](https://travis-ci.org/varunest/SparkButton.svg?branch=master)](https://travis-ci.org/varunest/SparkButton)



# SparkButton

Highly customizable and lightweight library that allows you to create a button with animation effect similar to Twitter's heart animation.



Library supports OS on API 14 and above.



![Showcase Video](art/showcase.gif)



Grab the above demo app from here :



[![Get it on Google Play](https://play.google.com/intl/en_us/badges/images/badge_new.png)](https://play.google.com/store/apps/details?id=com.varunest.sample.sparkbutton)



## Dependency



Add it in your root build.gradle at the end of repositories:



```groovy

allprojects {

	repositories {

		...

		maven { url "https://jitpack.io" }

	}

}

```	

and then add dependency



```groovy

dependencies {

	compile 'com.github.varunest:sparkbutton:1.0.6'

}

```



## Usage



### XML



```xml



```



### Java



```java

SparkButton button  = new SparkButtonBuilder(context)

                .setActiveImage(R.drawable.active_image)

                .setInActiveImage(R.drawable.inactive_image)

                .setDisabledImage(R.drawable.disabled_image)

                .setImageSizePx(getResources().getDimensionPixelOffset(R.dimen.button_size))

                .setPrimaryColor(ContextCompat.getColor(context, R.color.primary_color))

                .setSecondaryColor(ContextCompat.getColor(context, R.color.secondary_color))

                .build();

```



### Attributes



```xml



```



## Documentation

To use SparkButton simply include XML script or build it using SparkButtonBuilder as stated above.



Various attributes that you can control are following: 



### Button Image and Colors

You can specify both active and inactive image of the button. If only active image is specified SparkButton will behave as a normal button, otherwise as a switch.



SparkButton takes two colors primary and secondary. (It is recommended that primary color is lighter than secondary for better results).



#### XML

```xml

app:sparkbutton_activeImage="@drawable/active_image"

app:sparkbutton_inActiveImage="@drawable/inactive_image"

app:sparkbutton_primaryColor="@color/primaryColor"

app:sparkbutton_secondaryColor="@color/secondaryColor"

```

#### Java

```java

SparkButton button = new SparkButtonBuilder(context)

						.setActiveImage(R.drawable.active_image)

						.setInActiveImage(R.drawable.inactive_image)

						.setPrimaryColor(ContextCompat.getColor(context, R.color.primary_color))

						.setSecondaryColor(ContextCompat.getColor(context, R.color.secondary_color))

						.build();

```



### Animation Speed

You can specify the fraction by which the animation speed should increase/decrease.



#### XML

```xml

app:sparkbutton_animationSpeed="1.5"

```



#### Java

```java

sparkbutton.setAnimationSpeed(1.5f);

```



### Button State

If you are using the SparkButton as a switch, you can 

check/uncheck the button



```java

sparkButton.setChecked(true);

```



### Event Listener



Simply call setEventListener to listen click events. 



```java

sparkButton.setEventListener(new SparkEventListener(){

		@Override

		void onEvent(ImageView button, boolean buttonState) {

			if (buttonState) {

				// Button is active

			} else {

				// Button is inactive

			}

		}

});

```



### Play Animation

If you want to play animation regardless of click event execute following function:



```java

sparkButton.playAnimation();

```



## Advanced

* 	There can be a situation when you don't want the button to 	scale download when pressed or consume touch. You can 	avoid this by calling the following function :



	```java

	sparkButton.pressOnTouch(false);

	```



* 	If you are using SparkButton between layout hierarchy, it 	can result in **animation getting cropped**. To avoid this 	cropping of the animation, set `clipChildren` and 	`clipToPadding` XML attribute of all the parent views 

	to `false`.



* 	You can view examples of few custom buttons in the [sample 	app](app).



## Inspiration

SparkButton was inspired by : [https://github.com/frogermcs/LikeAnimation](https://github.com/frogermcs/LikeAnimation)



## Contribution

Any contributions, large or small, features, bug fixes are welcomed and appreciated. Use pull requests, they will be thoroughly reviewed and discussed.



## Link Backs

If you are using this library in one of your projects and want it to be mentioned here in this ReadME, drop me a mail with project's url at [email protected].



## License

Library falls under [Apache 2.0] (LICENSE.md)