类似于Android的简单界面的toast。 (以前名为JLToast)
- 队列:集中式toast中心管理toast队列。
- 可定制:请参阅外观部分。
- 字符串或
AttributedString:两者都受支持。 - UIAccessibility:支持VoiceOver。
import Toaster
Toast(text: "Hello, world!").show()
安装
入门指南
设置持续时间与延迟
Toast(text: "Hello, world!", duration: Delay.long)
Toast(text: "Hello, world!", delay: Delay.short, duration: Delay.long)
移除Toast
-
使用引用移除Toast:
let toast = Toast(text: "Hello") toast.show() toast.cancel() // remove toast immediately
-
移除当前Toast:
if let currentToast = ToastCenter.default.currentToast { currentToast.cancel() }
-
移除所有Toast:
ToastCenter.default.cancelAll()
外观
从Toaster 2.0.0版本开始,您可以使用UIAppearance
设置默认外观。以下是一个设置默认背景色为红色的简短示例。
ToastView.appearance().backgroundColor = .red
支持的外观属性有
属性 | 类型 | 描述 |
---|---|---|
backgroundColor |
UIColor |
背景色 |
cornerRadius |
CGFloat |
圆角半径 |
textInsets |
UIEdgeInsets |
文本边距 |
textColor |
UIColor |
文本颜色 |
font |
UIFont |
字体 |
bottomOffsetPortrait |
CGFloat |
纵向偏移(适用于纵向模式) |
bottomOffsetLandscape |
CGFloat |
纵向偏移(适用于横向模式) |
shadowPath |
CGPath |
阴影的形状 |
shadowColor |
UIColor |
阴影颜色 |
shadowOpacity |
Float |
阴影透明度 |
shadowOffset |
CGSize |
阴影偏移(点为单位) |
shadowRadius |
CGFloat |
图层阴影渲染所用的 blur 半径(以点为单位) |
maxWidthRatio |
CGFloat |
窗口中 toast 视图的比例宽度 |
useSafeAreaForBottomOffset |
布尔值 |
一个布尔值,用于确定是否将 safeAreaInsets.bottom 添加到 bottomOffset |
属性字符串
自 Toaster 2.3.0以来,您还可以设置属性字符串
Toast(attributedText: NSAttributedString(string: "AttributedString Toast", attributes: [NSAttributedString.Key.backgroundColor: UIColor.yellow]))
无障碍访问
默认情况下,自 Toaster 2.3.0起已启用带 UIAccessibility 的 VoiceOver。要禁用它
ToastCenter.default.isSupportAccessibility = false