一个基于MVVM的TableView组件化实现方案——AITableView
来自: http://www.chentoo.com/?p=250
AITableView
https://github.com/chentoo/AITableView
cocoapods:
pod ‘AITableView’
做什么用?
这是一个简化UITableView使用方式的一个尝试,不需要再实现UI TableView繁多的delegate和datasource方法,不需要重复实现繁多的cell的if else / switch 逻辑,只需要简单的配置过程,你就可以轻松的驾驭和布局TableView。
这是一个基于MVVM思想的尝试,并且最终拼装成为TableView的元素不再是一个个的cell,而是一个个轻量的ViewModel(我们暂且叫他CellModel)。每个CellModel对应值唯一的一种cell,CellModel只拥有属性, 且每一个属性都将直接决定Cell的展示效果。
长远来看,你可以轻松的组建一个你自己的CellModel库。在同一个TableView的不同的逻辑情况下,或者不同的TableView中,你可以根据自己的需求选出合适的CellModel,配置属性,拼装组建即可。
怎么使用?
首先使用AITabelView,你不需要更改你原本的Cell的基类和model的基类,只需根据需要实现特定的Protocal即可。
1、 你的每个Cell需要实现AITableViewCellProtocal,并实现对应方法。你应该把你所有的Cell UI元素的配置放在
Objective-C
- (void)AIConfigureWithModel:(DemoNameCellModel *)model
- (void)AIConfigureWithModel:(DemoNameCellModel *)model</div>
并在类方法
Objective-C
+ (CGFloat)AIHeightWithModel:(id)model
+ (CGFloat)AIHeightWithModel:(id)model</div>
返回你的cell的高度。
比如:
Objective-C
#import "DemoTableViewNameCell.h" #import "AITableViewProtocal.h" #import "DemoNameCellModel.h" @interface DemoTableViewNameCell () <AITableViewCellProtocal> @property (nonatomic, strong) UILabel *nameLabel; @end @implementation DemoTableViewNameCell #pragma mark - AITableViewCellProtocal - (void)AIConfigureWithModel:(DemoNameCellModel *)model { self.nameLabel.text = model.name; } + (CGFloat)AIHeightWithModel:(id)model { return 30.0f; } @end
#import "DemoTableViewNameCell.h" #import "AITableViewProtocal.h" #import "DemoNameCellModel.h" @interface DemoTableViewNameCell () <AITableViewCellProtocal> @property (nonatomic, strong) UILabel *nameLabel; @end @implementation DemoTableViewNameCell #pragma mark - AITableViewCellProtocal - (void)AIConfigureWithModel:(DemoNameCellModel *)model { self.nameLabel.text = model.name; } + (CGFloat)AIHeightWithModel:(id)model { return 30.0f; } @end</div>
2、接下来去写一个能够唯一对应这个cell的cellModel,它可以继承自任何基类,也不需实现任何Protocal。但是需要保证的是,cell可以根据它所唯一对应的cellModel完成所有配置。
需要特别注意的是,每个CellModel类,对应且唯一对应一个Cell类,也即不同的Cell Class 不能对应同一个CellModel类。
完成cell对应的cellModel后,使用下面的方法,去绑定他们。
Objective-C
//AITableView.h - (void)bindModelClass:(Class)modelClass withCellClass:(Class)cellClass; - (void)bindModelClass:(Class)modelClass withCellNibClass:(Class)cellNibClass;
//AITableView.h - (void)bindModelClass:(Class)modelClasswithCellClass:(Class)cellClass; - (void)bindModelClass:(Class)modelClasswithCellNibClass:(Class)cellNibClass;</div>
特别的,如果一个cell的逻辑不依赖外部的变化而变化,那么他可能不需要一个cellModel去控制。那么有下面的特别方法去绑定它们。
当然其实我并不建议这么做,因为从长远组建CellModel库的角度来讲,拥有一个唯一的cellModel可能更容易管理和使用。
Objective-C
//AITableView.h - (void)bindStaticCellWithCellClass:(Class)cellClass; - (void)bindStaticCellWithCellNibClass:(Class)cellNibClass;
//AITableView.h - (void)bindStaticCellWithCellClass:(Class)cellClass; - (void)bindStaticCellWithCellNibClass:(Class)cellNibClass;</div>
3、最后使用下面的方法就可以更新你的TableView了。
Objective-C
[self.tableview updateTabelViewWithModels:@[model, sModel, sModel, model]];
[self.tableviewupdateTabelViewWithModels:@[model, sModel, sModel, model]];</div>
4、如果你需要包含不同的section,或者需要headview footerview,那么你可以使用:AITableViewSection 去构建。
Objective-C
@interface AITableViewSection : NSObject @property (strong, nonatomic) id headerModel; @property (strong, nonatomic) id footerModel; @property (strong, nonatomic) NSArray *cellModels; + (instancetype)sectionWithHeaderModel:(id)sectionHeaderModel footerModel:(id)sectionFooterModel cellModels:(NSArray *)cellModels; @end
@interfaceAITableViewSection: NSObject @property (strong, nonatomic) id headerModel; @property (strong, nonatomic) id footerModel; @property (strong, nonatomic) NSArray *cellModels; + (instancetype)sectionWithHeaderModel:(id)sectionHeaderModel footerModel:(id)sectionFooterModel cellModels:(NSArray *)cellModels; @end</div>
并且使用下面的方法去更新TableView
Objective-C
[self.tableview updateTableViewWithSections:@[aiSection, aiSection, aiSection]];
[self.tableviewupdateTableViewWithSections:@[aiSection, aiSection, aiSection]];</div>
5、更多的请参看完整示例代码。
如何接收cell 点击事件?
提供了三种方式:
- AITableView的 delegate
- AITableView的 Block
- model 的 protocal block(可以方便的配置在model身上)
具体请看示例代码。
</div>