Latest 0.9.0
Homepage https://github.com/huangboju/UITableView-FDTemplateLayoutCell.swift
License MIT
Platforms ios 8.0, requires ARC
Frameworks UIKit
Authors

It is translation of the UITableView-FDTemplateLayoutCell by Swift

Overview

It can be through the Auto layout and Frame layout way to obtain the height of the cell, and you can use the same key or indexpath way to cache the height of the cell

UITableView-FDTemplateLayoutCell.swift

Installation

  • CocoaPods

    pod UITableView-FDTemplateLayoutCell.swift
  • Carthage
github "huangboju/UITableView-FDTemplateLayoutCell.swift"

Usage

  • No cache

    override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
        return tableView.fd_heightForCell(with: "cell") { (cell) in
        // Configure this cell with data, same as what you've done in "-tableView:cellForRowAtIndexPath:"
        // Like:
        //    cell.data = datas[indexPath.row]
        }
    }
  • IndexPath cache

    override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
        return tableView.fd_heightForCell(with: "cell", cacheBy: indexPath) { (cell) in
        // Configure this cell with data, same as what you've done in "-tableView:cellForRowAtIndexPath:"
        // Like:
        //    cell.data = datas[indexPath.row]
        }
    }
  • Key cache
    override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
        return tableView.fd_heightForCell(with: "cell", cacheByKey: entity.identifier ?? "") { (cell) in
        // Configure this cell with data, same as what you've done in "-tableView:cellForRowAtIndexPath:"
        // Like:
        //    cell.data = datas[indexPath.row]
        }
    }

Frame layout mode

FDTemplateLayoutCell.swift offers 2 modes for asking cell’s height.

  • Auto layout mode using "-systemLayoutSizeFittingSize:"
  • Frame layout mode using "-sizeThatFits:"

You can use this API change mode for asking cell’s height,default is true, because use "frame layout" rather than "auto layout".

cell.fd_usingFrameLayout = false

And if you’re using frame layout mode, you must override func sizeThatFits(_ size: CGSize) -> CGSize in your customized cell and return content view’s height (separator excluded)

    override func sizeThatFits(_ size: CGSize) -> CGSize {
        return CGSize(width: size.width, height: h1 + h2 + ... + hn)
    }

Debug log

Debug log helps to debug or inspect what is this "FDTemplateLayoutCell.swift" extention doing, turning on to print logs when "calculating", "precaching" or "hitting cache".Default to "false", log by "print".

tableView.fd_debugLogEnabled = true

It will print like this:

** FDTemplateLayoutCell ** hit cache by index path[0, 17] - 123.5
** FDTemplateLayoutCell ** hit cache by index path[0, 18] - 237.5
** FDTemplateLayoutCell ** hit cache by index path[0, 18] - 237.5
** FDTemplateLayoutCell ** hit cache by index path[0, 19] - 159.5
** FDTemplateLayoutCell ** hit cache by index path[0, 19] - 159.5
** FDTemplateLayoutCell ** hit cache by index path[0, 20] - 262.0
** FDTemplateLayoutCell ** hit cache by index path[0, 20] - 262.0
** FDTemplateLayoutCell ** hit cache by index path[0, 21] - 288.0
** FDTemplateLayoutCell ** hit cache by index path[0, 21] - 288.0
** FDTemplateLayoutCell ** hit cache by index path[0, 22] - 299.0
** FDTemplateLayoutCell ** hit cache by index path[0, 22] - 299.0
** FDTemplateLayoutCell ** hit cache by index path[0, 23] - 176.5

About self-satisfied cell

a fully self-satisfied cell is constrainted by auto layout and each edge("top", "left", "bottom", "right") has at least one layout constraint against it. It’s the same concept introduced as "self-sizing cell" in iOS8 using auto layout.

A bad one :( – missing right and bottom
non-self-satisfied

A good one :)
self-satisfied

Notes

A template layout cell is created by dequeueReusableCell(withIdentifier: <#T##String#>) method, it means that you MUST have registered this cell reuse identifier by one of:

  • A prototype cell of UITableView in storyboard.
  • Use register(UINib, forCellReuseIdentifier: String)
  • Use register(AnyClass, forCellReuseIdentifier: String)

Contact

If you find an issue, just open a ticket. Pull requests are warmly welcome as well.

License

UITableView-FDTemplateLayoutCell.swift is released under the MIT license. See LICENSE for details.

Latest podspec

{
    "name": "UITableView-FDTemplateLayoutCell.swift",
    "version": "0.9.0",
    "summary": "GesturePassword is a simple gesture password written in Swift",
    "homepage": "https://github.com/huangboju/UITableView-FDTemplateLayoutCell.swift",
    "license": "MIT",
    "authors": {
        "huangboju": "[email protected]"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/huangboju/UITableView-FDTemplateLayoutCell.swift.git",
        "tag": "0.9.0"
    },
    "source_files": "Classes/**/*.swift",
    "frameworks": "UIKit",
    "requires_arc": true,
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "3.0"
    },
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This