DZNEmptyDataSet 1.8.1

您希望在 Podfile 中添加类似以下内容：

target 'MyApp' do
  pod 'DZNEmptyDataSet', '~> 1.8'
end

然后在终端内运行 pod install，或者从 CocoaPods.app 运行。

作为替代，要测试运行，请执行以下命令：

pod try DZNEmptyDataSet

DZNEmptyDataSet 1.8.1

作者
dzenbot

使用此库的项目

在此处添加您的项目到列表，并提供（320px 宽）的结果渲染。

空数据集模式

也称之空状态（Empty State）或空白页（Blank Slate）。

大多数应用都会显示内容列表（数据集），其中很多最终会为空，特别是对于新用户和空白账户来说。空白屏幕会因为不清楚发生什么，是否有错误/故障，或者用户是否需要在您的应用中执行某些操作才能消费内容而导致困惑。

请阅读关于 为空状态设计 的非常有意思的文章。

（这些是实际生活中的例子，可在“应用程序”样本项目中找到）

空数据集很有帮助

避免白屏，并告知用户屏幕为空的原因。
调起（尤其是在引导过程中）。
避免其他干扰机制，如显示错误警报。
保持一致性并改进用户体验。
展现品牌形象。

特性

与 UITableView 和 UICollectionView 兼容。也兼容 UISearchDisplayController 和 UIScrollView。
通过显示图片和/或标题标签和/或描述标签和/或按钮，提供了多种布局和外观的可能性。
使用 NSAttributedString 以便更容易地进行外观自定义。
使用自动布局自动将内容居中对齐到表格视图，支持自动旋转。还接受自定义垂直和水平对齐。
自定义背景颜色。
允许在整个表格视图矩形上执行点击手势（对于放弃第一个响应者或类似操作非常有用）。
为了进行更高级的自定义，它允许一个自定义视图。
兼容 Storyboard。
兼容 iOS 6 或更高版本。
兼容 iPhone 和 iPad。
适用于 App Store

本库的设计方式不需要你扩展UITableView或UICollectionView类。即使在使用UITableViewController或UICollectionViewController时，它也能正常工作。通过实现DZNEmptyDataSetSource和DZNEmptyDataSetDelegate协议，你可以完全自定义应用中空状态的内容和外观。

安装

可在CocoaPods中使用

pod 'DZNEmptyDataSet'

若想使用Carthage将DZNEmptyDataSet集成到你的Xcode项目中，请在你的Cartfile中指定它

github "dzenbot/DZNEmptyDataSet"

使用方法

要查看完整文档，请访问CocoaPods自动生成的文档

导入

#import "UIScrollView+EmptyDataSet.h"

除非你以框架的形式导入，否则请执行以下操作

#import "<DZNEmptyDataSet/UIScrollView+EmptyDataSet.h>"

协议一致性

实现dataSource和/或delegate。

@interface MainViewController : UITableViewController <DZNEmptyDataSetSource, DZNEmptyDataSetDelegate>

- (void)viewDidLoad
{
    [super viewDidLoad];

    self.tableView.emptyDataSetSource = self;
    self.tableView.emptyDataSetDelegate = self;

    // A little trick for removing the cell separators
    self.tableView.tableFooterView = [UIView new];
}

数据源实现

返回你在空状态上想显示的内容，并利用NSAttributedString功能来自定义文字的外观。

空状态的图片

- (UIImage *)imageForEmptyDataSet:(UIScrollView *)scrollView
{
    return [UIImage imageNamed:@"empty_placeholder"];
}

图片视图动画

- (CAAnimation *)imageAnimationForEmptyDataSet:(UIScrollView *)scrollView
{
    CABasicAnimation *animation = [CABasicAnimation animationWithKeyPath: @"transform"];

    animation.fromValue = [NSValue valueWithCATransform3D:CATransform3DIdentity];
    animation.toValue = [NSValue valueWithCATransform3D:CATransform3DMakeRotation(M_PI_2, 0.0, 0.0, 1.0)];

    animation.duration = 0.25;
    animation.cumulative = YES;
    animation.repeatCount = MAXFLOAT;

    return animation;
}

空状态标题的attritedString

- (NSAttributedString *)titleForEmptyDataSet:(UIScrollView *)scrollView
{
    NSString *text = @"Please Allow Photo Access";

    NSDictionary *attributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:18.0f],
                                 NSForegroundColorAttributeName: [UIColor darkGrayColor]};

    return [[NSAttributedString alloc] initWithString:text attributes:attributes];
}

空状态描述的attritedString

