Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zekunyan/TTGEmojiRate
An emoji-liked rating view for iOS, implemented in Swift3.
https://github.com/zekunyan/TTGEmojiRate
animation coreanimation drag emoji ios rating swift
Last synced: 3 months ago
JSON representation
An emoji-liked rating view for iOS, implemented in Swift3.
- Host: GitHub
- URL: https://github.com/zekunyan/TTGEmojiRate
- Owner: zekunyan
- License: mit
- Created: 2015-10-17T12:37:15.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-07-27T13:58:54.000Z (over 6 years ago)
- Last Synced: 2024-05-01T14:38:16.720Z (6 months ago)
- Topics: animation, coreanimation, drag, emoji, ios, rating, swift
- Language: Swift
- Homepage:
- Size: 862 KB
- Stars: 290
- Watchers: 11
- Forks: 32
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - TTGEmojiRate - An emoji-liked rating view for iOS, implemented in Swift. (UI / Rating Stars)
- awesome-ios-star - TTGEmojiRate - An emoji-liked rating view for iOS, implemented in Swift. (UI / Rating Stars)
README
# TTGEmojiRate
An emoji-liked rating view for iOS, implemented in **Swift3**.
**Android version: [PeterSmileRate](https://github.com/SilicorniO/PeterSmileRate) by [SilicorniO](https://github.com/SilicorniO). Great work ! :)**
[](https://travis-ci.org/zekunyan/TTGEmojiRate)
[](http://cocoapods.org/pods/TTGEmojiRate)
[](http://cocoapods.org/pods/TTGEmojiRate)
[](http://cocoapods.org/pods/TTGEmojiRate)
[](https://developer.apple.com/swift/)
[](https://github.com/zekunyan/TTGEmojiRate)
[](https://github.com/zekunyan/TTGEmojiRate)
**Inspired by [Rating Version A - Hoang Nguyen](https://dribbble.com/shots/2211556-Rating-Version-A)**
**Blog**
[土土哥的技术Blog - Swift开源项目: TTGEmojiRate的实现](http://tutuge.me/2015/10/25/ttgemojirate-lib/)
## Features
* More interactive with Emoji and drag gesture.
* Highly customizable.
* Can be used in Interface Builder.
## What
TTGEmojiRate is an emoji-liked rating view for iOS which is implemented in Swift.
You can drop up and down on the Emoji face to change the rate, which is more interactive.
TTGEmojiRate is also highly customizable that many features of it can be configure, like the emoji line width and the mouth width.
## Usage
### Use TTGEmojiRate
1. Create an instance of EmojiRateView and add it to the parent view.
```Swift
let rateView = EmojiRateView.init(frame: CGRectMake(0, 0, 200, 200))
rateView.center = self.view.center
self.view.addSubview(rateView)
```
2. Drop a view in the Interface builder and set the `Custom Class` to `EmojiRateView`
### Run example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
Swift3.
Xcode8.
iOS 8 and later.
## Installation
### CocoaPods
You can use [CocoaPods](http://cocoapods.org) to install `TTGEmojiRate` by adding it to your `Podfile`:
```ruby
pod "TTGEmojiRate"
```
### Carthage
You can use [Carthage](https://github.com/Carthage/Carthage) to install `TTGEmojiRate` by adding it to your `Cartfile`:
```
github "zekunyan/TTGEmojiRate"
```
## Customization
#### rateValueChangeCallback
`rateValueChangeCallback: ((newRateValue: Float) -> Void)?` defines the callback closure when `rateValue` changes.
```Swift
emojiRateView.rateValueChangeCallback = {(rateValue: Float) -> Void in
NSLog("The new rate value is: \(rateValue)")
}
```
#### rateColorRange
`rateColorRange: (from: UIColor, to: UIColor)`
When `rateValue` changes from 0 to 5, the `rateColor` will change from the `from: UIColor` to `to: UIColor`.
```
emojiRateView.rateColorRange = (
UIColor.redColor(),
UIColor.greenColor()
)
```
#### rateDragSensitivity
`rateDragSensitivity: CGFloat` defines the sensitivity when drag to change rateValue.
## Author
zekunyan, [email protected]
## License
TTGEmojiRate is available under the MIT license. See the LICENSE file for more info.