SimpleRatingBar

Additional

Language
Java
Version
v0.1.5 (Dec 22, 2016)
Created
Jul 29, 2016
Updated
May 14, 2020 (Retired)
Owner
Iván Arcuschin Moreno (FlyingPumba)
Contributors
Samantha Ching (wching)
John Carlson (Jawnnypoo)
Iván Arcuschin Moreno (FlyingPumba)
3
Activity
Badge
Generate
Download
Source code

SimpleRatingBar

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

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:

<com.iarcuschin.simpleratingbar.SimpleRatingBar
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:srb_starSize="40dp"
        app:srb_numberOfStars="5"
        app:srb_rating="3"
        app:srb_stepSize="0.5"
        app:srb_borderColor="@color/blue"
        app:srb_fillColor="@color/light_blue"
        />

More examples in the sample app layouts.

Example of setting rating with animation:

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:

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

Using Gradle from Maven Central:

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

Using Gradle from JitPack:

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

Using Maven:

<dependency>
  <groupId>com.iarcuschin</groupId>
  <artifactId>simpleratingbar</artifactId>
  <version>0.1.5</version>
  <type>apklib</type>
</dependency>

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.