Ecosyste.ms: Awesome

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

https://github.com/ChadCSong/ShineButton

This is a UI lib for Android. Effects like shining.
https://github.com/ChadCSong/ShineButton

button custom effects

Last synced: 1 day ago
JSON representation

This is a UI lib for Android. Effects like shining.

Lists

README

        

# ShineButton
[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ChadCSong/ShineButton/raw/master/LICENSE)
[![platform](https://img.shields.io/badge/platform-Android-yellow.svg)](https://www.android.com)
[![Build Status](https://travis-ci.org/ChadCSong/ShineButton.svg?branch=master)](https://travis-ci.org/ChadCSong/ShineButton)
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-ShineButton-green.svg?style=true)](https://android-arsenal.com/details/1/3846)
[![API](https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=14)

This is a UI lib for Android. Effects like shining.

![preview](https://github.com/ChadCSong/ShineButton/blob/master/image/demo_shine_others.gif)

## Usage
```java
shineButton = (ShineButton) findViewById(R.id.shine_button);
shineButton.init(activity);
```
or

```java
ShineButton shineButtonJava = new ShineButton(this);
shineButtonJava.setBtnColor(Color.GRAY);
shineButtonJava.setBtnFillColor(Color.RED);
shineButtonJava.setShapeResource(R.raw.heart);
shineButtonJava.setAllowRandomColor(true);
LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(100, 100);
shineButtonJava.setLayoutParams(layoutParams);
if (linearLayout != null) {
linearLayout.addView(shineButtonJava);
}
```
#### Simple Usage

Icon shape is made from png mask. Please see raw files.
```shell
app:siShape
```

Default button color.
```shell
app:btn_color
```
Fill button color.
```shell
app:btn_fill_color
```
If this property is true,the effects will become random color shine.
```shell
app:allow_random_color
```

![preview](https://github.com/ChadCSong/ShineButton/blob/master/image/demo_small.gif)

```xml

```
#### Complex Usage

| Property | Java method | Description |
| ------------------------ | ------------------------------------ | -------------------------------------------- |
| siShape | void setShapeResource(int) | Set raw resource (png) |
| btn_color | void setBtnColor(int) | Set origin color |
| btn_fill_color | void setBtnFillColor(int) | Set fill color after click |
| allow_random_color | void setAllowRandomColor(boolean) | Allow shine color random |
| shine_animation_duration | void setAnimDuration(int) | Set shine anim duration |
| big_shine_color | void setBigShineColor(int) | Set big shine color |
| click_animation_duration | void setClickAnimDuration(int) | Set click anim duration |
| enable_flashing | void enableFlashing(boolean) | Enable effect like flash |
| shine_count | void setShineCount(int) | Set shine count around button |
| shine_distance_multiple | void setShineDistanceMultiple(float) | Set multiple of distance to button |
| shine_turn_angle | void setShineTurnAngle(float) | Set turn angle of shine |
| shine_size | void setShineSize(int) | Set size of shine by pixel |
| small_shine_color | void setSmallShineColor(int) | Set small shine color |
| small_shine_offset_angle | void setSmallShineOffAngle(float) | Set angle offset of small shine to big shine |

```shell
app:shine_turn_angle="20"
app:shine_count="15"
app:allow_random_color="true"
app:enable_flashing="true"
```
![preview](https://github.com/ChadCSong/ShineButton/blob/master/image/demo_shine_others.gif)

```xml

```

### Support Dialog

When use button on a Dialog

```java
shineButton.setFixDialog(dialog);

```
Easy to support.

## Requirements

- Android 4.0+

## Code Reference

[android-shape-imageview](https://github.com/siyamed/android-shape-imageview)
[EasingInterpolator](https://github.com/MasayukiSuda/EasingInterpolator)

## Maven

```xml

com.sackcentury
shinebutton
1.0.0
aar

```
## Gradle

```gradle
buildscript {
repositories {
mavenCentral()
}
}
dependencies {
compile 'com.sackcentury:shinebutton:1.0.0'
}
```

##

## Credits

iOS lib [fave-button](https://github.com/xhamr/fave-button) Android implement.
FaveButton was inspired by Twitter’s Like Heart Animation;

## Third Party Bindings

### React Native
You may now use this library with [React Native](https://github.com/facebook/react-native) via the module [here](https://github.com/prscX/react-native-shine-button)

License
------------
The MIT License (MIT)

Copyright (c) 2016 Chad Song

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.