- (NSAttributedString *)descriptionForEmptyDataSet:(UIScrollView *)scrollView
{
    NSString *text = @"This allows you to share photos from your library and save photos to your camera roll.";

    NSMutableParagraphStyle *paragraph = [NSMutableParagraphStyle new];
    paragraph.lineBreakMode = NSLineBreakByWordWrapping;
    paragraph.alignment = NSTextAlignmentCenter;

    NSDictionary *attributes = @{NSFontAttributeName: [UIFont systemFontOfSize:14.0f],
                                 NSForegroundColorAttributeName: [UIColor lightGrayColor],
                                 NSParagraphStyleAttributeName: paragraph};

    return [[NSAttributedString alloc] initWithString:text attributes:attributes];                      
}

特定按钮状态的attritedString所使用的字符串

- (NSAttributedString *)buttonTitleForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state
{
    NSDictionary *attributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:17.0f]};

    return [[NSAttributedString alloc] initWithString:@"Continue" attributes:attributes];
}

或特定按钮状态所使用的图片

- (UIImage *)buttonImageForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state
{
    return [UIImage imageNamed:@"button_image"];
}

空状态背景色

- (UIColor *)backgroundColorForEmptyDataSet:(UIScrollView *)scrollView
{
    return [UIColor whiteColor];
}

如果需要一个更复杂的布局，你还可以返回一个自定义视图

- (UIView *)customViewForEmptyDataSet:(UIScrollView *)scrollView
{
    UIActivityIndicatorView *activityView = [[UIActivityIndicatorView alloc] initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleGray];
    [activityView startAnimating];
    return activityView;
}

此外，你还可以调整内容视图的垂直对齐方式（即：在tableHeaderView可见时非常有用）

- (CGFloat)verticalOffsetForEmptyDataSet:(UIScrollView *)scrollView
{
    return -self.tableView.tableHeaderView.frame.size.height/2.0f;
}

最后，你可以将组件分开（默认间隔为11点）

- (CGFloat)spaceHeightForEmptyDataSet:(UIScrollView *)scrollView
{
    return 20.0f;
}

代理实现

返回你期望从空状态得到的行为，并接收用户的事件。

询问是否应该渲染和显示空状态（默认为YES）

- (BOOL)emptyDataSetShouldDisplay:(UIScrollView *)scrollView
{
    return YES;
}

请求交互权限（默认为YES）

- (BOOL)emptyDataSetShouldAllowTouch:(UIScrollView *)scrollView
{
    return YES;
}

请求滚动权限（默认为NO）

- (BOOL)emptyDataSetShouldAllowScroll:(UIScrollView *)scrollView
{
    return YES;
}

请求图片视图动画权限（默认为NO）

- (BOOL) emptyDataSetShouldAllowImageViewAnimate:(UIScrollView *)scrollView
{
    return YES;
}

在dataset视图被点击时通知

- (void)emptyDataSet:(UIScrollView *)scrollView didTapView:(UIView *)view
{
    // Do something
}

在dataset的操作按钮被点击时通知

- (void)emptyDataSet:(UIScrollView *)scrollView didTapButton:(UIButton *)button
{
    // Do something
}

刷新布局

如果你需要刷新空状态布局，只需调用

[self.tableView reloadData];

或

[self.collectionView reloadData];

这取决于你使用的是哪种方式。

强制布局更新

你也可以调用[self.tableView reloadEmptyDataSet]来使当前的空状态布局无效并触发布局更新，绕过-reloadData。这可能在你有很多不想在不需要时调用逻辑的数据源时很有用。[self.scrollView reloadEmptyDataSet]是在使用UIScrollView时刷新内容的唯一方法。

示例项目

应用程序

此项目模仿了几个流行的应用（约20个）的空状态，内容和外观完全一致，例如Airbnb、Dropbox、Facebook、Foursquare以及许多其他应用。看看定制空状态外观有多容易和多灵活。您还可以将此项目用作试验场来测试事物。

国家

此项目显示了一个从CoreData加载的世界国家列表。它使用NSFetchedResultsController进行搜索过滤。当搜索时没有匹配的内容，会显示简单的空状态。看看如何在使用典型的CoreData栈的同时，在UITableViewDataSource和DZNEmptyDataSetSource协议之间进行交互。

颜色

此项目是一个简单的示例，说明此库在Storyboards的使用下，如何与UICollectionView和UISearchDisplayController一起工作。

协作

欢迎自由协作，提出想法、问题或拉取请求。

许可

(MIT许可)

根据以下条件，任何人都可以不收取费用获得本软件和相关文档文件的副本（“软件”），使用该软件不受限制，包括无限制地使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许向提供软件的个人授权进行此类操作：