《iOS 高级编程》之Tableview进阶指南
本章内容:
● 学习如何进阶使用UITableView,带给应用更高级的观感(look and feel)
● 学习如何开发自己定制的UITableView类,模仿iMessage应用的观感
● 为一个基于分组的UITableView实现下钻逻辑
在iOS应用中呈现数据时,UITableView可能是最经常使用的用户界面对象。在本章中,将学习到以超越标准实现的方式使用UITableView,并理解UITableView类的工作方式。你会创建一个聊天视图控制器,它支持定制的单元格和灵活的行高,以及下钻功能的实现,能够将多个对象的多个分类进行分组,从而生成一个高级的用户界面。最后,你会为表格视图的实现添加搜索功能。
2.1 理解UITableView
UITableView直接继承于UIScrollView类,从而给它带来直向(译者注:横向和纵向)滚动的能力。当想要使用UITableView时,必须首先创建UITableView类的实例,将它指向UIView控件而使其可见,并且建立一个datasource对象和一个负责与UITableView进行交互的delegate对象。
2.1.1 datasource和delegate
每一个UITableView都需要datasource和delegate这两个对象。datasource对象为UITableView提供数据。通常,datasource对象使用NSArray类或者NSDictionary类在内部存储数据,并且根据需要将数据提供给表视图。delegate对象必须实现UITableViewDelegate和UITableViewDataSource这两个协议。
UITableViewDelegate协议定义了几个方法,delegate对象需要实现其中至少三个方法。
delegate对象必须实现的方法有:
● tableview:numberOfRowsInSection:
● numberOfSectionsInTableView:
● tableview:cellForRowAtIndexPath:
启动Xcode开发环境,使用Single View ApplicationProject模板创建新项目,并使用如图2-1中所示的配置将其命名为PlainTable。
图1
使用Interface Builder工具打开YDViewController.xib文件,并将一个UITableView控件添加到该窗口中。使用Assistant Editor工具为这个UITableView控件创建一个属性。也需要设置Referencing Outlets一栏中的datasource和delegate指向UITableView对象。确保YDViewController.xib文件看起来如图2-2中所示。
图2
打开YDViewController.h文件,创建名为rowData的NSMutableArray对象充当datasource,如代码清单2-1中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-1 Chapter2/PlainTable/YDViewController.h #import <UIKit/UIKit.h> @interface YDViewController : UIViewController @property (weak, nonatomic) IBOutlet UITableView *mTableView; @property(nonatomic,strong) NSMutableArray* rowData; @end </span>
打开YDViewController.m文件,实现如代码清单2-2中所示的代码,关于这段代码,会在代码清单后详细说明。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-2 Chapter2/PlainTable/YDViewController.m #import "YDViewController.h" @interface YDViewController () @end @implementation YDViewController - (void)viewDidLoad { [super viewDidLoad]; // Do any additional setup after loading the view, typically from a nib. [self loadData]; } -(void)loadData { if (self.rowData!=nil) { [self.rowData removeAllObjects]; self.rowData=nil; } self.rowData = [[NSMutableArray alloc] init]; for (int i=0 ; i<100;i++) { [self.rowData addObject:[NSString stringWithFormat:@"Row: %i",i]]; } //now my datasource if populated let's reload the tableview [self.mTableView reloadData]; } #pragma mark UITableView delegate - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { return 1; } - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { return [self.rowData count]; } - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { static NSString *CellIdentifier = @"Cell"; UITableViewCell *cell = (UITableViewCell *)[tableView dequeueReusableCellWithIdentifier:CellIdentifier]; if (cell == nil) { cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier]; } cell.selectionStyle = UITableViewCellSelectionStyleNone; cell.textLabel.text = [self.rowData objectAtIndex:indexPath.row]; return cell; } -(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath: (NSIndexPath *)indexPath { [tableView deselectRowAtIndexPath:indexPath animated:YES]; } - (void)didReceiveMemoryWarning { [super didReceiveMemoryWarning]; // Dispose of any resources that can be recreated. } @end </span>
下面对这段代码进行分解,向你解释代码中各方法的作用。
在viewDidLoad方法中,调用了本地方法loadData,该方法创建了一个带有100个记录的NSMutableArray对象,并将reloadData消息发送给self.mTableView对象。
reloadData方法迫使mTableView对象通过调用delegate方法重新加载数据,并更新用户界面。
在#pragma mark UITableView delegate标记语句之后,需要实现表视图运行所必须的delegate对象的最小方法集合。
调用numberOfSectionsInTableView: 这个delegate方法来决定UITableView控件的section的数量。如果使用UITableViewStylePlain风格,UITableView控件的section数通常是1。后面将会学习到带有下钻功能的例子,如果使用例子中那种风格的section,则需要返回实际的section的数量。
当渲染单元格时,会调用tableview:cellForRowAtIndexPath:这个delegate方法。这个方法恰好是布局UITableViewCell的地方(UITableView中的一行)。现在,先简单地创建一个UITableviewCell,如果单元格仍然可用的话,试着在内存中重用它。
为了显示rowData数组中的正确的行,需要将[rowData objectAtIndex :indexPath.row];方法的返回值赋给cell.textLabel.text属性。
当用户以单击某行的方式选择该行时,会调用tableview:didSelectRowAtIndexPath:这个delegate方法。deselectRowAtIndexPath:animated:的delegate方法会取消这一行的选择,因此单元格不会保持高亮的状态。
如果想要保持选择状态仍然可见,那么请省略这行代码。
当应用运行时,结果如图2-3中所示。
2.1.2 滚动
由于UITableView对象继承于UIScrollView类,因此它本身拥有完全的滚动功能。然而,在某些情况下,例如在UITableView中添加一个新行,或者删除一行时,可能要直接滚动到UITableView中的某个位置。
可以通过调用UITableView的scrollToRowAtIndexPath:atScrollPosition:animated:方法,获得UITableView上基于代码的滚动效果。这个方法传入的第一个参数是NSIndexPath类型的对象。NSIndexPath对象表示到嵌套数组集合树上的某一特定节点的路径。这个路径称为索引路径。在iOS应用中,用NSIndexPath对象来确定到表格视图内的行和section的路径。调用NSIndexPath类的indexPathForRow:inSection:方法,传入行和section的索引数字,通过这种方式可以创建NSIndexPath的实例。
启动Xcode开发环境,使用SingleView Application Project模板创建一个新项目,并使用如图2-4中所示的配置,将其命名为ScrollingTable。
使用Interface Builder工具打开YDViewController.xib文件,创建一个用户界面,如图2-5中所示。
如代码清单2-3中所示,建立YDViewController.h文件。作为前一个例子的补充,为引入的两个UIButton添加两个动作。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-3 Chapter2/ScrollingTable/YDViewController.h #import <UIKit/UIKit.h> @interface YDViewController : UIViewController @property (weak, nonatomic) IBOutlet UITableView *mTableView; @property(nonatomic,strong) NSMutableArray* rowData; - (IBAction)scrollToTop:(UIButton *)sender; - (IBAction)scrollToBottom:(UIButton *)sender; @end </span>
YDViewController.m文件的实现与前面的代码清单2-2中的类似,唯一的区别在于此时scrollToTop:和scrollToBottom:这两个方法的实现如代码清单2-4中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-4 Chapter2/ScrollingTable/YDViewController.m #import "YDViewController.h" @interface YDViewController () @end @implementation YDViewController - (void)viewDidLoad { [super viewDidLoad]; // Do any additional setup after loading the view, typically from a nib. [self loadData]; } -(void)loadData { if (self.rowData!=nil) { [self.rowData removeAllObjects]; self.rowData=nil; } self.rowData = [[NSMutableArray alloc] init]; for (int i=0 ; i<100;i++) { [self.rowData addObject:[NSString stringWithFormat:@"Row: %i",i]]; } //now my datasource if populated let's reload the tableview [self.mTableView reloadData]; } #pragma mark UITableView delegates - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { return 1; } - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { return [self.rowData count]; } - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { static NSString *CellIdentifier = @"Cell"; UITableViewCell *cell = (UITableViewCell *)[tableView dequeueReusableCellWithIdentifier:CellIdentifier]; if (cell == nil) { cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CellIdentifier]; } cell.selectionStyle = UITableViewCellSelectionStyleNone; cell.textLabel.text = [self.rowData objectAtIndex:indexPath.row]; return cell; } -(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath: (NSIndexPath *)indexPath { [tableView deselectRowAtIndexPath:indexPath animated:YES]; } - (void)didReceiveMemoryWarning { [super didReceiveMemoryWarning]; // Dispose of any resources that can be recreated. } - (IBAction)scrollToTop:(UIButton *)sender { NSIndexPath *topRow = [NSIndexPath indexPathForRow:0 inSection:0]; [self.mTableView scrollToRowAtIndexPath:topRow atScrollPosition:UITableViewScrollPositionTop animated:YES]; } - (IBAction)scrollToBottom:(UIButton *)sender { NSIndexPath *bottomRow = [NSIndexPath indexPathForRow: [self.rowData count]-1 inSection:0]; [self.mTableView scrollToRowAtIndexPath:bottomRow atScrollPosition:UITableViewScrollPositionBottom animated:YES]; } @end </span>
在scrollToTop:方法中,创建一个NSIndexPath对象的实例,把indexPathForRow的值置为0,可以将表视图滚动至顶部。在scrollToBottom:方法中,使用[self.rowData count]-1的值创建NSIndexPath实例,可以将表视图滚动至底部。
用所创建的NSIndexPath对象调用scrollToRowAtIndexPath:atScrollPosition:animated:方法时,mTableView控件既可以滚动到表格的顶部,也可以滚动到表格的底部。
这一实现的结果如图2-6和图2-7中所示。
图6
图7
2.2 构建聊天视图控制器
在本节中,将开发一个聊天视图控制器模拟iMessage以及其他即时通信应用的行为。为此,将学习如何使用灵活的单元格高度和定制的单元格创建一个定制的UITableView的实例。
最终的应用看起来如图2-8所示。
启动Xcode开发环境,用Single View ApplicationProject模板创建一个新项目,使用如图2-9所示的配置,将其命名为YDChatApp。
本例中所使用的图片,可以从本章的下载文件中获得。
YDViewController类会呈现即将开发的定制的UITableView,而且不使用Interface Builder工具开发。所有的UI代码是YDViewController.m文件的一个组成部分。
2.2.1 构建datasource
你将不会使用标准的UITableView,但是为了支持各种不同的聊天泡泡和section,会创建带有特定行为的定制的UITableView对象,并且使用定制的单元格。基于这个原因,开始时会编码实现一个定制的datasource对象,并被挂接到定制的UITableView上。创建一个继承于NSObject类的新协议,将其命名为YDChatTableViewDataSource。协议的源代码如代码清单2-5中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-5 Chapter2/YDChatApp/YDChatTableViewDataSource.h #import <Foundation/Foundation.h> @class YDChatData; @class YDChatTableView; @protocol YDChatTableViewDataSource <NSObject> - (NSInteger)rowsForChatTable:(YDChatTableView *)tableView; - (YDChatData *)chatTableView:(YDChatTableView *)tableView dataForRow:(NSInteger)row; @end </span>
这个协议直接继承于NSObject类,其中定义了必须在YDViewController类里实现的两个方法,定义定制的UITableView的地方就是这里。
2.2.2 构建聊天数据对象
为了使生活更轻松,定义一个名为YDChatData的对象,用来保存一条聊天消息的相关信息。可以用聊天的用户、时间戳、文字或者图片来初始化这个对象。枚举类型YDChatType有两种可能的值,ChatTypeMine和ChatTypeSomeone,用来负责聊天消息在UITableView上的位置。创建一个继承于NSObject的新的Objective-C类,将其命名为YDChatData。
YDChatData.h文件的源代码如代码清单2-6中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-6 Chapter2/YDChatApp/YDChatData.h #import <Foundation/Foundation.h> @class YDChatUser; //enumerator to identify the chattype typedef enum _YDChatType { ChatTypeMine = 0, ChatTypeSomeone = 1 } YDChatType; @interface YDChatData : NSObject @property (readonly, nonatomic) YDChatType type; @property (readonly, nonatomic, strong) NSDate *date; @property (readonly, nonatomic, strong) UIView *view; @property (readonly, nonatomic) UIEdgeInsets insets; @property (nonatomic,strong) YDChatUser *chatUser; //custom initializers + (id)dataWithText:(NSString *)text date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user; + (id)dataWithImage:(UIImage *)image date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user; + (id)dataWithView:(UIView *)view date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user insets:(UIEdgeInsets)insets; @end </span>
在类的实现中,实现几个不同的初始化方法,如代码清单2-7中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-7 Chapter2/YDChatApp/YDChatData.m import "YDChatData.h" #import <QuartzCore/QuartzCore.h> @implementation YDChatData //create some constant UIEdgeInsets to property align text and images const UIEdgeInsets textInsetsMine = {5, 10, 11, 17}; const UIEdgeInsets textInsetsSomeone = {5, 15, 11, 10}; const UIEdgeInsets imageInsetsMine = {11, 13, 16, 22}; const UIEdgeInsets imageInsetsSomeone = {11, 18, 16, 14}; #pragma initializers + (id)dataWithText:(NSString *)text date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user { return [[YDChatData alloc] initWithText:text date:date type:type andUser:_user]; } ?(id)initWithText:(NSString *)text date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user { UIFont* font = [UIFont boldSystemFontOfSize:12]; int width = 225, height = 10000.0; NSMutableDictionary *atts = [[NSMutableDictionary alloc] init]; [atts setObject:font forKey:NSFontAttributeName]; CGRect size = [text boundingRectWithSize:CGSizeMake(width, height) options:NSStringDrawingUsesLineFragmentOrigin attributes:atts context:nil]; UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, size.size.width, size.size.height)]; label.numberOfLines = 0; label.lineBreakMode = NSLineBreakByWordWrapping; label.text = (text ? text : @""); label.font = font; label.backgroundColor = [UIColor clearColor]; UIEdgeInsets insets = (type == ChatTypeMine ? textInsetsMine : textInsetsSomeone); return [self initWithView:label date:date type:type andUser:_user insets:insets]; } ?(id)initWithImage:(UIImage *)image date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user { CGSize size = image.size; if (size.width > 220) { size.height /= (size.width / 220); size.width = 220; } UIImageView *imageView = [[UIImageView alloc] initWithFrame: CGRectMake(0, 0, size.width, size.height)]; imageView.image = image; imageView.layer.cornerRadius = 5.0; imageView.layer.masksToBounds = YES; UIEdgeInsets insets = (type == ChatTypeMine ? imageInsetsMine : imageInsetsSomeone); return [self initWithView:imageView date:date type:type andUser:_user insets:insets]; } + (id)dataWithView:(UIView *)view date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user insets:(UIEdgeInsets)insets { return [[YDChatData alloc] initWithView:view date:date type:type andUser:_user insets:insets]; } ?(id)initWithView:(UIView *)view date:(NSDate *)date type:(YDChatType)type andUser:(YDChatUser *)_user insets:(UIEdgeInsets)insets { self = [super init]; if (self) { _chatUser = _user; _view = view; _date = date; _type = type; _insets = insets; } return self; } @end </span>
2.2.3 构建定制的UITableView控件
创建一个名为YDChatTableView的新的Objective-C类,继承于UITableView类,并且实现了名为ChatBubbleTypingType的枚举类型和需要的属性,如代码清单2-8中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-8 Chapter2/YDChatApp/YDChatTableView.h #import <UIKit/UIKit.h> #import "YDChatTableViewDataSource.h" #import "YDChatTableViewCell.h" //enumerator to identify the bubble type typedef enum _ChatBubbleTypingType { ChatBubbleTypingTypeNobody = 0, ChatBubbleTypingTypeMe = 1, ChatBubbleTypingTypeSomebody = 2 } ChatBubbleTypingType; @interface YDChatTableView : UITableView @property (nonatomic, assign) id<YDChatTableViewDataSource> chatDataSource; @property (nonatomic) NSTimeInterval snapInterval; @property (nonatomic) ChatBubbleTypingType typingBubble; @end </span>
在YDChatTableView类的实现中,私有接口遵从于UITableViewDelegate和UITable- ViewDataSource这两个协议,在这里还定义一个名为bubbleSection的属性。
初始化方法为UITableView设置了默认属性,例如背景颜色、delegate和datasource属性等。重写reloadData方法,并编写你自己的代码,从而在YDChatTableView中加载数据。
另外,必须重写numberOfSectionsInTableView、tableview:numberOfRowsInSection:、tableview:heightForRowAtIndexPath:和tableview:cellForRowAtIndexPath:这几个方法。tableview:cellForRowAtIndexPath:方法创建并返回一个YDChatHeaderTableViewCell对象,或者是一个YDChatTableViewCell对象。
如果正在显示的单元格是首行,那么tableview:heightForRowAtIndexPath:方法就会返回YDChatHeaderTableViewCell控件的高度,或者根据这一特定的数据行与之相关的YDChatData对象,计算出高度并返回。
完整的实现如代码清单2-9中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-9 Chapter2/YDChatApp/YDChatTableView.m #import "YDChatTableView.h" #import "YDChatData.h" #import "YDChatHeaderTableViewCell.h" @interface YDChatTableView ()<UITableViewDelegate, UITableViewDataSource> @property (nonatomic, retain) NSMutableArray *bubbleSection; @end @implementation YDChatTableView - (void)initializer { self.backgroundColor = [UIColor clearColor]; self.separatorStyle = UITableViewCellSeparatorStyleNone; self.delegate = self; self.dataSource = self; //the snap interval in seconds implements a headerview to seperate chats self.snapInterval = 60 * 60 * 24; //one day self.typingBubble = ChatBubbleTypingTypeNobody; } - (id)init { self = [super init]; if (self) [self initializer]; return self; } - (id)initWithFrame:(CGRect)frame { self = [super initWithFrame:frame]; if (self) [self initializer]; return self; } - (id)initWithFrame:(CGRect)frame style:(UITableViewStyle)style { self = [super initWithFrame:frame style:UITableViewStylePlain]; if (self) [self initializer]; return self; } #pragma mark - Override - (void)reloadData { self.showsVerticalScrollIndicator = NO; self.showsHorizontalScrollIndicator = NO; self.bubbleSection = nil; int count = 0; self.bubbleSection = [[NSMutableArray alloc] init]; if (self.chatDataSource && (count = [self.chatDataSource rowsForChatTable:self]) > 0) { NSMutableArray *bubbleData = [[NSMutableArray alloc] initWithCapacity:count]; for (int i = 0; i < count; i++) { NSObject *object = [self.chatDataSource chatTableView:self dataForRow:i]; assert([object isKindOfClass:[YDChatData class]]); [bubbleData addObject:object]; } [bubbleData sortUsingComparator:^NSComparisonResult(id obj1, id obj2) { YDChatData *bubbleData1 = (YDChatData *)obj1; YDChatData *bubbleData2 = (YDChatData *)obj2; return [bubbleData1.date compare:bubbleData2.date]; }]; NSDate *last = [NSDate dateWithTimeIntervalSince1970:0]; NSMutableArray *currentSection = nil; for (int i = 0; i < count; i++) { YDChatData *data = (YDChatData *)[bubbleData objectAtIndex:i]; if ([data.date timeIntervalSinceDate:last] > self.snapInterval) { currentSection = [[NSMutableArray alloc] init]; [self.bubbleSection addObject:currentSection]; } [currentSection addObject:data]; last = data.date; } } [super reloadData]; } - (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { int result = [self.bubbleSection count]; if (self.typingBubble != ChatBubbleTypingTypeNobody) result++; return result; } ?(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { if (section >= [self.bubbleSection count]) return 1; return [[self.bubbleSection objectAtIndex:section] count] + 1; } ?(float)tableView:(UITableView *)tableView heightForRowAtIndexPath: (NSIndexPath *)indexPath { // Header if (indexPath.row == 0) { return [YDChatHeaderTableViewCell height]; } YDChatData *data = [[self.bubbleSection objectAtIndex:indexPath.section] objectAtIndex:indexPath.row - 1]; return MAX(data.insets.top + data.view.frame.size.height + data.insets.bottom, 52); } ?(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { // Header based on snapInterval if (indexPath.row == 0) { static NSString *cellId = @"HeaderCell"; YDChatHeaderTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellId]; YDChatData *data = [[self.bubbleSection objectAtIndex:indexPath.section] objectAtIndex:0]; if (cell == nil) cell = [[YDChatHeaderTableViewCell alloc] init]; cell.date = data.date; return cell; } // Standard static NSString *cellId = @"ChatCell"; YDChatTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:cellId]; YDChatData *data = [[self.bubbleSection objectAtIndex:indexPath.section] objectAtIndex:indexPath.row - 1]; if (cell == nil) cell = [[YDChatTableViewCell alloc] init]; cell.data = data; return cell; } @end </span>
2.2.4 灵活的单元格高度
由于聊天消息具有图片和文本,这会使每个单元格的宽度和高度发生变化,因此表格可以是不相同的,并且需要根据单元格的内容进行计算。在重写的tableview:heightForRow- AtIndexPath:方法中,存在一个判断条件,如果当前的单元格是标题单元格,那么就返回标题单元格的高度;如果这个单元格是一个普通的聊天单元格,那么就获取与该单元格相连的YDChatData对象,并计算用作显示单元格的相关UIEdgeInset变量的最大值。下面的代码片段在YDChatTableView类中实现,负责灵活地返回单元格的高度。<span style="font-family:Microsoft YaHei;font-size:14px;">(float)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { // Header if (indexPath.row == 0) { return [YDChatHeaderTableViewCell height]; } YDChatData *data = [[self.bubbleSection objectAtIndex:indexPath.section] objectAtIndex:indexPath.row - 1]; return MAX(data.insets.top + data.view.frame.size.height + data.insets.bottom, 52); } </span>
2.2.5 开发定制的单元格
为了正确显示聊天数据,需要两种不同的定制的UITableViewCell对象,它们都继承于UITableViewCell类。
一种用以显示标题头,在这种情况下,就是显示与snapInterval属性相关的日期和时间编组。另外一种用以显示YDChatData对象中保存的聊天消息。前一种表格对象有一个名为height返回值类型为CGFloat的静态方法,返回这个UITableViewCell的高度,还有一个日期类型的属性,因而日期和时间可以从snapInterval属性中获得。创建一个名为YDChatTableViewHeaderCell的新的Objective-C类,打开YDChatTableViewHeaderCell.h文件,应用如代码清单2-10中所示的代码。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-10 Chapter2/YDChatApp/YDChatTableViewHeaderCell.h #import <UIKit/UIKit.h> @interface YDChatHeaderTableViewCell : UITableViewCell + (CGFloat)height; @property (nonatomic, strong) NSDate *date; @end </span>
<span style="font-family:Microsoft YaHei;font-size:14px;"> </span>
YDChatTableViewHeaderCell类的实现简单地返回30.0作为height方法的返回值。setDate方法接收一个日期对象,并创建UILabel控件,将其添加到视图上,用以显示section的日期-时间戳。实现如代码清单2-11中所示的代码。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-11 Chapter2/YDChatApp/YDChatTableViewHeaderCell.m #import "YDChatHeaderTableViewCell.h" @interface YDChatHeaderTableViewCell () @property (nonatomic, retain) UILabel *label; @end @implementation YDChatHeaderTableViewCell + (CGFloat)height { return 30.0; } - (void)setDate:(NSDate *)value { NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init]; [dateFormatter setDateStyle:NSDateFormatterMediumStyle]; [dateFormatter setTimeStyle:NSDateFormatterShortStyle]; NSString *text = [dateFormatter stringFromDate:value]; if (self.label) { self.label.text = text; return; } self.selectionStyle = UITableViewCellSelectionStyleNone; self.label = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, self.frame.size.width, [YDChatHeaderTableViewCell height])]; self.label.text = text; self.label.font = [UIFont boldSystemFontOfSize:12]; self.label.textAlignment = NSTextAlignmentCenter; self.label.shadowOffset = CGSizeMake(0, 1); self.label.shadowColor = [UIColor whiteColor]; self.label.textColor = [UIColor darkGrayColor]; self.label.backgroundColor = [UIColor clearColor]; [self addSubview:self.label]; } @end </span>
既然已经为HeaderCell创建了类,那么也需要为ChatCell创建一个定制的类,用来显示真实的聊天消息。创建一个继承于UITableViewCell的新的Objective-C类,将其命名为YDChatTableViewCell。为这个类添加YDChatData类型的唯一的一个属性,用以显示真实的聊天消息,并将单元格作为定制的UITableViewCell对象返回。
在YDChatTableViewCell.h文件中实现如代码清单2-12中所示的代码。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-12 Chapter2/YDChatApp/YDChatTableViewCell.h #import <UIKit/UIKit.h> #import "YDChatData.h" @interface YDChatTableViewCell : UITableViewCell @property (nonatomic, strong) YDChatData *data; -(void)setData(YDChatData*)data; @end</span>
setData:方法接受YDChatData对象,将它赋值给data属性。下一步,它会调用rebuild- UserInterface方法,如果该方法之前没有创建过bubbleImage,那么就会创建这个对象。如果YDChatData对象有代表一个用户的值,那么就会使用该聊天用户的头像,作为子视图添加到界面上。
YDChatTableViewCell.m文件的实现代码如代码清单2-13中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-13 Chapter2/YDChatApp/YDChatTableViewCell.m #import <QuartzCore/QuartzCore.h> #import "YDChatTableViewCell.h" #import "YDChatData.h" #import "YDChatUser.h" @interface YDChatTableViewCell () //declare properties @property (nonatomic, retain) UIView *customView; @property (nonatomic, retain) UIImageView *bubbleImage; @property (nonatomic, retain) UIImageView *avatarImage; - (void) setupInternalData; @end @implementation YDChatTableViewCell @synthesize data=_data; - (void)setData:(YDChatData *)data { _data = data; [self rebuildUserInterface]; } - (void) rebuildUserInterface { self.selectionStyle = UITableViewCellSelectionStyleNone; if (!self.bubbleImage) { self.bubbleImage = [[UIImageView alloc] init]; [self addSubview:self.bubbleImage]; } YDChatType type = self.data.type; CGFloat width = self.data.view.frame.size.width; CGFloat height = self.data.view.frame.size.height; CGFloat x = (type == ChatTypeSomeone) ? 0 : self.frame.size.width - width - self.data.insets.left - self.data.insets.right; CGFloat y = 0; //if we have a chatUser show the avatar of the YDChatUser property if (self.data.chatUser) { YDChatUser *thisUser = self.data.chatUser; [self.avatarImage removeFromSuperview]; self.avatarImage = [[UIImageView alloc] initWithImage:(thisUser.avatar ? thisUser.avatar : [UIImage imageNamed:@"noAvatar.png"])]; self.avatarImage.layer.cornerRadius = 9.0; self.avatarImage.layer.masksToBounds = YES; self.avatarImage.layer.borderColor = [UIColor colorWithWhite:0.0 alpha:0.2].CGColor; self.avatarImage.layer.borderWidth = 1.0; //calculate the x position CGFloat avatarX = (type == ChatTypeSomeone) ? 2 : self.frame.size.width - 52; CGFloat avatarY = self.frame.size.height - 50; //set the frame correctly self.avatarImage.frame = CGRectMake(avatarX, avatarY, 50, 50); [self addSubview:self.avatarImage]; CGFloat delta = self.frame.size.height - (self.data.insets.top + self.data.insets.bottom + self.data.view.frame.size.height); if (delta > 0) y = delta; if (type == ChatTypeSomeone) x += 54; if (type == ChatTypeMine) x -= 54; } [self.customView removeFromSuperview]; self.customView = self.data.view; self.customView.frame = CGRectMake(x + self.data.insets.left, y + self.data.insets.top, width, height); [self.contentView addSubview:self.customView]; //depending on the ChatType a bubble image on the left or right if (type == ChatTypeSomeone) { self.bubbleImage.image = [[UIImage imageNamed:@"yoububble.png"] stretchableImageWithLeftCapWidth:21 topCapHeight:14]; } else { self.bubbleImage.image = [[UIImage imageNamed:@"mebubble.png"] stretchableImageWithLeftCapWidth:15 topCapHeight:14]; } self.bubbleImage.frame = CGRectMake(x, y, width + self.data.insets.left + self.data.insets.right, height + self.data.insets.top + self.data.insets.bottom); } - (void)setFrame:(CGRect)frame { [super setFrame:frame]; [self rebuildUserInterface]; } @end </span>
2.2.6 创建聊天用户对象
创建一个新的名为YDChatUser的类,具有两个属性:用户名和头像,它们会被显示在刚刚创建的YDChatTableViewCell中。设计YDChatUser类用来设置用户对象的用户名和头像图片,这样可以关联到YDChatData对象上。
创建一个继承于NSObject的新的Objective-C类,将其命名为YDChatUser。YDChatUser.h文件如代码清单2-14中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-14 Chapter2/YDChatApp/YDChatUser.h #import <Foundation/Foundation.h> @interface YDChatUser : NSObject @property (nonatomic, strong) NSString *username; @property (nonatomic, strong) UIImage *avatar; - (id)initWithUsername:(NSString *)user avatarImage:(UIImage *)image; @end </span>
实现定制的构造方法,并且将传入的参数值赋给属性,如代码清单2-15中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-15 Chapter2/YDChatApp/YDChatUser.m #import "YDChatUser.h" @implementation YDChatUser @synthesize avatar = _avatar; @synthesize username = _username; - (id)initWithUsername:(NSString *)user avatarImage:(UIImage *)image { self = [super init]; if (self) { self.avatar = [image copy]; self.username = [user copy]; } return self; } @end</span>
2.2.7 融会贯通
既然已经开发了所有独立的组件,那么就可以编写YDViewController类,使用聊天消息来显示YDChatTableView了。
YDViewController.h文件不需要任何编码工作。
YDViewController.m文件导入所需的头文件,以此为开始并遵从YDChatTableViewDataSource和UITextViewDelegate协议。在viewDidLoad方法的开头,以编程方式创建了用户界面元素。在这个方法的结尾,创建了YDChatUser类型的两个对象,如下面这段代码示例所示:
me =[[YDChatUser alloc] initWithUsername:@"Peter"
avatarImage:[UIImage imageNamed:@"me.png"]];
you =[[YDChatUser alloc] initWithUsername:@"You"
avatarImage:[UIImageimageNamed:@"noavatar.png"]];
最终,在viewDidLoad方法中,一些YDChatData记录被创建并添加到Chats数组中,作为YDChatTableView控件的datasource对象。
YDChatData *first = [YDChatData dataWithText:
@"Hey, how are you doing? I‘m inParis take a look at this picture."
date:[NSDatedateWithTimeIntervalSinceNow:-600]
type:ChatTypeMine andUser:me];
YDChatData *second = [YDChatDatadataWithImage:
[UIImage imageNamed:@"eiffeltower.jpg"]
date:[NSDatedateWithTimeIntervalSinceNow:-290]
type:ChatTypeMine andUser:me];
YDChatData *third = [YDChatDatadataWithText:
@"Wow.. Really cool pictureout there. Wish I could be with you"
date:[NSDatedateWithTimeIntervalSinceNow:-5]
type:ChatTypeSomeone andUser:you];
YDChatData *forth = [YDChatDatadataWithText:
@"Maybe next time you can comewith me."
date:[NSDatedateWithTimeIntervalSinceNow:+0]
type:ChatTypeMine andUser:me];
//Initialize the Chats array with thecreated YDChatData objects
Chats = [[NSMutableArray alloc]
initWithObjects:first, second,third,forth, nil];
sendMessage方法创建了YDChatData对象,使用从msgText控件中得到的文本来初始化这个对象,将其加入到Chats数组中,并调用chatTable对象的reloadData方法。
当选中UITextView,开始在这个控件内输入文字时,会触发textView:shouldChange- TextInRange:replacementText:、textViewDidBeginEditing:和textViewDidChange:这三个方法,用来操控用户界面。shortenTableView和showTableView方法用来控制YDChatTableView的高度。
完整的实现方式如代码清单2-16中所示。
<span style="font-family:Microsoft YaHei;font-size:14px;">代码清单2-16 Chapter2/YDChatApp/YDViewController.m #import "YDChatUser.h" #import "YDChatTableViewDataSource.h" #import "YDViewController.h" #import <QuartzCore/QuartzCore.h> #import "YDChatTableView.h" #import "YDChatTableViewDataSource.h" #import "YDChatData.h" #import "YDChatUser.h" #define lineHeight 16.0f @interface YDViewController ()<YDChatTableViewDataSource,UITextViewDelegate> { YDChatTableView *chatTable; UIView *textInputView; UITextField *textField; NSMutableArray *Chats; UIView* sendView; UIButton* sendButton; UITextView* msgText; BOOL composing; float prevLines; YDChatUser* me ; YDChatUser* you ; } @end @implementation YDViewController CGRect appFrame; - (void)viewDidLoad { [super viewDidLoad]; self.view.backgroundColor=[UIColor lightGrayColor]; //create your instance of YDChatTableView self.chatTable=[[YDChatTableView alloc] initWithFrame: CGRectMake(0,40,[[UIScreen mainScreen] bounds].size.width, [[UIScreen mainScreen] bounds].size.height -40) style:UITableViewStylePlain]; chatTable.backgroundColor=[UIColor whiteColor]; [self.view addSubview:chatTable]; appFrame= [[UIScreen mainScreen] applicationFrame]; sendView = [[UIView alloc] initWithFrame: CGRectMake(0,appFrame.size.height-56,320,56)]; sendView.backgroundColor=[UIColor blueColor]; sendView.alpha=0.9; msgText = [[UITextView alloc] initWithFrame:CGRectMake(7,10,225,36)]; msgText.backgroundColor = [UIColor whiteColor]; msgText.textColor=[UIColor blackColor]; msgText.font=[UIFont boldSystemFontOfSize:12]; msgText.autoresizingMask = UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleTopMargin; msgText.layer.cornerRadius = 10.0f; msgText.returnKeyType=UIReturnKeySend; msgText.showsHorizontalScrollIndicator=NO; msgText.showsVerticalScrollIndicator=NO; //Set the delegate so you can respond to user input msgText.delegate=self; [sendView addSubview:msgText]; msgText.contentInset = UIEdgeInsetsMake(0,0,0,0); [self.view addSubview:sendView]; sendButton = [[UIButton alloc] initWithFrame:CGRectMake(235,10,77,36)]; sendButton.backgroundColor=[UIColor lightGrayColor]; [sendButton addTarget:self action:@selector(sendMessage) forControlEvents:UIControlEventTouchUpInside]; sendButton.autoresizingMask=UIViewAutoresizingFlexibleTopMargin; sendButton.layer.cornerRadius=6.0f; [sendButton setTitle:@"Send" forState:UIControlStateNormal]; [sendView addSubview:sendButton]; //create two YDChatUser object one representing me and one representing the other party me = [[YDChatUser alloc] initWithUsername:@"Peter" avatarImage:[UIImage imageNamed:@"me.png"]]; you =[[YDChatUser alloc] initWithUsername:@"You" avatarImage:[UIImage imageNamed:@"noavatar.png"]]; //Create some YDChatData objects here YDChatData *first = [YDChatData dataWithText: @"Hey, how are you doing? I'm in Paris take a look at this picture." date:[NSDate dateWithTimeIntervalSinceNow:-600] type:ChatTypeMine andUser:me]; YDChatData *second = [YDChatData dataWithImage: [UIImage imageNamed:@"eiffeltower.jpg"] date:[NSDate dateWithTimeIntervalSinceNow:-290] type:ChatTypeMine andUser:me]; YDChatData *third = [YDChatData dataWithText: @"Wow.. Really cool picture out there. Wish I could be with you" date:[NSDate dateWithTimeIntervalSinceNow:-5] type:ChatTypeSomeone andUser:you]; YDChatData *forth = [YDChatData dataWithText: @"Maybe next time you can come with me." date:[NSDate dateWithTimeIntervalSinceNow:+0] type:ChatTypeMine andUser:me]; //Initialize the Chats array with the created YDChatData objects Chats = [[NSMutableArray alloc] initWithObjects:first, second, third,forth, nil]; //set the chatDataSource chatTable.chatDataSource = self; //call the reloadData, this is actually calling your override method [chatTable reloadData]; } -(void)sendMessage { composing=NO; YDChatData *thisChat = [YDChatData dataWithText:msgText.text date:[NSDate date] type:ChatTypeMine andUser:me]; [Chats addObject:thisChat]; [chatTable reloadData]; [self showTableView]; [msgText resignFirstResponder]; msgText.text=@""; sendView.frame=CGRectMake(0,appFrame.size.height-56,320,56); NSIndexPath *indexPath = [NSIndexPath indexPathForRow:0 inSection:0]; [chatTable scrollToRowAtIndexPath:indexPath atScrollPosition:UITableViewScrollPositionBottom animated:YES]; } #pragma UITextViewDelegate //if user presses enter consider as end of message and send it -(BOOL)textView:(UITextView *)textView shouldChangeTextInRange:(NSRange)range replacementText:(NSString *)text { if([text isEqualToString:@"\n"]) { [self sendMessage]; return NO; } return YES; } // this function returns the height of the entered text in the msgText field -(CGFloat )textY { UIFont* systemFont = [UIFont boldSystemFontOfSize:12]; int width = 225.0, height = 10000.0; NSMutableDictionary *atts = [[NSMutableDictionary alloc] init]; [atts setObject:systemFont forKey:NSFontAttributeName]; CGRect size = [msgText.text boundingRectWithSize:CGSizeMake(width, height) options:NSStringDrawingUsesLineFragmentOrigin attributes:atts context:nil]; float textHeight = size.size.height; float lines = textHeight / lineHeight; if (lines >=4) lines=4; if ([msgText.text length]==0) lines=0.9375f; return 190 - (lines * lineHeight) + lineHeight; } -(void)textViewDidChange:(UITextView *)textView { UIFont* systemFont = [UIFont boldSystemFontOfSize:12]; int width = 225.0, height = 10000.0; NSMutableDictionary *atts = [[NSMutableDictionary alloc] init]; [atts setObject:systemFont forKey:NSFontAttributeName]; CGRect size = [msgText.text boundingRectWithSize:CGSizeMake(width, height) options:NSStringDrawingUsesLineFragmentOrigin attributes:atts context:nil]; float textHeight = size.size.height; float lines = textHeight / lineHeight; if (lines >=4) lines=4; composing=YES; msgText.contentInset = UIEdgeInsetsMake(0,0,0,0); sendView.frame = CGRectMake(0,appFrame.size.height-270 - (lines * lineHeight) + lineHeight ,320,56 + (lines * lineHeight)-lineHeight); if (prevLines!=lines) [self shortenTableView]; prevLines=lines; } prevLines=lines; } //let's change the frame of the chatTable so we can see the bottom -(void)shortenTableView { [UIView beginAnimations:@"moveView" context:nil]; [UIView setAnimationDuration:0.1]; chatTable.frame=CGRectMake(0, 0, 320, [self textY] ); [UIView commitAnimations]; prevLines=1; } // show the chatTable as it was -(void)showTableView { [UIView beginAnimations:@"moveView" context:nil]; [UIView setAnimationDuration:0.1]; chatTable.frame=CGRectMake(0,0,320,460 - 56); [UIView commitAnimations]; } //when user starts typing change the frame position and shorten the chatTable -(void)textViewDidBeginEditing:(UITextView *)textView { [UIView beginAnimations:@"moveView" context:nil]; [UIView setAnimationDuration:0.3]; sendView.frame = CGRectMake(0,appFrame.size.height-270,320,56); [UIView commitAnimations]; [self shortenTableView]; [msgText becomeFirstResponder]; } - (BOOL)shouldAutorotateToInterfaceOrientation: (UIInterfaceOrientation)interfaceOrientation { return (interfaceOrientation != UIInterfaceOrientationPortraitUpsideDown); } #pragma mark - YDChatTableView implementation //here are the required implementation from your YDChatTableViewDataSource - (NSInteger)rowsForChatTable:(YDChatTableView *)tableView { return [Chats count]; } - (YDChatData *)chatTableView:(YDChatTableView *)tableView dataForRow:(NSInteger)row { return [Chats objectAtIndex:row]; } @end </span>虽然以非常出色的方式创建的Chat解决方案实现了创建聊天消息并显示这些消息的逻辑,但是它不发送和接收任何消息。因此,还需要实现一个遵循XMPP协议的真正的通信模块(注:有关XMPP协议请参考www.xmpp.org官方网站的内容)。
《iOS 高级编程》试读电子书,免费提供,有需要的留下邮箱,一有空即发送给大家。 别忘啦顶哦!
购书地址:
京东:http://item.jd.com/11573064.html
当当:http://product.dangdang.com/23596918.html
互动:http://product.china-pub.com/3770647
亚马逊:http://www.amazon.cn/dp/B00P7NO4K2
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。