再读斋

iOS开发之04表视图

发表于 | 分类于 |

概述

表视图组成

表视图是iOS开发中最重要的视图，它以列表的形式展示数据。表视图又一下部分组成：

  • 表头视图：表视图最上边的视图
  • 表脚视图：表视图最下边的视图
  • 单元格（cell）：表视图中每一行的视图
  • 节(section)：由多个单元格组成，应用于分组列表
    • 节头
    • 节脚

表视图的相关类

UITableView继承自UIScrollView，且有两个协议：UITableViewDelegate和UITableViewDataSource。此外UITableViewCell类时单元格类，UITableViewController类时UITableView的控制器，UITableViewHeaderFooterView用于为节头和节脚提供视图。

表视图分类

  • 普通表视图：主要用于动态表，而动态表一般在单元格数目未知的情况下使用
  • 分组表视图：一般用于静态表，用来进行界面布局

单元格的组成和样式

单元格由图标、主标题、副标题、扩展视图组成，可以根据需要进行选择，其中内置的扩展视图在枚举类型UITableViewCellAccessoryType中定义：

Swift枚举成员 Objective-C枚举成员 说明
none ITableViewCellAccessoryNone 没有扩展图标
disclosureIndicator UITableViewCellAccessoryDisclosureIndicator 扩展指示器，为箭头+问号
detailDisclosureButton UITableViewCellAccessoryDetailDisclosureButton 细节展示图，为问号
checkmark UITableViewCellAccessoryCheckmark 选中标志，图标为勾
detailButton UITableViewCellAccessoryDetailButton 细节详情展示，图标为问号

内置的单元格样式在枚举类型UITableViewCellStyle中定义：

Swift枚举成员 Objective-C枚举成员 说明
default UITableViewCellStyleDefault 默认样式
subtitle UITableViewCellStyleSubtitle 有图标、主标题、副标题、副标题在主标题的下面
value1 UITableViewCellStyleValue1 有主标题、副标题，主标题左对齐、副标题右对齐，可以有图标
2alue3 UITableViewCellStyleValue2 有主标题、副标题，主标题和副标题居中对齐，无图标

数据源协议与委托协议

UITableViewDataSource

数据源协议主要为表视图提供数据，主要方法如下

方法 返回类型 说明
func tableView(UITableView, cellForRowAt: IndexPath) UITableViewCell 为表视图单元格提供数据，必须实现
tableView(UITableView, numberOfRowsInSection: Int) Int 返回某个节中的行数，必须实现
tableView(UITableView, titleForHeaderInSection: Int) String 返回节头的标题
tableView(UITableView, titleForFooterInSection: Int) String 返回节脚的标题
numberOfSections(in: UITableView) Int 返回节的个数
sectionIndexTitles(for: UITableView) [String]? 返回表示图节索引标题

UITableViewDelegate

委托协议主要主要用来设定表视图中节头和节脚的标题，以及一些动作事件，主要方法如下

方法 返回类型 说明
tableView(UITableView, didSelectRowAt: IndexPath) 单元格响应事件
tableView(UITableView, accessoryButtonTappedForRowWith: IndexPath) 扩展视图响应事件

简单表视图

UIViewController根视图控制器实现表视图

步骤

  1. 创建一个iOS工程
  2. 从对象库中拖入一个TableView到storyboard文件中，并将TableView覆盖整个View
  3. 打开Table View的属性检查器，将PrototypeCells的值设为1，注意不要添加多个，否则会发生错误；此时Table View会添加一个Table View Cell。
  4. 打开Table View Cell的属性检查器，设置Identifier属性。
  5. 注册UITableViewDataSource和UITableViewDelegate协议
  6. 编写代码实现功能

实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
//
//  ViewController.swift
//  TableViewDemo
//
//  Created by Michael on 2016/10/26.
//  Copyright © 2016年 Michael. All rights reserved.
//
import UIKit
class ViewController: UIViewController,UITableViewDataSource,UITableViewDelegate {
    
    //全部数据
    var listItems: NSArray!
    override func viewDidLoad() {
        super.viewDidLoad()
        
        //读取资源文件数据
        let listPath = Bundle.main.path(forResource: "team", ofType: "plist")
        self.listItems = NSArray(contentsOfFile: listPath!)
    }
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
    //返回列表每行的视图
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    //根据Identifier找到Cell
        let cell = tableView.dequeueReusableCell(withIdentifier: "CustomId", for: indexPath)
        let row = indexPath.row
        
        let rowDict = self.listItems[row] as! NSDictionary
        cell.textLabel?.text = rowDict["name"] as? String
        cell.detailTextLabel?.text = "123"
        
