ZTDropDownNotification 1.0.1

ZTDropDownNotification 1.0.1

测试已测试
语言语言 Obj-CObjective C
许可证 MIT
发布最新发布2017年8月

张涛维护。



  • 作者:
  • 张涛

ZTDropDownNotification 是一个可以在关键窗口顶部边缘显示下拉通知并且在持续一段时间后自动消失的通知类。默认布局可以显示只包含消息或消息和图标的组合。它还支持自定义布局,并可以直接显示自定义视图。此通知灵感来源于 Mobile QQ,旨在提供一种方便显示通知的方式。

要求

ZTDropDownNotification 在 iOS 8+ 上运行。它依赖于以下 Apple 框架,这些框架通常已经包含在大多数 Xcode 模板中

  • Foundation.framework
  • UIKit.framework

为了构建 ZTDropDownNotification,您需要最新的开发工具。旧版的 Xcode 版本可能也能工作,但不保证兼容性。

使用说明

只显示消息的通知

Swift

  ZTDropDownNotification.notifyMessage("content", withIcon: nil)

Ojbective-C

  [ZTDropDownNotification notifyMessage:@"content" withIcon:nil];

快捷方式通知消息

快捷方式通知方法使用 ZTNInfoIconKeyZTNSuccessIconKeyZTNFailureIconKey 来获取相应的图标。

例如,按照如下方式注册 ZTNSuccessIconKey 图标

Swift

  ZTDropDownNotification.registerIcons([
      ZTNSuccessIconKey: #imageLiteral(resourceName:"check_green")])

Ojbective-C

  [ZTDropDownNotification registerIcons:@{
      ZTNSuccessIconKey: [UIImage imageNamed:@"check_green"]
      }];

然后 notifySuccessMessage: 方法能够按预期工作

Swift

  ZTDropDownNotification.notifySuccessMessage("content")

Ojbective-C

  [ZTDropDownNotification notifySuccessMessage:@"content"];

注意:
如果在注册之前没有注册相应的图标,将会只显示“通知消息”

使用自定义图标显示消息

Swift

  ZTDropDownNotification.notifyMessage("content", withIconKey: "ExampleIconKey")

Ojbective-C

  [ZTDropDownNotification notifyMessage:@"content" withIconKey:@"ExampleIconKey"];

使用临时图标显示消息

Swift

  ZTDropDownNotification.notifyMessage("content", withIcon: #imageLiteral(resourceName:"thumbs_up_blue"))

Ojbective-C

  [ZTDropDownNotification notifyMessage:@"content" withIcon:[UIImage imageNamed:@"thumbs_up_blue"]];

将自定义布局设置为默认布局

Swift

  ZTDropDownNotification.setCustomLayoutGenerator { () -> UIView in
      return CustomLayout.init()
    }

Ojbective-C

  [ZTDropDownNotification setCustomLayoutGenerator:^UIView <ZTNLayout> * {
    return [CustomLayout new];
  }];

注意:
由于当前实现(1.0.0)的限制,自定义布局和视图应该在真实内容区域顶部留出 8pt 的高度区域。

重置为内置布局

Swift

  ZTDropDownNotification.setCustomLayoutGenerator(nil)

Ojbective-C

  [ZTDropDownNotification setCustomLayoutGenerator:nil];

显示自定义临时视图

Swift

  ZTDropDownNotification.notify(view)

Ojbective-C

  [ZTDropDownNotification notifyView:view];

注意:
由于当前实现(1.0.0)的限制,自定义布局和视图应该在真实内容区域顶部留出 8pt 的高度区域。

待办事项

  • [ ] 添加单元测试。
  • [ ] 集成Travis CI。
  • [ ] 找到一个更好的方案,避免当视图完全显示时在顶部边缘出现Spring动画。
  • [x] 支持Swift。

许可证

基于MIT许可证发布。