RatingStar 0.2.2

RatingStar 0.2.2

Maintained by Haytham KATBY.




Rating Star

A nice-looking new concept for rating bars implemented for iOS.

Version Platform API GitHub issues License

The concept looks like a flower with every petal representing a specific rating.
The idea of this project is originally inspired by this concept.

Example

Installation

RatingStar is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'RatingStar'

For an Android implementation please check this repository.

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:
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 for versioning. For the versions available, see the tags on this repository.
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 file for more details.