Skip to content
프로젝트

ChenYilong/CYLTableViewPlaceHolder

GitHub에서 보기

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

Original

CYLTableViewPlaceHolder【一行代码完成“空TableView占位视图”管理】

![pod-v1.1.0](https://img.shields.io/badge/pod-v1.1.0-brightgreen.svg) ![Objective--C-compatible](https://img.shields.io/badge/Objective--C-compatible-orange.svg) ![platform-iOS-12.0+](https://img.shields.io/badge/platform-iOS%2012.0%2B-ff69b4.svg)

导航

  1. 与其他框架的区别
  2. 集成后的效果
  3. 使用CYLTableViewPlaceHolder
  4. 运行Demo
  5. 适用于多种应用应用场景
  6. 网络故障
  7. 暂无数据

与其他框架的区别

- 特点 解释
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 不需要集成。

三步完成:

  1. 第一步:使用cocoaPods导入CYLTableViewPlaceHolder
  2. 第二步:遵循协议
  3. 第三步:使用cyl_reloadData代替reloadData

第一步:使用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;

这里注意两点:

  1. 默认占位视图填满 table view 的 bounds,宽高随 table view 调整。每次空数据刷新都会重新调用 makePlaceHolderView,因此可以切换网络错误与无数据视图。
  2. 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. 网络故障 1. 网络不可用,禁止重新加载
  2. 暂无数据

网络故障

适用于那些造成 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

관련 프로젝트 살펴보기

불러오는 중…