ZYThumbnailTableView---堪比一个小型阅读App

Demo github地址: https://github.com/liuzhiyi1992/ZYThumbnailTableView
原文地址：http://zyden.vicp.cc/zythumbnailtableview/
欢迎转载，请注明出处，谢谢
后期会更新oc版本号

可展开型预览TableView，开放接口。全然自由定制

尽管近期非常忙，天天被html+css虐待，可是在很多朋友的压力下，近期还是抽出时间完毕了一个新轮子ZYThumbnailTableView。

下面严格依照小学语文老师教的方式排版：

Summary：

tableView的皮肤。相似一个小型app的强大交互心脏。四肢高度解耦高度自由定制，每一个cell事实上都是一个业务的缩略view，原谅我语文不太好不懂表达，这种缩略view下文就叫做thumbnailView，能够依据上下手势展开很多其它的功能视图块，这些视图块已经开放了接口，支持使用者自己diy提供创建。同一时候接口中带的參数基本满足使用者须要的交互，当然tableviewCell也是全然自由diy的，规矩，先上效果图。

• 工作特点：tableViewCell充当一个缩略内容的容器，初始内容展示局限于cellHeight，当cell被点击后，依据缩略view内容又一次计算出完整的高度，装入另外一个容器中完整展示出来，而且能够上下拖拽扩展出上下功能视图。

• 自由定制：看见的除了功能以外。全部视图都开放接口灵活Diy，tableViewCell，头部扩展视图(topView)，底部扩展视图(bottomView)都是自己提供。

• 使用简单：仅仅须要把自己的tableViewCell，topView。bottomView配置给ZYThumbnailTableViewController对象。

profile(可略过):

Block:
- ConfigureTableViewCellBlock = () -> UITableViewCell?
- UpdateTableViewCellBlock = (cell: UITableViewCell, -indexPath: NSIndexPath) -> Void
- CreateTopExpansionViewBlock = (indexPath: NSIndexPath) -> UIView
- CreateBottomExpansionViewBlock = () -> UIView

Define:
- NOTIFY_NAME_DISMISS_PREVIEW
通知名(让展现出来的thumbnailView消失)
- MARGIN_KEYBOARD_ADAPTATION
自己主动处理键盘遮挡输入控件后，键盘与输入控件保持的间距（自己主动处理键盘遮挡事件使用ZYKeyboardUtil实现
- TYPE_EXPANSION_VIEW_TOP
处理展开抖动事件时，顶部扩展控件的标识
- TYPE_EXPANSION_VIEW_BOTTOM
处理展开抖动事件时，底部扩展控件的标识

Property:
开放：
- tableViewCellHeight
- tableViewDataList
- tableViewCellReuseId
- tableViewBackgroudColor
- keyboardAdaptiveView 你自己定义控件里假设有希望不被键盘遮挡的输入控件。赋值给他。会帮你==自己主动处理遮盖事件==
私有：
- mainTableView
- clickIndexPathRow 记录被点击cell的indexPath row
- spreadCellHeight 存储thumbnailCell展开后的真实高度
- cellDictionary 存储全部存活中的cell
- thumbnailView 缩略view
- thumbnailViewCanPan 控制缩略view展开(扩展topView&buttomView)手势是否工作
- animator UI物理引擎控制者
- expandAmplitude view展开时抖动动作的振幅
- keyboardUtil 自己主动处理键盘遮挡事件工具对象ZYKeyboardUtil

Delegate func:
- optional func zyTableViewDidSelectRow(tableView: UITableView, indexPath: NSIndexPath)

对外会用到的func:
- dismissPreview()
让thumbnailView消失。在TopView,BottomView等没有zyThumbnailTableView对象的地方能够使用通知NOTIFY_NAME_DISMISS_PREVIEW
- reloadMainTableView()
又一次载入tableView

Usage:

——结合Demo介绍用法：
创建ZYThumbnailTableViewController对象：

zyThumbnailTableVC = ZYThumbnailTableViewController()

配置tableViewCell必须的參数：cell高。cell的重用标志符。tableView的数据源等

zyThumbnailTableVC.tableViewCellReuseId = "DIYTableViewCell"
zyThumbnailTableVC.tableViewCellHeight = 100.0
//当然cell高能够在不论什么时候动态配置
zyThumbnailTableVC.tableViewDataList = dataList
zyThumbnailTableVC.tableViewBackgroudColor = UIColor.whiteColor()
//背景颜色可不设置，默觉得白色

接下来给ZYTableView配置你自己的tableViewCell，当然除了createCell外还能够在里面进行其它额外的操作。只是这个Block仅仅会在须要生成cell的时候被调用。而重用cell并不会

//--------insert your diy tableview cell
zyThumbnailTableVC.configureTableViewCellBlock = {
    return DIYTableViewCell.createCell()
}

配置cell的update方法，tableView配置每一个cell必经之处，除了updateCell能够加入额外的操作。这里要注意updateCell的时候建议尽量使用zyThumbnailTableVC对象里的数据源datalist,同一时候要注意时刻保证VC对象里的数据源为最新，接口回调更改数据源时不要忘了对zyThumbnailTableVC.tableViewDataList的更新。

