https://github.com/mohakapt/ratingstar-ios
A nice-looking new concept for rating bars implemented for iOS.
https://github.com/mohakapt/ratingstar-ios
ios ios-swift rating rating-stars rating-views
Last synced: 7 months ago
JSON representation
A nice-looking new concept for rating bars implemented for iOS.
- Host: GitHub
- URL: https://github.com/mohakapt/ratingstar-ios
- Owner: mohakapt
- License: apache-2.0
- Created: 2018-08-18T13:37:27.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-27T09:03:27.000Z (about 7 years ago)
- Last Synced: 2025-02-26T16:53:13.679Z (7 months ago)
- Topics: ios, ios-swift, rating, rating-stars, rating-views
- Language: Swift
- Homepage:
- Size: 433 KB
- Stars: 8
- Watchers: 6
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rating Star
> A nice-looking new concept for rating bars implemented for iOS.
[](https://cocoapods.org/pods/RatingStar)
[](https://cocoapods.org/pods/RatingStar)
[](https://github.com/mohakapt/ratingstar-ios/issues)
[](https://cocoapods.org/pods/RatingStar)
The concept looks like a flower with every petal representing a specific rating.
*The idea of this project is originally inspired by this [concept](https://goo.gl/Yn2CCh).*
### Installation
RatingStar is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'RatingStar'
```
For an Android implementation please check this [repository](https://github.com/mohakapt/ratingstar-android).
### Usage
* Please check the example in the source code for more detailed information, or check the table below for a list of available properties.
* If you want to use storyboards, just drop a UIView into your ViewController and set its class to `UIRatingStar`. Then customize is through the attributes in the inspector.
* If you don't use storyboards, you need to write a few lines of code to initialize with frame and set the properties:
```swift
import RatingStar
let starColor: UIColor = .blue
let selectionColor: UIColor = .orange
let ratingStar = UIRatingStar(frame: CGRect(x: 0, y: 0, width: 200, height: 200))
ratingStar.value = 3
ratingStar.unselectedColor = starColor
ratingStar.selectedColor = selectionColor
self.view.addSubview(ratingStar)
```
* List of available properties:
|Property Name|Default Value|Description|
|---|---|---|
|value|0|The initial rating of the view.|
|starColor|#007AFF|The color of the star.|
|selectionColor|#FFAF00|The color of selected petals of the star.|
|showNumbers|true|Determines weather to show numbers on the petals of the star.|
## Roadmap
The library is still not as elegant as the original concept, so I might work more on adding some animations in my spare time. (But unfortunately since I have another job, I can't give any promises or deadlines).
## Contributing
If you encounter a bug or you have a feature in mind please make a pull request and i will merge it as soon as possible, if you can't (for some reason) make a pull request please open an issue and i will happily do respond to it.
## Versioning
I use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/mohakapt/ratingstar-ios/tags).
I will try to provide release notes with future releases.
## License
This project is licensed under the Apache-2.0 license - see the [LICENSE.md](https://github.com/mohakapt/ratingstar-ios/blob/master/LICENSE) file for more details.