FMListPlaceholder 1.1.5

FMListPlaceholder 1.1.5

×

由 Mingoy 维护。

FMListPlaceholder 1.1.5

FMListPlaceholder

platform languages cocoapods support

中文说明

列表视图（UITableView，UICollectionView）的令人愉悦的占位符。

一行代码即可处理空列表占位符逻辑。

0x001 与其他类似项的区别：

  • 当您进入列表时，不会立即显示占位符。逻辑会在网络请求完成后再次刷新列表时处理。
  • 简单、高效、实用，一行代码即可集成；
  • 提供更全面和高度定制的效果。
  • 可以用一行代码替换默认效果。设置自己的全局默认效果。您还可以在特定列表中再次自定义效果。
  • 支持将自定义视图用作占位符。

0x002 渲染

0x003 如何使用

  • 使用CocoaPods
    • 在Podfile文件中写入pod "FMListPlaceholder"。
    • 打开终端，切换到项目的目录下，运行pod install。
    • 导入主文件：#import <FMListPlaceholder.h>
  • 手动导入：
    • 将FMListPlaceholder文件夹中的所有文件拖入项目。
    • 导入主文件：#import "FMListPlaceholder.h"
一行式使用
_tableView.needPlaceholderView = YES;   //the same as UICollectionView

或使用以下命令

自定义全局默认
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    [FMListPlaceholder fm_defaultBackgroundColor:UIColor.whiteColor coverName:@"xxx" tips:@"Sorroy,nil here!" tipsTextColor:UIColor.grayColor tipsFont:[UIFont systemFontOfSize:16] coverSize:CGSizeZero coverCenterYOffset:-30 coverSpaceToTips:10];

    return YES;
}

0x004 自定义

自定义一个列表
[_tableView fm_emptyCoverName:@"fm_placeholder_nil" emptyTips:@" "];
[_tableView fm_backgroundColor:[UIColor colorWithRed:0.91 green:0.90 blue:0.90 alpha:1.00] tipsTextColor:UIColor.redColor tipsFont:nil];
[_tableView fm_coverCenterYOffset:-80 coverSize:CGSizeMake(90, 120) coverSpaceToTips:20];
// the same as UICollectionView

点击重载处理
_tableView.reloadBlock = ^(UIScrollView *listView) {
  // Reload Handle is Here!
  // [listView.mj_header beginRefreshing]; // reloadData
};
详细信息（详细信息请查看FMListPlaceholderExample示例程序）

0x005 Hope

  • 在过程中有任何疑问或需要更多接口定制，请向我提出问题！与其给我星星，不如向我提交一个错误报告！
  • 如果想要参与这个项目的维护或有好的设计风格，欢迎发起 Pull Request！
  • 如果您在使用过程中感到有些不适，请与我联系。
  • 希望一起改进这个项目，让它变得更加强大，能够满足大多数用户的需求！

0x006 更新日志

2019.01.23 V1.1.0

  • [+] 支持将自定义视图作为占位符；
  • [+] 添加了一些用法示例

0x007 QQ 聊天室

0x008 需求

  • iOS 9.0 及以上
  • Xcode 9.0 及以上

0x009 许可证

所有源代码均采用MIT许可证（许可证链接）。

MIT许可证

版权所有© 2019 Fleeming

本软件的任何副本及相关的文档文件（以下简称“软件”）的持有者可以免费、不受限制地使用软件，包括但不限于使用、复制、修改、合并、发布、分发、再授权和/或出售软件副本，以及允许软件提供者使用软件，前提是必须要遵守以下条件：

必须在任何软件的副本或主要部分的复制中包含上述版权声明和本许可声明。

软件按“现状”提供，不提供任何形式的保证，无论是明示还是暗示，包括但不限于对适销性、特定用途的适用性以及非侵权的保证。在任何情况下，包括合同行为、侵权行为或其他行为，作者或版权所有者都不对任何索赔、损害或其他责任负责，这些索赔、损害或其他责任是由软件本身、软件的使用或与软件相关的其他行为引起的。