        let imagePath = String(format: "%@.png", rowDict["image"] as! String)
        cell.imageView?.image = UIImage(named: imagePath)
        cell.accessoryType = UITableViewCellAccessoryType.disclosureIndicator
        return cell
    }
    //返回条目数目
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return self.listItems.count
    }
    
    //响应条目点击事件
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        print("点击事件")
    }
    
}

示例图

  • none模式

  • disclosureIndicator

UITableViewController根视图控制器实现表视图

步骤

  1. 创建一个iOS工程
  2. 删除storyboard中View Controller Scene 中的View Controller，再从对象库拖入一个Table View Controller到设计界面
  3. 打开Table View Controller属性检查器，勾选Is Initial View Controller选项，否则应用启动后是黑屏
  4. 将ViewController类的父类由UIViewController改为UITableViewController
  5. 打开View Controller的属性选择器在Class列表中选择ViewController
  6. UITableViewController默认以注册UITableViewDataSource和UITableViewDelegate协议，不需要再注册

实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
import UIKit
class ViewController: UITableViewController {
    
    //全部数据
    var listItems: NSArray!
    override func viewDidLoad() {
        super.viewDidLoad()
        
        //读取资源文件数据
        let listPath = Bundle.main.path(forResource: "team", ofType: "plist")
        self.listItems = NSArray(contentsOfFile: listPath!)
    }
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
    //返回列表每行的视图
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "CustomId", for: indexPath)
        let row = indexPath.row
        
        let rowDict = self.listItems[row] as! NSDictionary
        cell.textLabel?.text = rowDict["name"] as? String
        cell.detailTextLabel?.text = "123"
        
        let imagePath = String(format: "%@.png", rowDict["image"] as! String)
        cell.imageView?.image = UIImage(named: imagePath)
        cell.accessoryType = UITableViewCellAccessoryType.disclosureIndicator
        return cell
    }
    //返回条目数目
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return self.listItems.count
    }
    
    //响应条目点击事件
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        print("点击事件")
    }
    
}

示例图

  • detailButton模式

  • checkmark模式

自定义单元格

步骤

  1. 创建一个表视图工程
  2. 修改根视图控制器为表视图控制器UITableViewController，参照上节的步骤
  3. 从对象库中拖入控件到单元格内部，比如Lable和ImageView
  4. 创建自定义单元格类CustomCell文件，并继承UITableViewCell类
  5. 在设计界面中选择View Controller Scene中的Table View Cell，并打开属性检查器，将Class设为CustomCell类，并设置单元格的Identifier
  6. 为单元格中的控件Label和ImageView控件连接输出接口，将控件绑定到CustomCell类中
  7. 打开ViewController类，编写代码实现

实现

  • CustomCell类
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
//
//  CustomCell.swift
//  CustomCell
//
//  Created by Michael on 2016/10/25.
//  Copyright © 2016年 Michael. All rights reserved.
//
import UIKit
class CustomCell: UITableViewCell {
    @IBOutlet weak var mImage: UIImageView!
    @IBOutlet weak var mLabel: UILabel!
    override func awakeFromNib() {
        super.awakeFromNib()
        // Initialization code
    }
    override func setSelected(_ selected: Bool, animated: Bool) {
        super.setSelected(selected, animated: animated)
        // Configure the view for the selected state
    }
}
  • ViewController类
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
//
//  ViewController.swift
//  SimpleTableView
//
//  Created by Michael on 2016/10/24.
//  Copyright © 2016年 Michael. All rights reserved.
//
import UIKit
class ViewController: UITableViewController {
    
    var listItems: NSArray!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
        let listPath = Bundle.main.path(forResource: "team", ofType: "plist")
        self.listItems = NSArray(contentsOfFile: listPath!)
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
    
    
    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return self.listItems.count
    }
    
    
    
    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    //找到自定义单元格
        let cell:CustomCell! = tableView.dequeueReusableCell(withIdentifier: "CustomCellId", for: indexPath) as? CustomCell
        //let cell = UITableViewCell(style: .value1, reuseIdentifier: "CellIdentifier")
        let row = indexPath.row
        
        let rowDict = self.listItems[row] as! NSDictionary
        //设置控件属性
        cell.mLabel.text = rowDict["name"] as? String
        
        let imagePath = String(format: "%@.png", rowDict["image"] as! String)
        cell.mImage.image = UIImage(named: imagePath)
        cell.accessoryType = .disclosureIndicator
        return cell
        
    }
}

示例图

刘涤生 wechat