這兩天項目比較閒,在空余之際,嘗試自己實現列表控件。從動工到初步完成大概花了一天時間,目前實現了列表的簡單功能,後續將考慮加入cell重用機制、慣性特征以及刪除cell等功能。項目代碼已經放到了github上,地址:https://github.com/wanglichun/CustomTableView。
在實現之前,需要了解列表控件的運行原理,我之前的一篇博客《列表控件實現原理解析》中有介紹。去年由於項目需要,使用lua語言自定義過雙重列表(大列表嵌套小列表),這次改用objc實現,實現的思路和以前相同,只是換了個語言,因此速度比較快。下面分步驟介紹實現過程。
總體目錄結構:
目錄結構說明:<喎?/kf/ware/vc/" target="_blank" class="keylink">vcD4KPHA+MaGiVGFibGV3Vmlld8S/wryjukNTVGFibGVWaWV3o6hDdXN0b21UYWJsZVZpZXe1xMv10LSjqc6q19S2qNLltcTB0LHtv9i8/qOsQ1NUYWJsZVZpZXdDZWxszqrB0LHttcS1pdSqJiMyNjY4NDujuzwvcD4KPHA+MqGiUm9vdFZpZXdDb250cm9sbGVy1tCw/LqswcvSu7j2Q1NUYWJsZVZpZXe1xLLiytTA/dfToaM8L3A+CjxwPjxicj4KPC9wPgo8cD6yvdbo0rujusHQse21pdSqJiMyNjY4NDtDU1RhYmxlVmlld0NlbGzKtc/WPC9wPgo8cD4gICAgzqrBy73ayqHKsbzko6zO0rLJ08N4aWK1xLe9yr25ub2owctjZWxso6yyosfSY2VsbNbQ1ruw/Lqswcux6szi0MXPoqOs08O7p8jnufvP68q1z9a4tNTTtcRjZWxso6y/ydLUvMyz0ENTVGFibGVWaWV3Q2VsbMCp1bljZWxsoaPQ6NKq16LS4rXEysejrGNlbGzV4tK7suOyorK7tKbA7bSlw/7Kwrz+o6y2+MrHtKu13bj4uLi/2Lz+Q1NUYWJsZVZpZXe0psDtoaM8L3A+CjxwPrT6wuvI58/Co7o8L3A+CjxwPs23zsS8/qO6PC9wPgo8cD48cHJlIGNsYXNzPQ=="brush:java;">#import
實現文件:
#import "CSTableViewCell.h" @interface CSTableViewCell() @property (weak, nonatomic) IBOutlet UILabel *titleLabel; @end @implementation CSTableViewCell + (CSTableViewCell *)csTableViewCell { NSArray *views = [[NSBundle mainBundle] loadNibNamed:@"CSTableViewCell" owner:nil options:nil]; return views[0]; } //將事件傳遞給父控件CSTableView處理 - (BOOL)pointInside:(CGPoint)point withEvent:(UIEvent *)event { return NO; } - (void)setTitle:(NSString *)title { self.titleLabel.text = title; }
步驟二:列表控件CSTableView實現
關鍵步驟,如果對列表的運行原理非常了解,下面的代碼比較容易理解。需要注意,目前只是簡單的采用銷毀創建形式實現列表,未采用cell重用機制,後續有時間補上。DataSouce和Delegate參照UITableViewDataSouce和UITableViewDelegate定義,目前只是定義了幾個典型的方法。
頭文件:
#import@class CSTableView; @class CSTableViewCell; @protocol CSTableViewDataSource @required - (NSInteger)tableView:(CSTableView *)tableView numberOfRowsInSection:(NSInteger)section; - (CSTableViewCell *)tableView:(CSTableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath; @end @protocol CSTableViewDataDelegate @optional - (CGFloat)tableView:(CSTableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath; @end @interface CSTableView : UIView @property (nonatomic,assign)id dataSource; @property (nonatomic,assign)id delegate; + (CSTableView *)csTableView; - (void)reloadData; @end
實現文件:
#import "CSTableView.h" #import "CSTableViewCell.h" static const CGFloat kDefaultCellHeight = 27.0f; @interface CSTableView() { CGPoint _touchBeginPoint; CGPoint _touchMovePoint; CGPoint _touchEndPoint; NSInteger _numberOfRows; CGFloat _top; NSInteger _startIndex; NSInteger _endIndex; CGFloat _startY; CGFloat _dataTotalHeight; //CSTableView的邏輯高度 } @end @implementation CSTableView + (CSTableView *)csTableView { NSArray *views = [[NSBundle mainBundle] loadNibNamed:@"CSTableView" owner:nil options:nil]; return views[0]; } - (void)awakeFromNib { //不能放在這裡,此時delegate和dataSource都為nil,之前犯錯誤了,後面移到了layoutSubviews //[self reloadData]; } - (void)layoutSubviews{ [self reloadData]; } #pragma mark -- touches events - (void)updateUIWithMoveDist:(CGFloat)moveDist { //調控速度 moveDist = 0.2 * moveDist; _top += moveDist; if (_top < 0) { _top = 0; } if (_dataTotalHeight > self.frame.size.height) { if (_top > _dataTotalHeight - self.frame.size.height) { _top = _dataTotalHeight - self.frame.size.height; } [self updateUI]; } } - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event { UITouch *touch=[touches anyObject]; _touchBeginPoint = [touch locationInView:self]; } - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event { UITouch *touch=[touches anyObject]; _touchEndPoint = [touch locationInView:self]; CGFloat moveDist = _touchBeginPoint.y - _touchEndPoint.y; [self updateUIWithMoveDist:moveDist]; } - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event { UITouch *touch=[touches anyObject]; CGPoint point = [touch locationInView:self]; CGFloat moveDist = _touchBeginPoint.y - point.y; [self updateUIWithMoveDist:moveDist]; } #pragma mark -- reloadData //計算顯示范圍 - (void)calculateStartIndexAndEndIndex { _startIndex = -1; CGFloat totalHeight = 0; if ([self.delegate respondsToSelector:@selector(tableView:heightForRowAtIndexPath:)]) { for (NSInteger i = 0; i < _numberOfRows; i++) { NSIndexPath *indexPath = [NSIndexPath indexPathForRow:i inSection:1]; CGFloat cellHeight = [self.delegate tableView:self heightForRowAtIndexPath:indexPath]; totalHeight += cellHeight; if (totalHeight > _top && _startIndex == -1) { _startY = (totalHeight - cellHeight) - _top; _startIndex = i; } if (totalHeight > _top + self.frame.size.height || i == _numberOfRows - 1) { _endIndex = i; break; } } }else{ for (NSInteger i = 0; i < _numberOfRows; i++) { totalHeight += kDefaultCellHeight; if (totalHeight > _top && _startIndex == -1) { _startY = (totalHeight - kDefaultCellHeight) - _top; _startIndex = i; } if (totalHeight > _top + self.frame.size.height || i == _numberOfRows - 1) { _endIndex = i; break; } } } } //更新UI - (void)updateUI { [self calculateStartIndexAndEndIndex]; NSLog(@"startIndex = %ld", _startIndex); NSLog(@"endIndex = %ld", _endIndex); CGFloat totalHeight = 0.0f; for (NSInteger i = _startIndex; i <= _endIndex; i++) { //創建cell,如果用戶沒有自定義cell,則生成一個默認的cell CSTableViewCell *cell; if ([self.dataSource respondsToSelector:@selector(tableView:cellForRowAtIndexPath:)]) { NSIndexPath *indexPath = [NSIndexPath indexPathForRow:i inSection:1]; cell = [self.dataSource tableView:self cellForRowAtIndexPath:indexPath]; }else{ cell = [CSTableViewCell csTableViewCell]; [cell setTitle:@"默認的cell"]; } //設置cell的位置 if ([self.delegate respondsToSelector:@selector(tableView:heightForRowAtIndexPath:)]) { NSIndexPath *indexPath = [NSIndexPath indexPathForRow:i inSection:1]; CGFloat cellHeight = [self.delegate tableView:self heightForRowAtIndexPath:indexPath]; totalHeight += cellHeight; cell.frame = CGRectMake(0, (totalHeight - cellHeight) + _startY, cell.frame.size.width, cell.frame.size.height); }else{ cell.frame = CGRectMake(0, (i - _startIndex) *kDefaultCellHeight + _startY, cell.frame.size.width, cell.frame.size.height); } //將cell添加到CSTabelView [self addSubview:cell]; } } //重新加載數據, 暫時沒有采用cell重用機制,後面有時間再加上 //刪除數據後,調用該函數,重新加載UI - (void)reloadData { for (UIView *subView in self.subviews) { [subView removeFromSuperview]; } if ([self.dataSource respondsToSelector:@selector(tableView:numberOfRowsInSection:)]) { _numberOfRows = [self.dataSource tableView:self numberOfRowsInSection:1]; }else{ _numberOfRows = 10; //默認顯示10條數據 } _dataTotalHeight = 0.0f; if ([self.delegate respondsToSelector:@selector(tableView:heightForRowAtIndexPath:)]) { for (NSInteger i = 0; i < _numberOfRows; i++) { NSIndexPath *indexPath = [NSIndexPath indexPathForRow:i inSection:1]; CGFloat cellHeight = [self.delegate tableView:self heightForRowAtIndexPath:indexPath]; _dataTotalHeight += cellHeight; } }else{ _dataTotalHeight = kDefaultCellHeight * _numberOfRows; } //更新UI [self updateUI]; } @end
#import "RootViewController.h" #import "CSTableView.h" #import "CSTableViewCell.h" @interface RootViewController ()@property (nonatomic, strong)CSTableView *csTableView; @end @implementation RootViewController - (void)viewDidLoad { [super viewDidLoad]; self.csTableView = [CSTableView csTableView]; self.csTableView.dataSource = self; self.csTableView.delegate = self; self.csTableView.frame = CGRectMake(0, 0, self.csTableView.frame.size.width, self.csTableView.frame.size.height); [self.view addSubview:self.csTableView]; } - (void)didReceiveMemoryWarning { [super didReceiveMemoryWarning]; // Dispose of any resources that can be recreated. } #pragma mark -- CSTableViewDataSource - (NSInteger)tableView:(CSTableView *)tableView numberOfRowsInSection:(NSInteger)section { return 50; } - (CSTableViewCell *)tableView:(CSTableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { CSTableViewCell *cell = [CSTableViewCell csTableViewCell]; NSString *title = [[NSString alloc] initWithFormat:@"測試數據%ld", indexPath.row]; [cell setTitle:title]; return cell; } #pragma mark -- CSTableViewDataDelegate - (CGFloat)tableView:(CSTableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath { if (indexPath.row < 10) { return 20; }else if (indexPath.row >= 10 && indexPath.row < 20){ return 30; }else{ return 40; } //return 27; } @end