MBToastMac

MBToastMac: macOS 的 Toasts。用 Swift 编写。

在 macOS 开发的世界里，清晰性和简洁性往往是有效用户交互的关键。MBToast 就是在这一思想指导下锻造出来的。

我们明白，每次交互，无论多短暂，都是用户和软件之间的一个接触点。这是一个通知、指导、安抚的机会。这就是我们为什么要开发一个不仅仅是闪过的消息系统，而是要丰富这些短暂的沟通时刻的系统。

为什么选择 MBToast？

简洁性：我们的库与您的 macOS 项目无缝集成，让您能够在不包含不必要功能的情况下轻松实现托盘。

效率：用 Swift 构建，它针对性能进行了优化，确保您的应用程序保持敏捷和响应。

定制性：虽然我们重视极简主义，但我们同样理解适应性很重要。根据您的应用程序美学进行定制，确保设计的一致性。

可靠性：每个交付的托盘都是经过严格测试和改进的结果，确保在各种使用场景中的可靠性。

深入 MBToast —— 在简约与功能之间。提升用户反馈，让每一条信息都发挥作用。

示例

要运行示例项目，首先克隆仓库，然后从 Example 目录中运行 pod install。

基本用法

1. 显示自定义 Toast 消息

显示具有自定义样式的基本 toast 消息

self.view.makeToast("Your Message Here")

2. 显示预定义的 Toast 样式

• 成功 Toast

self.view.makeToast("Your Message Here", style: MBToastStyleSuccess())

• 警告 Toast

self.view.makeToast("Your Message Here", style: MBToastStyleWarning())

• 信息 Toast

self.view.makeToast("Your Message Here", style: MBToastStyleInfo())

3. 显示进度 Toast

对于持续时间不确定的情况，请使用覆盖进度指示器。此功能确保在后台活动期间或等待响应时，用户能够得到通知。

• 开始进度

self.view.makeToastActivity()

• 停止进度

self.view.hideToastActivity()

定制化

您可以通过实现 Style 协议，完全自定义 toast 通知的外观和行为。此协议提供了广泛的属性进行调整，例如字体大小、边距调整、颜色标识等。通过实现此协议，您可以更好地定制 toast 的外观，以适应用户应用程序的主题和设计理念。

Style 协议属性

• fontSize：消息的字体大小。
• horizontalMargin：toast 的水平边距。
• verticalMargin：toast 的垂直边距。
• cornerRadius：toast 的圆角。
• font：消息的字体。
• backgroundColor：toast 的背景颜色。
• foregroundColor：消息文本的颜色。
• fadeInOutDuration：淡入/淡出动画的持续时间。
• fadeInOutDelay：开始淡出前的延迟。
• labelOriginWithMargin：包含边距的消息标签的原点。
• activitySize：进度指示器的大小。
• position：toast 在屏幕上的位置。
• icon：可选图标图像。默认为 nil。
• iconTint：图标色调颜色。如需提供，则为默认色。

自定义样式示例

创建您的自定义样式，您可以通过像下面这样实现 Style 协议

struct CustomToastStyle: Style {
    var fontSize: CGFloat = 14.0
    var fontSize: CGFloat = 14.0
    var horizontalMargin: CGFloat = 15.0
    var verticalMargin: CGFloat = 10.0
    var cornerRadius: CGFloat = 5.0
    var font: NSFont = NSFont.systemFont(ofSize: 14.0)
    var backgroundColor: NSColor = NSColor.black.withAlphaComponent(0.7)
    var foregroundColor: NSColor = NSColor.white
    var fadeInOutDuration: CGFloat = 0.3
    var fadeInOutDelay: CGFloat = 2.0
    var labelOriginWithMargin: CGPoint = CGPoint(x: 15.0, y: 10.0)
    var activitySize: CGSize = CGSize(width: 50, height: 50)
    var position: MBToastPosition = .bottom
    var icon: NSImage? = nil
    var iconTint: NSColor = NSColor.white
}

// Usage:
self.view.makeToast("Custom styled toast", style: CustomToastStyle())

安装

MBToast 可以通过 CocoaPods 获取。要安装它，只需将以下行添加到您的 Podfile 中

pod 'MBToastMac'

作者

Viorel Porumbescu
📧 [email protected]
📄 简历

许可证

MBToast 在 MIT 许可证下可用。有关更多信息，请参阅 LICENSE 文件。