Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peterprokop/starrystars
StarryStars is iOS GUI library for displaying and editing ratings
https://github.com/peterprokop/starrystars
Last synced: 17 days ago
JSON representation
StarryStars is iOS GUI library for displaying and editing ratings
- Host: GitHub
- URL: https://github.com/peterprokop/starrystars
- Owner: peterprokop
- License: mit
- Created: 2015-11-01T07:20:58.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-10-26T14:45:08.000Z (about 5 years ago)
- Last Synced: 2024-10-13T14:44:16.872Z (about 1 month ago)
- Language: Swift
- Homepage:
- Size: 52.7 KB
- Stars: 174
- Watchers: 6
- Forks: 23
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# StarryStars
StarryStars is iOS GUI library for displaying and editing ratings
## Features
StarryStars' ```RatingView``` is both ```IBDesignable``` and ```IBInspectable```
You can change any of the following properties right in the interface builder:
And see the result right away:
To add RatingView to your Storyboard/.xib file just drag a generic UIView from palette, then in "Custom Class" section of identity inspector set class to ```RatingView```
## Installation
### Carthage
- `cd` to your project folder
- `touch Cartfile` (if you don't have one yet)
- `nano Cartfile`
- put `github "peterprokop/StarryStars" == 2.0.0` into Cartfile
- Save it: `ctrl-x, y, enter`
- Run `carthage update`
- Copy framework from `Carthage/Build/iOS` to your project
- Make sure that framework is added in Embedded Binaries section of your target (or else you will get dyld library not loaded referenced from ... reason image not found error)
- Add `import StarryStars` on top of your view controller's code
### Manual
Just clone and add ```StarryStars``` directory to your project.
### Cocoapods
- Make sure that you use latest stable Cocoapods version: `pod --version`
- If not, update it: `sudo gem install cocoapods`
- `pod init` in you project root dir
- `nano Podfile`, add:
```
pod 'StarryStars', '~> 2.0.0'
use_frameworks!
```
- Save it: `ctrl-x`, `y`, `enter`
- `pod update`
- Open generated `.xcworkspace`
- Don't forget to import StarryStars: `import StarryStars`!
## Requirements
- iOS 10.0+
- Xcode 10.0+
- Swift 5.0 (for older versions, see `swift-2.2` branch)
## Usage from code
Swift:
```
let rvRightToLeft = RatingView()
rvRightToLeft.frame = view.bounds
view.addSubview(rvRightToLeft)
rvRightToLeft.editable = true
rvRightToLeft.delegate = self
// RatingView will respect setting this property
rvRightToLeft.semanticContentAttribute = .forceRightToLeft
```
Objective C:
```
RatingView* rvRightToLeft = [[RatingView alloc] init];
rvRightToLeft.frame = self.view.bounds;
[self.view addSubview:rvRightToLeft];
rvRightToLeft.editable = YES;
rvRightToLeft.delegate = self;
// RatingView will respect setting this property
rvRightToLeft.semanticContentAttribute = UISemanticContentAttributeForceRightToLeft;
```
## Other Projects
[SwiftOverlays](https://github.com/peterprokop/SwiftOverlays) - Swift GUI library for displaying various popups and notifications.