Skip to content
A rating toggle for Android which switches between 3 rating levels: positive, neutral, and negative.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper Update config Aug 16, 2015
library [r] Code refactoring May 25, 2016
sample Add a proper launcher icon for the sample Nov 25, 2014
.gitignore Initial commit Nov 25, 2014
README.md Fix broken markdown in README Mar 23, 2017
build.gradle Update config Aug 16, 2015
gradle.properties Bump version Aug 16, 2015
gradlew Initial commit Nov 25, 2014
gradlew.bat Initial commit Nov 25, 2014
maven_push.gradle Add maven upload related files Nov 25, 2014
settings.gradle

README.md

Android Arsenal

SimpleRatingView

A rating toggle for Android which switches between 3 rating levels: positive, neutral, and negative.

simpleratingview

Usage

Since, SimpleRatingView is pushed to the Maven Central repository, all you have to do is to add the following line to your dependencies.

dependencies {
    compile 'com.github.xiprox.simpleratingview:library:+'
}

Once you have the library added as a dependency to your project, you can start with including the view in your layout:

<tr.xip.widget.simpleratingview.SimpleRatingView xmlns:srv="http://schemas.android.com/apk/res-auto"
    android:id="@+id/simple_rating_view"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

You can also customize SimpleRatingView by telling it to display the icons you want, in the color you want. The following xml attributes will allow you to set the icons for different rating levels.

    srv:srv_positiveIcon="@drawable/rating_positive"
    srv:srv_neutralIcon="@drawable/rating_neutral"
    srv:srv_negativeIcon="@drawable/rating_negative"

As for a custom color, you'll need to insert the following attribute:

    srv:srv_iconColor="@color/my_rating_icon_color"

On the Java side, all you have to do is catching rating changes from the view:

mSimpleRatingView = (SimpleRatingView) findViewById(R.id.simple_rating_view);
mSimpleRatingView.setOnRatingChangedListener(new SimpleRatingView.OnRatingChangeListener() {
    @Override
    public void onRatingChanged(SimpleRatingView.Rating ratingType) {
        switch (ratingType) {
            case POSITIVE:
                // Do something
                break;
            case NEUTRAL:
                // Do something
                break;
            case NEGATIVE:
                // Do something
                break;
        }
    }
});

Of course, you can directly set the rating too.

setSelectedRating(Rating rating)

And lastly, all customization can be applied programmatically too:

setIconColor(int color)
setIconColor(Resources res, int color) // Set the icon color to a color resource
setPositiveIconResource(int res)
setPositiveIconDrawable(Drawable drawable)
setNeutralIconResource(int res)
setNeutralIconDrawable(Drawable drawable)
setNegativeIconResource(int res)
setNegativeIconDrawable(Drawable drawable)

Sample App

Get it on Google Play

License

Copyright (C) 2014 Ihsan Isik

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.
You can’t perform that action at this time.