Skip to content
Simple star rating system bars, a view similar to the ones seen on Google Playstore. ⭐🌟✨
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create PULL_REQUEST_TEMPLATE.md Feb 24, 2019
app add screenshot Mar 5, 2019
gradle/wrapper initial library Feb 20, 2019
reviewratings update contributors Mar 5, 2019
screenshots add screenshot Mar 5, 2019
.gitignore initial library Feb 20, 2019
CHANGELOG.md update changelog and gradient colors on activity Mar 5, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Feb 24, 2019
CONTRIBUTING.md Create CONTRIBUTING.md Feb 24, 2019
CONTRIBUTORS.md
LICENSE Initial commit Feb 20, 2019
README.md edited README.md for clarity and grammar Mar 22, 2019
build.gradle initial library Feb 20, 2019
gradle.properties initial library Feb 20, 2019
gradlew initial library Feb 20, 2019
gradlew.bat initial library Feb 20, 2019
settings.gradle initial library Feb 20, 2019

README.md

RatingReviews


Android Arsenal

RatingReviews (Rating and Reviews) is a widget and layout that adds a "Rating & Reviews" bar to your app, similar to the ones seen on Google Play Store and Apple App Store. It provides a beautiful visual summary of the number of raters along with the ratings they gave on a specific item. Of course, it is also highly customizable to fit your app themes! ⭐🌟✨

Screenshots

playstore (style1) appstore (style2) playstore (new rounded) customized (style2)
gradient (rounded) gradient playstore (old)

All of these samples can be found in app

You can also:

  • Take an existing style and customise it to be your desired style.
  • Add gradient colors to the bar and add an array of pairs to the colors parameter in your code. See the sample for more details.

Installation

Make sure your project is migrated to AndroidX.

In your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

In your app build.gradle:

implementation 'com.github.Inconnu08:android-ratingreviews:1.2.0'

Usage

Using RatingReviews is simple. Here is an example:

java

        RatingReviews ratingReviews = (RatingReviews) findViewById(R.id.rating_reviews);

        int colors[] = new int[]{
                Color.parseColor("#0e9d58"),
                Color.parseColor("#bfd047"),
                Color.parseColor("#ffc105"),
                Color.parseColor("#ef7e14"),
                Color.parseColor("#d36259")};

        int raters[] = new int[]{
                new Random().nextInt(100),
                new Random().nextInt(100),
                new Random().nextInt(100),
                new Random().nextInt(100),
                new Random().nextInt(100)
        };

        ratingReviews.createRatingBars(100, BarLabels.STYPE1, colors, raters);

xml

    <com.taufiqrahman.reviewratings.RatingReviews
        xmlns:bar="http://schemas.android.com/apk/res-auto"
        android:id="@+id/rating_reviews"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="42dp"
        android:layout_marginTop="8dp"
        android:layout_marginBottom="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toEndOf="@+id/textView"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.499"
        bar:animation="true"
        bar:max_value="100"
        bar:show_label="true"
        bar:spaces="0dp"
        bar:text_color="#333333"
        bar:text_size="10sp"
        bar:width="15dp" />

Specification

The table below shows the parameters and the attributes for furthur customization:

Attribute Description Options (examples)
animation of the bars from left to right true, false
show_label of the bars for example: 1, 2, 3, 4, 5 STYPE1, STYPE2, STYPE3, STYPE4
max_value max value for the ratings 100 etc
text_color color of the texts for example the labels color int
text_size text size of labels 10sp, 12sp etc
width bar width 8dp, 15dp etc
spaces space between bars 1sp, 2dp etc
rounded round corners of bars true, false

Contribution

Want to contribute? Fantastic!

If you want to contribute to the project and make it better (whether it's a bug fix, feature, improvement, suggestion, documentation or any sort of help), your help is very welcomed! ❀

Todos

  • Optimization

Check issues

Motivation

There was no visual 5 star rating system when I needed it for a project. Special thanks to the chart libraries where I took some inspiration from.

License

   Copyright (C) 2019 Taufiq Rahman
   Copyright (C) 2018 Android Open Source Project

   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.
Built with ❀︎ by Taufiq Rahman and contributors
You can’t perform that action at this time.