RatingReviews
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
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.
![[ImgBot] Optimize images](https://avatars.githubusercontent.com/in/4706?v=4)
742 Jan 7, 2023
106 Nov 22, 2022
30 Sep 20, 2022
112 Jan 8, 2023
5 Jul 28, 2022
8 Jan 4, 2023
17 Dec 31, 2022
1.1k Dec 22, 2022
166 Nov 25, 2022
0 Jan 31, 2022
5 Dec 20, 2022
9 Dec 21, 2022
555 Nov 25, 2022
18 Sep 2, 2022
4 May 25, 2022
5 Dec 13, 2022
249 Sep 10, 2022
1.3k Nov 29, 2022