学习目标
1.【了解】什么是UITableView
2.【理解】UITableView的数据源
3.【理解】UITableView的代理
一、什么是UITableView
在iOS中，要实现表格数据展示，最常用的做法就是使用UITableView。UITableView继承自UIScrollView，所以它支持也只支持纵向滑动，以下app都是UITableView的使用案例：
UITableView有两种风格，分别是Plain和Grouped。也就是UITableViewStylePlain和UITableViewStyleGrouped，其中左边的是Plain风格的，右边的是Grouped风格，这个区别还是很明显的。
UITableView有两个Delegate分别为：dataSource和delegate。
dataSource是UITableViewDataSource类型，主要为UITableView提供显示用的数据(UITableViewCell)，指定UITableViewCell支持的编辑操作类型(insert，delete和reordering)，并根据用户的操作进行相应的数据更新操作，如果数据没有更具操作进行正确的更新，可能会导致显示异常，甚至crush。
delegate是UITableViewDelegate类型，主要提供一些可选的方法，用来控制tableView的选择、指定section的头和尾的显示以及协助完成cell的删除和排序等功能。
提到UITableView，就必须的说一说NSIndexPath。UITableView声明了一个NSIndexPath的类别，主要用来标识当前cell的在tableView中的位置，该类别有section和row两个属性，前者标识当前cell处于第几个组中，后者代表在该组中的第几行。
二、UITableView的数据源
UITableView如果没有数据也就只是一个空壳，如果我们需要在UITableView中展示数据，必须为其指定数据源。也就是为UITableView的dataSource属性赋值一个遵守了UITableViewDataSource协议的OC对象。UITableView会向数据源查询一共有多少行数据以及每一行显示什么数据等。
让UITableView展示数据的一般步骤：
1.让类遵守<UITableViewDataSource>协议。
2.实现协议中的必要方法。
//调用数据源的下面方法得知一共有多少组数据 - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView; //调用数据源的下面方法得知每一组有多少行数据 - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section; //调用数据源的下面方法得知每一行显示什么内容 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath;
3.指定数据源对象。
@property (nonatomic, weak, nullable) id <UITableViewDataSource> dataSource;
下面以一个简单的例子演示UITableView展示数据步骤，下图是完成后的界面截图：
创建项目导入plist文件，并创建对应模型类。
cars_simple.plist
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>cars</key> <array> <string>奥迪</string> <string>宝马</string> <string>奔驰</string> <string>保时捷</string> <string>大众</string> </array> <key>title</key> <string>德系品牌</string> <key>desc</key> <string>高端大方上档次，世界一流品牌</string> </dict> <dict> <key>cars</key> <array> <string>本田</string> <string>丰田</string> <string>铃木</string> <string>雷克萨斯</string> <string>马自达</string> <string>日产</string> <string>三菱</string> <string>现代</string> </array> <key>title</key> <string>日韩品牌</string> <key>desc</key> <string>牛逼哄哄，哎哟，好像不错</string> </dict> <dict> <key>cars</key> <array> <string>别克</string> <string>福特</string> <string>Jeep</string> <string>凯迪拉克</string> <string>林肯</string> <string>雪佛兰</string> </array> <key>title</key> <string>美系品牌</string> <key>desc</key> <string>老牌汽车，复古风</string> </dict> <dict> <key>cars</key> <array> <string>标致</string> <string>雪铁龙</string> <string>宾利</string> <string>捷豹</string> <string>路虎</string> <string>劳斯莱斯</string> <string>法拉利</string> <string>兰博基尼</string> <string>玛莎拉蒂</string> </array> <key>title</key> <string>欧系其他</string> <key>desc</key> <string>优雅高贵，你值得拥有</string> </dict> <dict> <key>cars</key> <array> <string>比亚迪</string> <string>奔腾</string> <string>北京汽车</string> <string>长城</string> <string>东南</string> <string>东风</string> </array> <key>title</key> <string>自主品牌</string> <key>desc</key> <string>Made In China，质量你懂的</string> </dict> </array> </plist>
JFCar.h
#import <Foundation/Foundation.h> @interface JFCar : NSObject @property (strong, nonatomic) NSArray *cars; @property (copy, nonatomic) NSString *title; @property (copy, nonatomic) NSString *desc; //快速创建模型对象的对象方法 - (instancetype)initWithDictionary:(NSDictionary *)dict; //快速创建模型对象的类方法 + (instancetype)carWithDictionary:(NSDictionary *)dict; //返回一个创建好的模型数组 + (NSArray *)cars; @end
JFCar.m
#import "JFCar.h"
@implementation JFCar
//快速创建模型对象的对象方法
- (instancetype)initWithDictionary:(NSDictionary *)dict {
if (self = [super init]) {
[self setValuesForKeysWithDictionary:dict];
}
return self;
}
//快速创建模型对象的类方法
+ (instancetype)carWithDictionary:(NSDictionary *)dict {
return [[self alloc] initWithDictionary:dict];
}
//返回一个创建好的模型数组
+ (NSArray *)cars {
//加载plist文件到数组
NSArray *array = [NSArray arrayWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"cars_simple.plist" ofType:nil]];
//创建一个可变数组存储模型对象
NSMutableArray *arrayM = [NSMutableArray array];
for (NSDictionary *dict in array) {
JFCar *car = [JFCar carWithDictionary:dict];
[arrayM addObject:car];
}
return arrayM;
}
@end
在Main.storyboard中拖拽一个UITableView控件拉满这个屏幕，并进行属性连线操作。
声明一个属性用于存储模型对象数组，并懒加载模型对象数组数据。
@property (strong, nonatomic) NSArray *cars;//声明模型对象数组
//懒加载数据
- (NSArray *)cars {
if (_cars == nil) {
//调用JFCar的类方法返回模型数组
_cars = [JFCar cars];
}
return _cars;
}
让当前控制器ViewController遵守<UITableViewDataSource>协议，并实现必要方法，最后为UITableView指定数据源对象。为了展示方便，我们重写prefersStatusBarHidden隐藏状态栏。
ViewController.m
#import "ViewController.h"
#import "JFCar.h"
@interface ViewController () <UITableViewDataSource>
@property (weak, nonatomic) IBOutlet UITableView *tableView;//声明模型对象数组
@property (strong, nonatomic) NSArray *cars;
@end
@implementation ViewController
//隐藏导航栏
- (BOOL)prefersStatusBarHidden {
return YES;
}
//懒加载数据
- (NSArray *)cars {
if (_cars == nil) {
//调用JFCar的类方法返回模型数组
_cars = [JFCar cars];
}
return _cars;
}
- (void)viewDidLoad {
[super viewDidLoad];
//指定数据源对象为当前控制器
self.tableView.dataSource = self;
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}
//一共多少组
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return self.cars.count;
}
//每组有多少行
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
JFCar *car = self.cars[section];
return car.cars.count;
}
//每组每行如何展示
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
//获取当前组的模型对象
JFCar *car = self.cars[indexPath.section];
//定义一个标识
static NSString *ID = @"car";
//创建cell并指定唯一标识，实现cell重用。以后都是这样写，不过需要封装cell
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
//第一次创建cell将使用以下方式创建
if (cell == nil) {
cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:ID];
}
//设置辅助指示图样式
cell.accessoryType = UITableViewCellAccessoryDisclosureIndicator;
//设置每行的textLabel属性
cell.textLabel.text = car.cars[indexPath.row];
return cell;
}
//设置每组的头部标题
- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
//获取当前组的模型对象
JFCar *car = self.cars[section];
return car.title;
}
//设置每组底部标题
- (NSString *)tableView:(UITableView *)tableView titleForFooterInSection:(NSInteger)section {
//获取当前组的模型对象
JFCar *car = self.cars[section];
return car.desc;
}
@end
iOS开发是遵循MVC设计思想的，我们需要对cell进行封装。因为cell是用来展示数据的，所以我们需要封装cell为视图类，继承自UITableViewCell。
JFCarCell.h
#import <UIKit/UIKit.h> #import "JFCar.h" @interface JFCarCell : UITableViewCell //设置cell数据 - (void)setCar:(JFCar *)car andIndex:(NSInteger)index; //快速创建cell的方法 + (instancetype)carCell:(UITableView *)tableView; @end
JFCarCell.m
#import "JFCarCell.h"
@implementation JFCarCell
//快速创建cell的方法
+ (instancetype)carCell:(UITableView *)tableView {
//声明一个唯一标识
static NSString *ID = @"car";
//在缓存中创建cell，如果换成中有需要的cell就不会创建新的cell
JFCarCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
//第一次创建cell，缓存中是没有任何cell的。所以需要创建新的cell
if (cell == nil) {
cell = [[JFCarCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:ID];
}
//返回创建好的cell
return cell;
}
//设置cell数据
- (void)setCar:(JFCar *)car andIndex:(NSInteger)index {
self.textLabel.text = car.cars[index];
}
@end
ViewController.m
#import "ViewController.h"
#import "JFCar.h"
#include "JFCarCell.h"
@interface ViewController () <UITableViewDataSource>
@property (weak, nonatomic) IBOutlet UITableView *tableView;//声明模型对象数组
@property (strong, nonatomic) NSArray *cars;
@end
@implementation ViewController
//隐藏导航栏
- (BOOL)prefersStatusBarHidden {
return YES;
}
//懒加载数据
- (NSArray *)cars {
if (_cars == nil) {
//调用JFCar的类方法返回模型数组
_cars = [JFCar cars];
}
return _cars;
}
- (void)viewDidLoad {
[super viewDidLoad];
//指定数据源对象为当前控制器
self.tableView.dataSource = self;
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}
//一共多少组
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return self.cars.count;
}
//每组有多少行
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
JFCar *car = self.cars[section];
return car.cars.count;
}
//每组每行如何展示
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
//获取当前组的模型对象
JFCar *car = self.cars[indexPath.section];
JFCarCell *cell = [JFCarCell carCell:tableView];
//设置每行尾部的标记
cell.accessoryType = UITableViewCellAccessoryDisclosureIndicator;
//设置每行的textLabel属性
[cell setCar:car andIndex:indexPath.row];
return cell;
}
//设置每组的头部标题
- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
//获取当前组的模型对象
JFCar *car = self.cars[section];
return car.title;
}
//设置每组底部标题
- (NSString *)tableView:(UITableView *)tableView titleForFooterInSection:(NSInteger)section {
//获取当前组的模型对象
JFCar *car = self.cars[section];
return car.desc;
}
@end
三、UITableView的代理
开发中通常都要为UITableView设置代理对象(delegate)，监听UITableView触发某个事件时做出相应的处理，比如选中了某一行。凡是遵守了UITableViewDelegate协议的OC对象，都可以是UITableView的代理对象。
下面通过一个简单的实例来演示UITableView代理(delegate)的作用。如下图所示：
创建项目，在Main.storyboard中拖拽一个满屏的UITableView控件并进行属性控件连续，然后导入plist文件创建模型类。
JFHero.h
#import <Foundation/Foundation.h> @interface JFHero : NSObject @property (copy, nonatomic) NSString *icon; @property (copy, nonatomic) NSString *intro; @property (copy, nonatomic) NSString *name; //快速创建模型对象的对象方法 - (instancetype)initWithDictionary:(NSDictionary *)dict; //快速创建模型对象的类方法 + (instancetype)heroWithDictionary:(NSDictionary *)dict; //返回一个模型数组 + (NSArray *)heros; @end
JFHero.m
#import "JFHero.h"
@implementation JFHero
//快速创建模型对象的对象方法
- (instancetype)initWithDictionary:(NSDictionary *)dict {
if (self = [super init]) {
[self setValuesForKeysWithDictionary:dict];
}
return self;
}
//快速创建模型对象的类方法
+ (instancetype)heroWithDictionary:(NSDictionary *)dict {
return [[self alloc] initWithDictionary:dict];
}
//返回一个模型数组
+ (NSArray *)heros {
NSArray *array = [NSArray arrayWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"heros.plist" ofType:nil]];
NSMutableArray *arrayM = [NSMutableArray array];
for (NSDictionary *dict in array) {
JFHero *hero = [JFHero heroWithDictionary:dict];
[arrayM addObject:hero];
}
return arrayM;
}
@end
封装cell，提供一个快速创建cell的方法并实现cell的重用，再提供一个为cell属性赋值的方法。这里使用的是将模型对象定义为属性，并重写set方法为cell的属性赋值。
JFHeroCell.h
#import <UIKit/UIKit.h> #import "JFHero.h" @interface JFHeroCell : UITableViewCell @property (strong, nonatomic) JFHero *hero; //快速创建一个cell对象 + (instancetype)heroCell:(UITableView *)tableView; @end
JFHeroCell.m
#import "JFHeroCell.h"
@implementation JFHeroCell
//快速创建一个cell对象
+ (instancetype)heroCell:(UITableView *)tableView {
NSString *ID = @"hero";
JFHeroCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
if (cell == nil) {
cell = [[JFHeroCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:ID];
}
tableView.rowHeight = 60;
return cell;
}
//重新set方法为cell赋值
- (void)setHero:(JFHero *)hero {
_hero = hero;
self.imageView.image = [UIImage imageNamed:hero.icon];
self.textLabel.text = hero.name;
self.detailTextLabel.text = hero.intro;
}
@end
1.在控制器定义一个模型对象数组属性，并重新属性的get方法实现懒加载。
2.遵守UITableViewDataSource数据源协议、UITableViewDelegate代理协议、UIAlertViewDelegate对话框代理协议。
3.实现各种代理方法，并为UITableView指定数据源对象、代理对象为当前控制器。为UIAlertView指定代理对象为当前控制器。
具体代码如下：
ViewController.m
#import "ViewController.h"
#import "JFHero.h"
#import "JFHeroCell.h"
@interface ViewController () <UITableViewDataSource,UITableViewDelegate,UIAlertViewDelegate>
@property (strong, nonatomic) NSArray *heros;//声明模型对象数组
@property (weak, nonatomic) IBOutlet UITableView *tableView;
@end
@implementation ViewController
//隐藏状态栏
- (BOOL)prefersStatusBarHidden {
return YES;
}
//懒加载
- (NSArray *)heros {
if (_heros == nil) {
//调用类方法返回模型数组
_heros = [JFHero heros];
}
return _heros;
}
- (void)viewDidLoad {
[super viewDidLoad];
//指定数据源对象
self.tableView.dataSource = self;
//指定代理对象
self.tableView.delegate = self;
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}
//一共有多少组
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
//每组多少行
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.heros.count;
}
//每行如何显示
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
//创建cell
JFHeroCell *cell = [JFHeroCell heroCell:tableView];
//为cell赋值
cell.hero = self.heros[indexPath.row];
return cell;
}
//当点击了某行的时候触发
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
//取出当前行的模型对象
JFHero *hero = self.heros[indexPath.row];
//创建对话框
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"修改操作" message:@"请输入新的姓名" delegate:self cancelButtonTitle:@"取消" otherButtonTitles:@"确定", nil];
//设置对话框的样式
alert.alertViewStyle = UIAlertViewStylePlainTextInput;
//获取当前模型对象的name赋值给对话框
[alert textFieldAtIndex:0].text = hero.name;
//添加一个清除文本框按钮
[alert textFieldAtIndex:0].clearButtonMode = UITextFieldViewModeWhileEditing;
//把行赋值给对话框的tag
alert.tag = indexPath.row;
//显示对话框
[alert show];
}
//监听对话框点击选项
- (void)alertView:(UIAlertView *)alertView clickedButtonAtIndex:(NSInteger)buttonIndex {
//点击了确认
if (buttonIndex == 1) {
//获取当前行的模型对象
JFHero *hero = self.heros[alertView.tag];
//重新为模型对象赋值
hero.name = [alertView textFieldAtIndex:0].text;
//封装要刷新的具体某组某行
NSIndexPath *path = [NSIndexPath indexPathForRow:alertView.tag inSection:0];
//刷新指定某组某行数据
[self.tableView reloadRowsAtIndexPaths:@[path] withRowAnimation:UITableViewRowAnimationBottom];
}
}
@end