zyThumbnailTableVC.updateTableViewCellBlock =  { [weak self](cell: UITableViewCell, indexPath: NSIndexPath) -> Void in
    let myCell = cell as? DIYTableViewCell
    //Post是我的数据model
    guard let dataSource = self?.zyThumbnailTableVC.tableViewDataList[indexPath.row] as? Post else {
        print("ERROR: illegal tableview dataSource")
        return
    }
    myCell?.updateCell(dataSource)
}

配置你自己的顶部扩展视图 & 底部扩展视图（expansionView）
- 两个Block均提供indexPath參数，仅仅是由于我的BottomView的业务临时不须要识别相应的是哪个cell，所以使用时把參数省略掉了。
- 这里另一个对zyThumbnailTableVC.keyboardAdaptiveView的赋值，是由于我的BottomView中包括有TextField，正如上文所说，ZYKeyboardUtil会自己主动帮我处理键盘遮挡事件。

(==注意==：赋值给keyboardAdaptiveView的和我往Block里送的是同一个对象)

//--------insert your diy TopView
zyThumbnailTableVC.createTopExpansionViewBlock = { [weak self](indexPath: NSIndexPath) -> UIView in
    //Post是我的数据model
    let post = self?
.zyThumbnailTableVC.tableViewDataList[indexPath.row] as! Post
    let topView = TopView.createView(indexPath, post: post)!
    topView.delegate = self;
    return topView
}

let diyBottomView = BottomView.createView()!
//--------let your inputView component not cover by keyboard automatically (animated) (ZYKeyboardUtil)
zyThumbnailTableVC.keyboardAdaptiveView = diyBottomView.inputTextField;
//--------insert your diy BottomView
zyThumbnailTableVC.createBottomExpansionViewBlock = { _ in
    return diyBottomView
}

结合ZYKeyboardUtil工作的效果:

就这样。属于你自己的thumbnailtableView就完毕了。展开，关闭。基本功能上都能使用，可是假设在topView。bottomView中有什么交互功能之类的，就要在自己的头部尾部扩展控件和自己定义的tableViewCell里面完毕了，ZYThumbnailTableView提供cell的indexPath贯通三者通讯交流。

回看下Demo中的交互是如何利用indexPath的：

• 标记为已读后。小圆点会消失
• 标识为喜欢后。会在相应的cell旁边出现一个星星

createView的时候我将从createTopExpansionViewBlock參数中得到的indexPath储存在我的topView对象中。当favoritebutton被点击时就能够indexPath为凭据利用代理改变相应数据源里的相应状态，同一时候在下次createView时依据indexPath取得相应的数据源来显示。

假设这些交互会更新一些与cell相关的数据，还能够在代理方法中调用zyThumbnailTableVC.reloadMainTableView()让tableView又一次载入一遍。

//TopView---------------------------------------------
class func createView(indexPath: NSIndexPath, post: Post) -> TopView? {
    //--------do something
    view.indexPath = indexPath
    return view
}

//touch up inside---------------------------------------------
@IBAction func clickFavoriteButton(sender: UIButton) {
    //--------do something
    delegate.topViewDidClickFavoriteBtn?(self)
}

//代理方法---------------------------------------------
func topViewDidClickFavoriteBtn(topView: TopView) {
    let indexPath = topView.indexPath
    //Post是我的数据model
    let post = zyThumbnailTableVC.tableViewDataList[indexPath.row] as! Post
    post.favorite = !post.favorite
    zyThumbnailTableVC.reloadMainTableView()
}

还有对于导航条样式处理的话，Demo中直接在外面对zyThumbnailTableView对象的navigationItem做处理，亦或者能够在我的源码中让ZYThumbnailTabelViewController继承你封装过导航栏样式的父类。

func configureZYTableViewNav() {
        let titleView = UILabel(frame: CGRectMake(0, 0, 200, 44))
        titleView.text = "ZYThumbnailTabelView"
        titleView.textAlignment = .Center
        titleView.font = UIFont.systemFontOfSize(20.0);
        //503f39
        titleView.textColor = UIColor(red: 63/255.0, green: 47/255.0, blue: 41/255.0, alpha: 1.0)
        zyThumbnailTableVC.navigationItem.titleView = titleView
    }

==今天一次跟那么Block接触，还是那一句，注意循环引用问题。

==

附上一张层级示意图：

感谢我们公司的UI朋友，设计上的强迫症要赶上我代码上的强迫症了。

CocoaPods:

pod 'ZYThumbnailTableView', '~> 0.2.1'

Relation:

@liuzhiyi1992 on Github

License:

ZYThumbnailTableView is released under the MIT license. See LICENSE for details.

轮子不一定适合全部人，可是希望分享造轮子上螺丝的过程，和扳手螺丝刀的很多其它使用技巧。毫无保留。全在代码里了。

交流。快乐！
Demo & 源码

有什么问题能够在github中提交issues交流。谢谢