Swift如何为TableView添加空状态下的默认提示文本?
这个场景完全符合iOS官方设计规范的推荐实现,根本不需要手动往视图层级里硬加子视图,系统给UITableView预留了专门的属性——backgroundView,就是用来承载空状态引导、全局加载提示这类内容的。你之前尝试Storyboard加标签、单独做xib都失败,本质是踩了TableView的视图层级和自动布局的常见坑。
为什么之前的尝试会失效
- 直接在Storyboard往ViewController根视图加标签:
UITableView本身是占满整个内容区域的滚动视图,层级会盖在你手动加的普通子视图上面,标签自然被挡住看不到 - 把标签拖成TableView的子视图:当列表没有任何内容行的时候,TableView的
contentSize为0,没有正确做AutoLayout约束的标签会直接滑出可视区域,根本显示不出来 - 单独做xib:如果没有把xib加载出的视图正确对齐到TableView的边界,也会出现位置偏移、尺寸不对的问题
具体实现步骤
1. 初始化空状态提示视图
不需要做复杂的xib,直接在viewDidLoad里初始化引导标签,直接赋值给TableView的backgroundView属性即可,系统会自动让这个视图和TableView等大,不需要手动写frame或者约束:
// 初始化空状态引导标签 let emptyGuideLabel = UILabel() emptyGuideLabel.text = "还没有展示内容,发布第一条动态吧" emptyGuideLabel.textAlignment = .center emptyGuideLabel.numberOfLines = 0 emptyGuideLabel.textColor = .secondaryLabel // 直接作为TableView的背景视图赋值 tableView.backgroundView = emptyGuideLabel
如果需要更复杂的引导界面,完全可以用你之前做的单独xib实现,只需要把xib加载出的视图直接赋值给tableView.backgroundView就行,不需要手动添加约束,系统会自动对齐TableView的边界:
// 从xib加载自定义空状态视图 let emptyView = Bundle.main.loadNibNamed("EmptyGuideView", owner: nil)?.first as? UIView tableView.backgroundView = emptyView
2. 同步控制提示视图的显隐
封装统一的状态刷新逻辑,每当posts数组变化(不管是初始加载、分页加载、删除内容)的时候,同步判断列表是否为空,切换提示视图的显示状态:
func syncEmptyStateDisplay() { // 有内容时隐藏引导标签,无内容时显示 tableView.backgroundView?.isHidden = !posts.isEmpty }
一定要在两个关键时机调用这个方法:
- Firestore数据加载完成、拿到新的
posts数组之后,先调用syncEmptyStateDisplay(),再执行tableView.reloadData() - 分页加载完成、数组内容更新的时候,同样同步判断状态
另外可以顺带着优化下你现有代码的顺序:现在viewDidLoad里的tableView.reloadData()是在设置dataSource属性之前调用的,这行代码实际不会触发任何刷新,可以把注册cell、设置数据源、加载初始数据的顺序调整顺,避免无意义的调用。
关于设计规范的说明
你担心的“是不是不符合苹果设计规范”完全是多虑了:系统自带的备忘录、App Store、设置页的空列表引导,全都是通过UITableView.backgroundView实现的,这是苹果在设计指南里明确推荐的空状态实现方式,和Android系统里的空状态实现逻辑本质是一样的,不存在平台规范上的阻碍。
内容的提问来源于stack exchange,提问作者David

