https://github.com/tarunon/Instantiate

Type-safe and constructor injectable InterfaceBuilder protocols.
https://github.com/tarunon/Instantiate

ios nib protocol storyboard swift

Last synced: 3 months ago
JSON representation

Type-safe and constructor injectable InterfaceBuilder protocols.

• Host: GitHub
• URL: https://github.com/tarunon/Instantiate
• Owner: tarunon
• License: mit
• Created: 2016-12-04T04:48:02.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2020-12-16T03:14:54.000Z (almost 4 years ago)
• Last Synced: 2024-07-28T15:09:50.736Z (3 months ago)
• Topics: ios, nib, protocol, storyboard, swift
• Language: Swift
• Homepage:
• Size: 159 KB
• Stars: 161
• Watchers: 3
• Forks: 14
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Instantiate

[![Build Status](https://travis-ci.org/tarunon/Instantiate.svg?branch=master)](https://travis-ci.org/tarunon/Instantiate)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

Type-safe and constructor injectable InterfaceBuilder protocols.

## Summary

Storyboard and Nib is not type safe, if you use `UIStoryboard` or `UINib`, your code would be get some gloom.

Instantiate take type-safe protocols for Storyboard and Nib. Lets' improve our code with type-safe protocols!

### as is

```swift

let storyboard = UIStoryboard(name: "ViewController", bundle: Bundle.main)

let vc = storyboard.instantiateInitialViewController() as! ViewController

vc.inject([1, 2, 3])

```

### to be

```swift

import Instantiate

import InstantiateStandard

extension ViewController: StoryboardInstantiatable {}

let vc = ViewController(with: [1, 2, 3])

```

## Protocols

### StoryboardInstantiatable

Supports using viewController with Storyboard. Implement `StoryboardInstantiatable` at your viewController class, then you can use `ViewController(with: Dependency)`.

### NibInstantiatable

Supports using view with Nib. Implement `NibInstantiatable` at your view class, then you can use `View(with: Dependency)`.

#### NibInstantiatableWrapper

Supports using view implements NibInstantiatable in other InterfaceBuilder. NibInstantiatableWrapper supports workaround. Make new `UIView` subclass, and implement `NibInstantiatableWrapper`, call `loadView` on `init(coder:)` and `prepareForInterfaceBuilder`. 

http://stackoverflow.com/questions/27807951/how-to-embed-a-custom-view-xib-in-a-storyboard-scene

### Reusable

Supports `UITableViewCell` / `UICollectionViewCell` reuse features.

Implement `Reusable`, then you can dequeue cell using `Cell.dequeue(from: Parent, for: IndexPath, with: Dependency)`.

## InstantiateStandard

`StoryboardType` and `NibType` required `static var storyboard` or `static var nib`. You need to write these values on own class, it is troublesome...

Many developer define StoryboardName is same of ClassName, and if you are also, you can use `InstantiateStandard`.

This libraly add default implementation of `StoryboardType`, `NibType`, and `Reusable`.

## Instalation

### Carthage

```ruby

github "tarunon/Instantiate"

```

### Pods

```ruby

pod 'Instantiate'

```

### Swift Package Manager

Select Xcode menu File > Swift Packages > Add Package Dependency... and enter repository URL with GUI.

```

Repository: https://github.com/tarunon/tarunon/Instantiate

```

## Requirement

Platform | Version

--- | ---

iOS | 9.0+

macOS | 10.11+

tvOS | 9.0+

Swift | 4.0+