Latest 1.0.0
Homepage https://github.com/heshamsalman/ReusableViews
License MIT
Platforms ios 9.0
Authors

CI Status
Version
License
Platform

Why?

This extension package solves the following problems:

  • Forces your team to adhere to standard practices by:
    • Making storyboard identifiers the same as their class names
    • Making UITableViewCell and UICollectionViewCell reuse identifiers the same as their class name
    • Making UICollectionView supplementary views and UITableViewHeaderFooterView reuse identifiers the same as their class name
  • Removes the need to force unwrap or force cast cells/headers as you dequeue
  • Removes the need to force unwrap or force cast UIViewControllers as you instantiate them from a storyboard

If you’re a user of SwiftLint, you’ll greatly appreciate the reduced number of warnings and no more need for snippets in the vein of:

guard let cell = tableView.dequeueReusableCell(withIdentifier: "...", for: indexPath) as? MyCustomCellType else {
  fatalError("We didn't get the cell")
}

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Convenient Instantiation of a View From a Nib

Requires that your view conforms to NibLoadableView.

let view = MyNibLoadableView.create()

Instantiation of a UIViewController From a Storyboard

Requires that a class has the same storyboard identifier as its class name.

let myStoryboard: UIStoryboard = ...
let myCustomViewController = myStoryboard.instantiateViewControllerOfType(MyCustomViewController.self) as MyCustomViewController

Dequeueing and Registering a UITableViewCell

Requires that a class has the same reuse identifier as its class name. You must register your cell type first.

// Registration
tableView.register(MyCustomCellType.self)

// Dequeueing
let cell = tableView.dequeueReusableCell(for: indexPath) as MyCustomCellType

Dequeueing and Registering a UICollectionViewCell

Requires that a class has the same reuse identifier as its class name. You must register your cell type first.

// Registration
collectionView.register(MyCustomCellType.self)

// Dequeueing
let cell = collectionView.dequeueReusableCell(for: indexPath) as MyCustomCellType

Dequeueing and Registering a UITableViewHeaderFooterView

Requires that a class has the same reuse identifier as its class name. You must register your cell type first.

// Registration
tableView.register(MyCustomHeaderFooterView.self)

/// Dequeueing
let header = tableView.dequeueReusableHeaderFooterView(inSection: section) as MyCustomHeaderFooterView

Dequeueing and Registering a UICollectionView Supplementary View

Requires that a class has the same reuse identifier as its class name. You must register your view type first.

// Registration
collectionView.register(MyCustomSupplementaryView.self, forSupplementaryViewElementOfKind: .sectionHeader) // or .sectionFooter

// Dequeueing
let view = collectionView.dequeueReusableSupplementaryView(ofKind: .sectionHeader, for: indexPath) as MyCustomSupplementaryView // also takes .sectionFooter

Registering a view backed by a nib

Views backed by nibs must implement the NibLoadableView protocol. The protocol has a pre-defined extension, such that your view doesn’t need to add any methods or properties.

class MyCoolCell: UITableViewCell, NibLoadableView {
  ...
}

Installation

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

pod "ReusableViews"

Author

Hesham Salman, [email protected]

Twitter: @WhatsASoftware

License

ReusableViews is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "ReusableViews",
    "version": "1.0.0",
    "summary": "Instantiate UIViewControllers from storyboards and dequeue views without a bang!",
    "description": "ReusableViews is a sugar library that allows you to dequeue UITableViewCells, UICollectionViewCells,nUITableViewHeaderFooterViews, UICollectionViewReusableViews (supplementary views) without a bang or force cast. It alsonallows you to instantiate view controllers from the storyboard without using a bang or force casting.",
    "homepage": "https://github.com/heshamsalman/ReusableViews",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "heshamsalman": "[email protected]"
    },
    "source": {
        "git": "https://github.com/heshamsalman/ReusableViews.git",
        "tag": "1.0.0"
    },
    "social_media_url": "https://twitter.com/WhatsASoftware",
    "platforms": {
        "ios": "9.0"
    },
    "source_files": "ReusableViews/Classes/**/*",
    "pushed_with_swift_version": "4.0"
}

Pin It on Pinterest

Share This