Latest 0.1.5
Homepage https://github.com/fmo91/DequeuableRegistrable
License MIT
Platforms ios 8.0
Authors

[![CI Status](http://img.shields.io/travis/Fernando Ortiz/DequeuableRegistrable.svg?style=flat)](https://travis-ci.org/Fernando Ortiz/DequeuableRegistrable)
Version
License
Platform

Introduction

DequeuableRegistrable is a simple set of protocol extensions that allow registering and dequeuing cells and footers/headers (either from UITableView or UICollectionView) without using unsafe strings or explicit casting.

Example Project

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

Requirements

  • iOS 9.0 or higher
  • Swift 3.0 or higher

Installation

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

pod "DequeuableRegistrable", :git => "https://github.com/fmo91/DequeuableRegistrable/"

At a glance

DequeuableRegistrable turns registering from this:

tableView.register(UINib(nibName: "DogCell", bundle: nil), forCellReuseIdentifier: "DogCell")

to this

DogCell.register(in: tableView)

and turns dequeuing from this:

let cell = tableView.dequeueReusableCell(withIdentifier: "DogCell") as! DogCell

to this:

let cell = DogCell.dequeue(from: tableView) 
// cell is DogCell, not UITableViewCell. It's already casted.

at the only cost of doing this:

extension DogCell: Registrable, Dequeuable {}

Usage

DequeuableRegistrable consists in three simple protocols:

  1. Identifiable: It allows to identify any kind of object by providing a key string. In case of cells, that string is the reusable identifier.
  2. Dequeuable: Inherits from Identifiable. It allows to dequeue cells from UICollectionView or UITableView using the reusable identifier provided by Identifiable protocol.
  3. Registrable: Inherits from Identifiable. It allows to register cells in UICollectionView or UITableView using the reusable identifier provided by Identifiable protocol, and a nib object that Registrable protocol requires.

All of these protocols have extensions that returns defaults values that match the class name. So, for example, if you have a ABCCell class, then its default reusable identifier would be "ABCCell", and its UINib would be UINib(nibName: "ABCCell")

Author

Fernando Ortiz, [email protected]

License

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

Latest podspec

{
    "name": "DequeuableRegistrable",
    "version": "0.1.5",
    "summary": "Safe and convenient registering and dequeuing of UITableViewCells and UICollectionViewCells without Strings.",
    "description": "DequeuableRegistrable is a couple of protocol extensions that allows registering and dequeuing UITableViewCells and UICollectionViewCells without using Strings and without doing any unsafe type casting.",
    "homepage": "https://github.com/fmo91/DequeuableRegistrable",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Fernando Ortiz": "[email protected]"
    },
    "source": {
        "git": "https://github.com/fmo91/DequeuableRegistrable.git",
        "tag": "0.1.5"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "DequeuableRegistrable/Classes/**/*",
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This