Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ArtemNurtdinov/RatingView
Android view for showing rating or quiz results
https://github.com/ArtemNurtdinov/RatingView
Last synced: 9 days ago
JSON representation
Android view for showing rating or quiz results
- Host: GitHub
- URL: https://github.com/ArtemNurtdinov/RatingView
- Owner: ArtemNurtdinov
- Created: 2018-01-26T10:10:30.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-03T09:12:15.000Z (over 6 years ago)
- Last Synced: 2024-08-02T19:33:07.174Z (4 months ago)
- Language: Java
- Size: 136 KB
- Stars: 12
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-list - ArtemNurtdinov/RatingView - Android view for showing rating or quiz results (Java)
README
# RatingView
Example:
Android view for showing rating or quiz results
Connecting
----------
Add next dependency in your project:
`com.nefrit:ratingview:1.0.2`
For example, your gradle script will contains such dependencies:
```
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:20.0.0'
compile 'com.nefrit:inputprogressview:1.0.2'
}
```
Connecting via downloading
----------
You can add the library to your project using Gradle.
1) Copy the **RatingView** directory to your project's directory;
2) Find the **settings.gradle** file. Most likely, it contains something like that:
```gradle
include ':app'
```
Edit the line this way:
```gradle
include ':app', ':ratingview'
```
3) Add this line to your dependencies in your app's gradle:
```gradle
compile project(':ratingview')
```
### Usage
Add `RatingView` to your layout:
```xml
```
You can also add `RatingView` via constuctor:
```java
RatingView ratingView = new RatingView(context);
List scales = new ArrayList<>();
scales.add(new Scale("Yes", 492, getResources().getColor(R.color.mark_green)));
scales.add(new Scale("No", 224, getResources().getColor(R.color.mark_red)));
scales.add(new Scale("Neutral", 7, getResources().getColor(R.color.mark_yellow)));
ratingView.setScales(scales);
container.addView(ratingView);
```
### Class Scale
You'll need at least one `Scale` object to make your `RatingView` works.
Then set scales to your `RatingView` using method:
```java
List scales = new ArrayList<>();
scales.add(new Scale("5", 172, getResources().getColor(R.color.mark_green)));
scales.add(new Scale("4", 42, getResources().getColor(R.color.mark_light_green)));
scales.add(new Scale("3", 7, getResources().getColor(R.color.mark_yellow)));
scales.add(new Scale("2", 2, getResources().getColor(R.color.mark_orange)));
scales.add(new Scale("1", 3, getResources().getColor(R.color.mark_red)));
ratingView.setScales(scales);
```
Result:
`RatingView` transforms every `Scale` to `RatingItemView`. See below.
### RatingItemView
You can get `RatingItemView` from your `RatingView` using:
```java
RatingItemView ratingItemView = ratingView.getRatingItem(position);
ratingItemView.setProgressColor(Color.RED); // Change progress color
ratingItemView.setMarksValue("Cool"); // Change mark text
ratingItemView.setScale(scale); // Change the whole scale (mark text, marks count and progress color)
```
### OnClickListener
You can set `OnScaleClickListener` for each `RatingItemView` in your `RatingView`
```java
ratingView1.setOnScaleClickListener(new RatingView.OnScaleClickListener() {
@Override
public void onClick(RatingItemView ratingItemView) {
// You can get your scale object from clicked view
Scale scale = ratingItemView.getScale();
Log.d("mylog", "clicked " +scale.getMark() +" with value: " +scale.getCount());
}
});
```
### OnLongClickListener
The same situation as `OnClickListener`
```java
ratingView1.setOnScaleLongClickListener(new RatingView.OnScaleLongClickListener() {
@Override
public void onClick(RatingItemView ratingItemView) {
Scale scale = ratingItemView.getScale();
Log.d("mylog", "long clicked " +scale.getMark() +" with value: " +scale.getCount());
}
});
```
Take a look at the [sample project](sample) for more information.