Ecosyste.ms: Awesome

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

https://github.com/FlyingPumba/SimpleRatingBar

Open source project which features a simple yet powerful RatingBar alternative to Android's default
https://github.com/FlyingPumba/SimpleRatingBar

Last synced: 1 day ago
JSON representation

Open source project which features a simple yet powerful RatingBar alternative to Android's default

Lists

README

        

SimpleRatingBar
====

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-%20SimpleRatingBar-green.svg?style=true)](https://android-arsenal.com/details/1/4027)
[![API](https://img.shields.io/badge/API-11%2B-green.svg?style=true)](https://android-arsenal.com/api?level=11)
[![License](https://img.shields.io/badge/License-Apache%202-blue.svg)](https://github.com/FlyingPumba/SimpleRatingBar/blob/master/LICENSE.txt)

[![JCenter](https://api.bintray.com/packages/flyingpumba/maven/simpleratingbar/images/download.svg) ](https://bintray.com/flyingpumba/maven/simpleratingbar/_latestVersion)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.iarcuschin/simpleratingbar/badge.svg) ](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22simpleratingbar%22%20g%3A%22com.iarcuschin%22)
[![JitPack](https://jitpack.io/v/FlyingPumba/SimpleRatingBar.svg)](https://jitpack.io/#FlyingPumba/SimpleRatingBar)

Open source project which features a simple yet powerful RatingBar alternative to Android's default.

![](images/sample.gif)

Features
----
* Fully working `android:layout_width`: it can be set to `wrap_content`, `match_parent` or abritary dp.
* Arbitrary number of stars.
* Arbitrary step size.
* Size of stars can be controlled exactly or by setting a maximum size.
* Customizable colors in normal state (border, fill and background of stars and rating bar).
* Customizable colors in pressed state (border, fill and background of stars and rating bar).
* Customizable size separation between stars.
* Customizable border width of stars.
* Customizable stars corner radius.
* Allows to set OnRatingBarChangeListener and OnClickListener
* Stars fill can be set to start from left to right or from right to left (RTL language support).
* AnimationBuilder integrated in the view to set rating programatically with animation.

Usage
----

In your layout file:

```xml

```

More examples in the [sample app layouts](https://github.com/FlyingPumba/SimpleRatingBar/blob/master/simpleratingbar-sample/src/main/res/layout).

Example of setting rating with animation:

```java
SimpleRatingBar.AnimationBuilder builder = myRatingBar.getAnimationBuilder()
.setRatingTarget(3)
.setDuration(2000)
.setInterpolator(new BounceInterpolator());
builder.start();
```

Configuration
----
The view can be configured as follows:

* Set the number of stars with `app:srb_numberOfStars` / `setNumberOfStars(int)`
* Set the rating with `app:srb_rating` / `setRating(float)`
* Set step size with `app:srb_stepSize` / `setStepSize(float)`
* Set star size with `app:srb_starSize` / `setStarSize(float)`
* Set max star size with `app:srb_maxStarSize` / `setMaxStarSize(float)`
* Set separation between stars with `app:srb_starsSeparation` / `setStarsSeparation(float)`
* Set border width with `app:srb_starBorderWidth` / `setStarBorderWidth(float)`
* Set stars corner radius with `app:srb_starCornerRadius` / `setStarCornerRadius(float)`
* Set stars border color in normal state with `app:srb_borderColor` / `setBorderColor(@ColorInt int)`
* Set stars fill color in normal state with `app:srb_fillColor` / `setFillColor(@ColorInt int)`
* Set stars background color in normal state with `app:srb_starBackgroundColor` / `setStarBackgroundColor(@ColorInt int)`
* Set background color of rating bar in normal state with `app:srb_backgroundColor` / `setBackgroundColor(@ColorInt int)`
* Set stars border color in pressed state with `app:srb_pressedBorderColor` / `setPressedBorderColor(@ColorInt int)`
* Set stars fill color in pressed state with `app:srb_pressedFillColor` / `setPressedFillColor(@ColorInt int)`
* Set stars background color in pressed state with `app:srb_pressedStarBackgroundColor` / `setPressedStarBackgroundColor(@ColorInt int)`
* Set background color of rating bar in pressed state with `app:srb_pressedBackgroundColor` / `setPressedBackgroundColor(@ColorInt int)`
* Enabled/disable user interaction with `app:srb_isIndicator` / `setIsIndicator(boolean)`
* Enabled/disable border of star with `app:srb_drawBorderEnabled` / `setDrawBorderEnabled(boolean)`
* Set gravity of fill (left or right) with `app:srb_gravity` / `setGravity(Gravity)`

Download
----

Using `Gradle` from `jcenter`:

```groovy
repositories {
jcenter()
}
dependencies {
compile 'com.iarcuschin:simpleratingbar:0.1.5'
}
```

Using `Gradle` from `Maven Central`:

```groovy
repositories {
mavenCentral()
}
dependencies {
compile 'com.iarcuschin:simpleratingbar:0.1.5'
}
```

Using `Gradle` from `JitPack`:

```groovy
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compile 'com.github.FlyingPumba:SimpleRatingBar:v0.1.5'
}
```

Using `Maven`:
```xml

com.iarcuschin
simpleratingbar
0.1.5
apklib

```

License
----
Copyright 2016 Iván Arcuschin

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.