ChenYilong/CYLTableViewPlaceHolder
ChenYilong/CYLTableViewPlaceHolder has 889 GitHub stars and 160 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-21 12:14 UTC. Last push 2026-11-19.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- 기록 수집 중
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
一行代码完成“空TableView占位视图”管理
개발 도구README.md
OriginalCYLTableViewPlaceHolder【一行代码完成“空TableView占位视图”管理】
  
导航
与其他框架的区别
| - | 特点 | 解释 |
|---|---|---|
| 1 | 轻量级、无污染 | 基于 UITableView 分类,无污染,比基于子类化、继承的框架更加轻量级 |
| 2 | 低耦合 | 自定义占位视图的可自行实现,通过协议传递,耦合性极低。 |
| 3 | 简单,无学习成本 | 一行代码完成,仅需使用 cyl_reloadData 代替 reloadData 即可。自动检测是否需要 addSubview 和 removeFromSuperview ,省去学习繁琐的 add 和 remove 的调用时机。 |
| 4 | 使用方法简单 | 基于 dataSource 管理占位视图;内置的 CYLRefresh 提供下拉、上拉和横向刷新功能。 |
| 5 | 支持CocoaPods | 容易集成 |
(学习交流群:465239521)
集成后的效果

使用CYLTableViewPlaceHolder
自动占位视图(开发版本)
新增的 block API 支持 UITableView 和 UICollectionView,无需替换已有的
reloadData;旧的 cyl_reloadData 和 delegate API 保持可用。以下功能尚未包含在
已发布的 1.1.0 中,使用时请集成包含这些改动的开发版本。
#import <CYLTableViewPlaceHolder/CYLTableViewPlaceHolder.h>
[self.tableView cyl_placeholderViewBlock:^UIView *(UITableView *tableView) {
tableView.scrollEnabled = NO;
return [CYLPlaceholderView new]; // 也可返回自定义视图
} backToNormalBlock:^(UITableView *tableView) {
tableView.scrollEnabled = YES;
}];
// 取消自动占位;若占位视图正在显示,会调用恢复 block。
[self.tableView cyl_placeholderViewBlock:nil];
tableView.cyl_placeholderViewBlock({ tableView in
tableView.isScrollEnabled = false
return CYLPlaceholderView()
}, backToNormalBlock: { tableView in
tableView.isScrollEnabled = true
})
UICollectionView 使用同名接口和对应的 collection view block 参数。空状态以所有
section 的行或 item 数为准;没有 data source 时不显示占位。支持 reloadData、
data source 更换、section/row/item 的插入、删除、刷新和移动、批量更新,以及
iOS 15 的 reconfigure 操作。更新会在主队列合并处理;请在主线程配置并更新 UI。
占位视图使用 frame layout guide 约束,随列表可视区域及尺寸变化调整。
block 若引用控制器,请使用弱引用避免循环引用。内置 CYLPlaceholderView 的图片及
中英文文本位于 CYLTableViewPlaceHolder.bundle,可自行调整其 imageView 和 textLabel。
CYLPlaceholderStyle 提供 51 种离线图片,CYLPlaceholderMessage 提供 9 种
可独立组合的提示;内置英文、简体中文、繁体中文和日文,按应用语言选择并回退英文。
初始化或自定义图片与文字:
CYLPlaceholderView *offline =
[[CYLPlaceholderView alloc] initWithStyle:CYLPlaceholderStyleNoInternet
message:CYLPlaceholderMessageNoInternet];
CYLPlaceholderView *customText =
[[CYLPlaceholderView alloc] initWithStyle:CYLPlaceholderStyleWarning
text:@"请稍后再试"];
CYLPlaceholderView *customBoth =
[[CYLPlaceholderView alloc] initWithImage:myImage text:@"自定义提示"];
// 继续按需修改,例如 customBoth.textLabel.font 或 customBoth.imageView.tintColor。
let offline = CYLPlaceholderView(style: .noInternet, message: .noInternet)
let custom = CYLPlaceholderView(image: myImage, text: "自定义提示")
传入 nil 图片或文字会隐藏相应内容。内置 Material 图标使用模板渲染,可通过
imageView.tintColor 自定义颜色;默认 Empty 图保持原样。可调用
imageForStyle:、imageNameForStyle: 和 localizedTextForMessage: 单独获取资源。
内置图标及许可随资源包离线提供,不需要网络。示例中打开 Auto → Styles,
点击样式和文案即可预览任意组合;也可输入自定义文案并体验自定义图片。
资源包还提供 CYLPlaceholderNoResults、CYLPlaceholderNoInternet、
CYLPlaceholderError、CYLPlaceholderWarning 和 CYLPlaceholderInbox 图标,
分别适用于无搜索结果、无网络、错误、警告和空收件箱;它们不改变默认图片。
可使用 UIImage 的 imageNamed:inBundle:compatibleWithTraitCollection: 从该资源包加载。
图标来自 Google Material Design,许可及来源记录随资源包分发。
也可以用字典或本地 plist 创建 FlatDesign 风格的图片与标题组合:
NSDictionary *item = @{
CYLPlaceholderItemStyle: @(CYLPlaceholderStyleNoInternet),
CYLPlaceholderItemMessage: @(CYLPlaceholderMessageNoInternet),
CYLPlaceholderItemImagePositionAdjustment: @[@8, @(-6)],
CYLPlaceholderItemTitlePositionAdjustment: @[@0, @6],
CYLPlaceholderItemAnimationFilePath: @"future-animation.json"
};
NSError *error = nil;
CYLPlaceholderView *view = [[CYLPlaceholderView alloc] initWithItemAttributes:item
imageBundle:nil
error:&error];
// 或使用 initWithItemContentsOfURL:imageBundle:error: 读取本地 plist。
配置项兼容 CYLTabBarItemTitle、CYLTabBarItemImage、CYLTabBarItemImageInsets、
CYLTabBarItemImagePositionAdjustment 和 CYLTabBarItemTitlePositionAdjustment
的序列化名称;本库导出的常量使用 CYLPlaceholderItem 前缀,避免与
CYLTabBarController 冲突。图片可传 UIImage 或指定 bundle 中的图片名;bundle
为 nil 时使用本库资源包。显式图片和标题优先于预设样式和文案。偏移量支持
[horizontal, vertical]、包含 horizontal/vertical 或 x/y 的字典,以及
代码传入的 NSValue;内边距支持四元素数组、top/left/bottom/right
字典或 NSValue。静态配置错误通过 NSError 返回,动画加载错误记录日志并回退;
不加载网络资源。
普通状态的文字、图标、背景颜色支持 UIColor 或 #RGB、#RRGGBB、
#RRGGBBAA;文字字体支持 UIFont、字号、bold:18 或包含 name、size、
weight 的字典。图片名也支持 iOS 13 及以上的 system: SF Symbols。可配置
无障碍标识、标签和提示。
可设置 view.selected = YES 使用 CYLPlaceholderItemSelectedImage、
CYLPlaceholderItemSelectedTitle 以及选中态颜色和字体;恢复普通态时保留进入
选中态前对普通图片、文字和样式的修改。选中状态设置 VoiceOver 的 selected trait。
CYLPlaceholderItemDarkImage 和 CYLPlaceholderItemSelectedDarkImage 支持
UIImage 或资源名,在 iOS 13 及以上按界面外观选择相应图片;只提供其中一个
图片时,该图片作为所有外观的回退。
设置 selectionIndicatorImage 可在选中项后方显示指示图,另可设置
selectionIndicatorTintColor。
角标可通过 showBadgeWithStyle:value: 选择隐藏、红点、数字或自定义文字;
数字大于 99 显示为 99+,不大于 0 时隐藏。也可直接设置 badgeValue
(nil 隐藏,空字符串显示红点)、badgeCenterOffset 和 badgeLabel 的字体与颜色。
角标会作为占位视图的无障碍值;红点使用本地化的“有新内容”。占位视图本身不是
无障碍元素时,角标标签可独立朗读;若外层容器本身是无障碍元素,应由调用方
提供包含角标含义的标签或值。示例的 Styles 列表包含三种角标预览。
图片与标题作为一个居中的整体布局;item 内移植 FlatDesign 的图片和标题定位、
图片原始尺寸及偏移计算,长文案在可用宽度内换行;只有图片或文字时单独居中。
图片与标题可分别设置偏移。通过 CYLPlaceholderItemGIFURL 或
CYLPlaceholderItemGIFFilePath 可传入本地 GIF;CYLPlaceholderItemGIFSize
支持 [width, height]、尺寸字典或 NSValue。GIF 在进入窗口时播放一次,
离开窗口时停止;启用“减弱动态效果”时保持首帧。GIF 不支持网络地址。
GIF 输入最大 16 MB、最多 500 帧,解码帧合计最多 64 MB;无效资源或超限时
记录错误并保留静态占位图。可通过 playPlaceholderAnimation、
stopPlaceholderAnimation 和 showPlaceholderAnimationLastFrame 重播、停止或显示末帧;
停止状态在离开并重新进入窗口后保留。Rive 状态机没有通用末帧,显示其静止状态。
setPlaceholderAnimationProgress: 可暂停并定位 Lottie 或 PAG 到 0–1 的进度;
setPlaceholderAnimationSpeed: 可设置 Lottie 的正数播放速度。方法返回 NO 表示
参数无效或当前后端不支持;PAG 定位到最近的帧。显式进度和速度在支持的后端
重新加载时会尝试恢复。
动画库的组织方式与 CYLTabBarController(feat/cross-platform-components)一致:
| 子规格 | 依赖 | 最低系统 | 说明 |
|---|---|---|---|
CYLPlaceholderItemAnimation |
无 | iOS 12 | 共用的 animator 协议、播放器、注册表、工厂与引擎,只由下列动画库子规格引入;旧名称 Animation 仍可用 |
LottieSwift(Lottie 为别名) |
lottie-ios ≥ 4.5.1 |
iOS 13 | Swift 桥接(LottieSwift/)加 Objective-C animator;不提供 Objective-C 版 Lottie 2.x |
PAG / PAGEnterprise |
libpag / libpag-enterprise ≥ 4.0 |
iOS 12 | 二选一,不能同时引入 |
Rive |
RiveRuntime ~> 6.29 |
iOS 14 | Swift 视图(RiveSwift/)遵守可播放视图协议 |
GIF |
ImageIO | iOS 12 | 通过注册表播放一次;未引入时 Core 内置解码器照常播放 GIF |
每个动画库的 animator 位于 CYLPlaceholderAnimation/<库名>/,在 +load 中向
CYLPlaceholderItemAnimatorRegistry 注册。应用可注册自己的 animator:实现
CYLPlaceholderItemAnimator,或用 CYLPlaceholderItemViewAnimator 包装一个遵守
CYLPlaceholderItemAnimationPlayableView 的视图。Core 不依赖任何动画库,默认不引入这些依赖。对应的
CYLPlaceholderItemLottieFilePath、CYLPlaceholderItemPAGFilePath、
CYLPlaceholderItemRiveFilePath 或通用动画路径可指定本地文件;支持对应的
尺寸键。Lottie 要求 iOS 13,Rive 要求 iOS 14。加载失败时记录错误并保留
静态图片。动画 URL 与路径支持各格式对应的 DarkURL/DarkFilePath,
深浅色切换时重新加载。Rive 的 CYLPlaceholderItemAnimationOptions 支持
artboard、stateMachine、数据绑定的 active、trigger 和 duration
(秒,0–60),也可通过 input、triggerInput 或 animation 选择旧版 Rive
状态机输入、触发器或线性动画。Lottie 和 PAG 已验证进度推进,Rive 已验证
画板加载、旧版布尔输入和离屏暂停;数据绑定播放效果尚未验证。
与 CYLTabBarController 相同,Carthage 只构建核心 framework;Lottie、PAG、Rive 与 GIF 子规格只通过 CocoaPods 提供。
CYLPlaceholderItemAnimationOptions 的 contentMode(数值或 scaleAspectFit 等名称)对所有动画库生效,
animationSpeed 设置初始播放速度(Lottie)。选项值必须是字符串或数字,以 URL fragment 传给 animator。
其他本地动画格式可通过 registerAnimationFactory:forFileExtension: 注册实现
CYLPlaceholderAnimationPlayer 的 UIView;工厂按扩展名匹配,可覆盖可选后端,
但 GIF 使用内置解码器。传入 nil 可取消注册。工厂及其回调在主线程使用;
资源加载失败时应通过 errorHandler 报告,加载完成时通过 readyHandler 通知。
Lottie 支持 CYLPlaceholderItemAnimationColors、CYLPlaceholderItemAnimationDarkColors
以及 CYLPlaceholderItemLottieDarkColors:字典的键是 Lottie keypath,值为
UIColor 或十六进制颜色字符串。深色配置覆盖普通配置,格式专属配置优先。
Rive 支持 CYLPlaceholderItemAnimationColors、CYLPlaceholderItemRiveDarkColors,键为 view model
颜色属性路径;color 选项设置浅色颜色。自定义播放器可实现 setAnimationColors:;PAG 与 GIF 与
CYLTabBarController 一样不支持颜色覆盖。Lottie keypath 颜色已通过渲染像素测试验证。
itemAttributes 保留传入的其他键,供将来使用;其他未实现的 TabBar 配置目前不会生效。示例 Auto → Styles
底部提供代码和 plist 两种配置演示。布局参考 CYLTabBarController;其 MIT 许可随资源包提供。
实现通过 method swizzling 拦截 UIKit 方法,影响进程中对应类的方法分发;未启用
block 的列表不安装占位视图。子类覆盖更新方法而不调用 super、以及 diffable
data source 的内部更新不保证触发检查。示例应用右上角的 Auto 可体验两种列表、
数据更新及取消功能。不要在同一个列表上同时依赖旧 API 与新 API;启用新 API
会移除旧占位视图。
开发版本可用 CocoaPods 本地路径或 Git 分支集成,例如
pod 'CYLTableViewPlaceHolder', :path => '../CYLTableViewPlaceHolder'。
Carthage 可使用 github "ChenYilong/CYLTableViewPlaceHolder" "<branch-or-commit>",
以 carthage update --use-xcframeworks --platform iOS 构建,将
CYLTableViewPlaceHolder.xcframework 链接并嵌入应用;资源 bundle 已包含在 framework
中。仓库中的 Examples/Example-placeholder 草稿也会被 Carthage 发现并构建,其生成的
KLTableViewAndCollectionViewPlaceholder.xcframework 不需要集成。
三步完成:
第一步:使用CocoaPods导入CYLTableViewPlaceHolder
在 Podfile 中进行如下导入:
pod 'CYLTableViewPlaceHolder', '~> 1.1.0'
1.1.0 内置 CYLRefresh;历史版本不会自动包含新功能。本库最低支持 iOS 12,不再需要单独添加刷新库。使用旧刷新库的项目需将原有类名和分类接口迁移到 CYLRefresh / cyl_。
开发版本也可通过 Git 分支或本地 :path 集成。分页刷新等已知限制及验证状态见 docs/issue-progress.md。
然后使用 cocoaPods 进行安装:
如果尚未安装 CocoaPods, 运行以下命令进行安装:
gem install cocoapods
安装成功后就可以安装依赖了:
建议使用如下方式:
# 禁止升级CocoaPods的spec仓库,否则会卡在 Analyzing dependencies ,非常慢
pod update --verbose --no-repo-update
如果提示找不到库,则可去掉 --no-repo-update
pod update
第二步:遵循协议
导入头文件
#import "CYLTableViewPlaceHolder.h"
遵循协议
@interface ViewController ()<CYLTableViewPlaceHolderDelegate>
实现协议方法:
仅一个必须实现的协议方法:
创建一个自定义的占位视图并返回
@required
/*!
@brief make an empty overlay view when the tableView is empty
@return an empty overlay view
*/
- (UIView *)makePlaceHolderView;
这里注意两点:
- 默认占位视图填满 table view 的 bounds,宽高随 table view 调整。每次空数据刷新都会重新调用
makePlaceHolderView,因此可以切换网络错误与无数据视图。 makePlaceHolderView可由自定义 table view、delegate 或独立的 data source 实现,按此顺序查找;应返回非空视图。
如果表头或刷新 footer 需要保持可见,可在提供占位图的对象中实现可选方法,返回 table view 坐标系中的区域;每次布局需求变化时调用 cyl_reloadData 更新区域:
- (CGRect)frameForPlaceHolderViewInTableView:(UITableView *)tableView {
CGFloat top = CGRectGetMaxY(tableView.tableHeaderView.frame);
return CGRectMake(0, top, CGRectGetWidth(tableView.bounds),
MAX(0, CGRectGetHeight(tableView.bounds) - top));
}
自定义 frame 不会自动跟随尺寸变化,必要时请为返回的视图设置 autoresizing mask,或在布局变化后重新加载。对于 section header 和刷新 footer,需根据它们在 table view 内容坐标系中的实际 frame 计算不重叠区域;空数据时自动 footer 不一定在屏幕底部。占位图仍位于其 frame 内其他子视图之上。
例如,在使用 CYLRefreshAutoNormalFooter 且 footer 位于内容顶部的场景中,可将占位图放在 footer 之后:
- (CGRect)frameForPlaceHolderViewInTableView:(UITableView *)tableView {
CGFloat top = CGRectGetMaxY(tableView.cyl_footer.frame);
return CGRectMake(0, top, CGRectGetWidth(tableView.bounds),
MAX(0, CGRectGetHeight(tableView.bounds) - top));
}
此示例不是所有布局的通用解:footer 位置变化后应重新计算;若还有表头或 section header,也需结合它们的实际位置。
既可以让代理遵循协议,实现协议方法:
@interface ViewController ()<CYLTableViewPlaceHolderDelegate>
也可以让自定义的 TableView 遵循协议,实现协议方法:
@interface MyTableView ()<CYLTableViewPlaceHolderDelegate>
这里推荐在自定义的 TableView 中实现,以降低耦合性,同时也可以为 Controller 瘦身。
占位视图的点击事件等,请自行在 - (UIView *)makePlaceHolderView; 中所创建的 View 中实现。
另外,占位视图默认的设置是不能滚动的,也就不能下拉刷新了,但是如果想让占位视图可以滚动,则需要实现下面的可选代理方法。
@optional
/*!
@brief enable tableView scroll when place holder view is showing,it is disabled by default.
@return YES 表示可滚动,NO 表示不可滚动
*/
- (BOOL)enableScrollWhenPlaceHolderViewShowing;
第三步:使用cyl_reloadData代替reloadData
使用方法:
仅需使用 cyl_reloadData 代替 reloadData 即可。
[self.tableView cyl_reloadData];
注意: cyl_reloadData 内部已经实现了 [self.tableView reloadData]; 方法,请避免重复调用。
占位图功能只管理 UITableView,不管理 UICollectionView 或普通页面;这些场景需要各自的空状态实现。使用独立 data source 时,delegate 或 table view 仍可负责创建占位图,也可以让 data source 实现该协议。
内置刷新组件
CYLRefresh 源码位于 CYLTableViewPlaceHolder/CYLRefresh/,可直接修改,无需安装额外的刷新 Pod。导入 CYLTableViewPlaceHolder.h 后:
self.tableView.cyl_header = [CYLRefreshNormalHeader headerWithRefreshingBlock:^{
// 加载数据,完成后调用 endRefreshing
}];
self.tableView.cyl_footer = [CYLRefreshAutoNormalFooter footerWithRefreshingBlock:^{
// 加载更多数据,完成后调用 endRefreshing
}];
原刷新库 API 已改名:类名前缀改为 CYL,分类属性和方法使用 cyl_。这是一次 API 不兼容的迁移:应用中的旧类名、属性、分类方法及自定义本地化 key 需要相应修改。分类上的旧版无前缀 header / footer 不再提供。使用源码手动集成时,除所有 .h、.m 外,还须将 CYLRefresh 目录及其子目录加入 Header Search Paths,并复制 CYLRefresh.bundle、PrivacyInfo.xcprivacy 和 LICENSE.third-party 到应用资源。静态库集成需要使用 -ObjC 链接分类。
endRefreshing、endRefreshingWithNoMoreData 和 resetNoMoreData 在主线程立即更新状态;从后台线程调用时仍异步提交到主队列。自动 footer 在 header 正在刷新时不会自动触发,但这不是所有 header/footer 类型的双向互斥。
开启分页时,自动 footer 结束刷新不会再直接减去整个底部 inset:静止时只将超出正常内容范围的 offset 限制回边界;拖拽或减速期间不主动改写 offset,由滚动视图完成回弹。
Examples/Example-SwiftUI/ 是改编自上游 #1628 报告者示例的 SwiftUI 调查工程,也包含 #1589 的 UIViewRepresentable footer 生命周期页面。Examples/Example-objc-01/ 是改编自上游 #1575 报告者示例的 UIKit collection 工程;虽然目录名为 objc,原示例使用 Swift。两个工程分别在各自目录运行 pod install 后打开对应的 .xcworkspace,都通过 :path => '../..' 使用本地库。SwiftUI 示例默认避免重复安装刷新控件;以启动参数 -reproduce-1628 可运行原始重复配置场景。真实下拉时的刷新可见性仍在调查,不能将默认示例视为完整修复。
Examples/Example-objc-02/ 目前移植了 #1523 原工程的 collection 控制器,而非原工程全部页面;增加 back footer 用于检查 #1506,并支持连续下拉检查 #1483。运行 pod install 后打开该目录下的 workspace;手势完成及静止位置测试不能替代对动画闪烁或漂移的逐帧验证。
从横向刷新切换到纵向刷新时,应先设置 scrollView.cyl_trailer = nil,再配置纵向 footer。移除正在刷新的 trailer 会先结束刷新,撤回它增加的右侧 inset,并恢复之前的横向弹性滚动设置;同时保留调用方之后对 inset 所做的修改。如果在开始动画完成前结束或移除 trailer,该次刷新回调和开始完成回调不会执行,结束完成回调仍会执行。复用 trailer 时,旧动画不会触发新一轮刷新回调或重置新一轮的拉动进度;重叠的结束动画分别调用各自开始时的完成回调。
需要跟踪滚动方向时,先调用一次 [scrollView cyl_updateScrollMetrics] 建立基准,再在每次 scrollViewDidScroll: 中调用一次;cyl_scrollDistance 和 cyl_scrollDirection 可重复读取同一次采样。距离为主导轴上的带符号点数,方向表示 content offset 的变化方向;首次采样距离为零,方向为 CYLScrollDirectionNone。
刷新组件依据本地源码中声明的 3.7.9 版本改造,适用第三方 MIT 许可证;原版权声明、许可证及来源说明保留在源码和 CYLRefresh/LICENSE.third-party 中。
运行Demo
主 Demo 源码位于 Examples/Example/,直接编译刷新源码,打开根目录的 CYLTableViewPlaceHolder.xcodeproj 或 workspace 即可,无需运行 pod install。发布源码和资源集中在 CYLTableViewPlaceHolder/:占位组件位于 CYLTableViewPlaceHolder/CYLTableViewPlaceHolder/,刷新组件位于 CYLTableViewPlaceHolder/CYLRefresh/,均由根目录的 podspec 指定。Xcode 27 的模拟器 SDK 使用 iOS 15 构建设置,真机最低版本仍为 iOS 12。
三个 Example-* 复现工程使用本地 Pod,分别在各自目录运行 pod install 后打开 workspace;它们的应用和 Pods 最低版本为 iOS 15,与库的 iOS 12 最低版本不同。
适用于多种应用应用场景
CYLTableViewPlaceHolder 是基于 dataSource 数据源是否为空,所以只需操作 dataSource 数据源,即可完成占位视图的 。只要为空就会触发。并且每次在操作占位视图的 addSubview和removeFromSuperview时,每次都会将旧的销毁,并触发- (UIView *)makePlaceHolderView` 创建一个新的视图。如果在该方法中进行 if 判断,也就能适用于不同的场景。
- 网络故障 1. 网络不可用,禁止重新加载
- 暂无数据
网络故障
适用于那些造成 dataSource 为空的原因只能是网络故障,比如首页、团购列表、商品列表等
比如
| 携程 网络故障 | 携程 网络故障 | 携程 网络故障 |
|---|---|---|
![]() |
![]() |
![]() |
代码实现时直接返回网络故障占位视图,用伪代码表示则是:
- (UIView *)makePlaceHolderView {
return NetNotAvailableView;
}
网络不可用,禁止重新加载
如果此时检测到网络断开可以禁止用户刷新的行为,比如:
| QQ空间 | 苏宁易购 | 嘟嘟美甲 |
|---|---|---|
![]() |
![]() |
![]() |
暂无数据
适用于那些造成 dataSource 为空的原因不仅有网络故障,也可能是确实是服务端也没有数据,这种场景下需要判断下当前网络再返回占位视图,比如:
| App | 暂无数据 | 网络故障 |
|---|---|---|
| 百度传课 | ![]() |
![]() |
| 暂无数据 | 暂无数据(美团) |
|---|---|
![]() |
![]() |
代码实现,用伪代码表示则是:
- (UIView *)makePlaceHolderView {
if (NetNotAvailable) {
return NetNotAvailableView;
} else {
return NoDataView;
}
}
网络不可达场景
- | 应用场景之加载失败 | ---
-------------|-------------|-------------
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(更多iOS开发干货,欢迎关注 微博@iOS程序犭袁 )
Posted by 微博@iOS程序犭袁
原创文章,版权声明:自由转载-非商用-非衍生-保持署名 | Creative Commons BY-NC-ND 3.0
관련 프로젝트 살펴보기
불러오는 중…









