🍃
描述打破您UI的寂静,轻声细语或大声喊叫。 Whisper 是一个组件,可以使显示消息和应用内通知的任务变得简单。它内部有三种不同的视图。
Whispers
在导航栏底部显示一条简短的消息——可以是任何东西,从“干得好!”到错误消息。它可以包含图片甚至加载器。
喊话
使用这个漂亮的、可自定义的应用内通知,让用户知道应用程序内发生了什么。
口哨
这是所有中尺寸最小的一个,是您UI中美好的谨慎之处。
奖励
所有声音,以及颜色和字体都可以完全自定义。
吼叫(Shouts)有一个可选的操作,当用户点击时将会被调用,并且当吼叫消失时,你甚至还会收到消息。最后,如果您想要设置显示吼叫的时间长度,可以使用持续时长属性。
在低声(Whisper)模式中,您无需再考虑滚动视图内边距了——这将自动处理。作为一个额外的优点,在从一个视图控制器切换到另一个时,下一个控制器的偏移量会如预期那样调整。它就是那么简单!
使用
组件的使用非常简单,您只需在 Whisper 的情况下创建一条消息,在 Shout 的情况下发布一个公告,在 Whistle 的情况下发出低语。因为可能与 UITableViewController
中的 show
发生冲突,您需要显式使用 Whisper
命名空间来调用 show
。
为低语
let message = Message(title: "Enter your message here.", backgroundColor: .red)
// Show and hide a message after delay
Whisper.show(whisper: message, to: navigationController, action: .show)
// Present a permanent message
Whisper.show(whisper: message, to: navigationController, action: .present)
// Hide a message
Whisper.hide(whisperFrom: navigationController)
对大声疾呼
let announcement = Announcement(title: "Your title", subtitle: "Your subtitle", image: UIImage(named: "avatar"))
Whisper.show(shout: announcement, to: navigationController, completion: {
print("The shout was silent.")
})
关于哨声
let murmur = Murmur(title: "This is a small whistle...")
// Show and hide a message after delay
Whisper.show(whistle: murmur, action: .show(0.5))
// Present a permanent status bar message
Whisper.show(whistle: murmur, action: .present)
// Hide a message
Whisper.hide(whistleAfter: 3)
如果您想使用Objective-C版Whisper,您可以在此找到相关信息:这里。
安装
Whisper 可通过 CocoaPods 获取。要安装,只需将以下行添加到您的 Podfile 中
pod 'Whisper'
Whisper 还可通过 Carthage 获取。要安装,请在 Cartfile 中写入
github "hyperoslo/Whisper"
路线图
未来,我们的目标是不断改进并增加一些新特性。
- 改进偏移量和动画检测。
- 将更多与用户界面相关的组件添加到 Whisper 中。
- 更多定制点和 whispers 的更多尺寸。
- Whisper 和 Shouts 中的自定义操作。
- 我们欢迎新的、棒棒的想法,如果你有兴趣,请予以贡献! :)
作者
Hyper 制作了这个
贡献
我们非常欢迎您为 Whisper 做出贡献,请查阅贡献指南以获取更多信息。
许可证
Whisper可用在MIT许可证下。更多信息见LICENSE文件。