Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rogymd/swiftystoryboard
A framework that helps you to operate with UIStoryboard and it’s components.
https://github.com/rogymd/swiftystoryboard
cocoapods pod protocol-oriented swift3 uistoryboard uistoryboardsegue
Last synced: 3 days ago
JSON representation
A framework that helps you to operate with UIStoryboard and it’s components.
- Host: GitHub
- URL: https://github.com/rogymd/swiftystoryboard
- Owner: RogyMD
- License: mit
- Created: 2017-06-25T16:52:28.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-12-07T23:54:30.000Z (almost 7 years ago)
- Last Synced: 2024-09-24T20:39:10.204Z (3 days ago)
- Topics: cocoapods, pod, protocol-oriented, swift3, uistoryboard, uistoryboardsegue
- Language: Swift
- Size: 111 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SwiftyStoryboard
A framework that helps you to operate with `UIStoryboard` and it’s components.
[](https://cocoapods.org/pods/SwiftyStoryboard)
[](https://cocoapods.org/pods/SwiftyStoryboard)
[](https://raw.githubusercontent.com/RogyMD/SwiftyStoryboard/master/LICENSE)
## Requirements
- iOS 8.0+
- Xcode 8.1+
- Swift 3.0+
## Installation
### CocoaPods
[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:
```bash
$ gem install cocoapods
```
To integrate SwiftyStoryboard into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target '' do
pod 'SwiftyStoryboard'
end
```
Then, run the following command:
```bash
$ pod install
```
## Usage
### Create a StoryboardType
```swift
import SwiftyStoryboard
// Enum example of `StoryboardType`.
enum AppStoryboard: String, StoryboardType {
case main = "Main"
}
// Struct example of `StoryboardType`.
struct AppStoryboardStruct: RawRepresentable, StoryboardType {
typealias RawValue = String
let rawValue: String
init(rawValue: String) {
self.rawValue = rawValue
}
static var main = AppStoryboardStruct(rawValue: "Main")
}
```
### Create a StoryboardSceneType
```swift
import SwiftyStoryboard
class ViewController: UIViewController {}
extension ViewController: StoryboardSceneType {
class var mainStoryboard: AppStoryboard {
return .main
}
}
```
`StoryboardSceneType` provides default class property `scene`. Feel free to use it to initialize an `ViewController` instance.
```swift
let vc = ViewController.scene
```
**Old:**
```swift
let vc = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "ViewController") as! ViewController
```
### Create a SeguePerformer
```swift
import SwiftyStoryboard
class ViewController: UIViewController {}
extension ViewController: SeguePerformer {
// Define `SegueType` as nested enum `Segue`
typealias SegueType = Segue
// Nested enum `Segue` with defined `UIStoryboardSegue` identifier as implicit `rawValue`
enum Segue: String, StoryboardSegueType {
case second
}
}
```
Perform segues easier.
```swift
perform(segue: .second)
```
**Old:**
```swift
performSegue(withIdentifier: "second", sender: nil)
```
Handle segues in more _swifty_ way.
```swift
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
super.prepare(for: segue, sender: sender)
// `Segue` should be initialized with `UIStoryboardSegue` instance.
if let segue = Segue(segue) {
NSLog("Segue('\(segue.segueID)') was performed.")
}
// Old
if let identifier = segue.identifier, identifier == "second" {
NSLog("Segue('\(identifier)') was performed.")
}
}
```
## License
SwiftyStoryboard is released under the MIT license. [See LICENSE](https://raw.githubusercontent.com/RogyMD/SwiftyStoryboard/master/LICENSE) for details.