Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sedlacek-solutions/toast
Lightweight SwiftUI Library for displaying toast messages
https://github.com/sedlacek-solutions/toast
swift swiftui toast toast-message
Last synced: 10 days ago
JSON representation
Lightweight SwiftUI Library for displaying toast messages
- Host: GitHub
- URL: https://github.com/sedlacek-solutions/toast
- Owner: Sedlacek-Solutions
- License: mit
- Created: 2025-01-05T21:18:44.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-01-27T18:12:53.000Z (14 days ago)
- Last Synced: 2025-01-27T18:42:22.269Z (14 days ago)
- Topics: swift, swiftui, toast, toast-message
- Language: Swift
- Homepage:
- Size: 21.5 KB
- Stars: 17
- Watchers: 0
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Toast
## Description
`Toast` is a lightweight SwiftUI library that provides a simple way to display toast messages.
## Requirements
| Platform | Minimum Version |
|----------|-----------------|
| iOS | 17.0 |
| macOS | 14.0 |
## Get Started
1. Toast ViewModifier
```swift
import Toast
import SwiftUI
@MainActor
struct ExampleScreen {
@State var isLoading: Bool = false
@State var toastToPresent: Toast? = nil
@Sendable func onTask() async {
isLoading = true
defer { isLoading = false }
do {
try await Task.sleep(for: .seconds(1))
toastToPresent = .success(message: "Successfully did a thing!")
} catch {
toastToPresent = .error(message: "Failure to do a thing!")
}
}
}
extension ExampleScreen: View {
var body: some View {
VStack {
Spacer()
}
.task(onTask)
.toast($toastToPresent)
}
}
```
2. Convenience Initializers
```swift
/// Extension to the Toast struct to provide convenience initializers for different types of toasts.
extension Toast {
/// Creates a debug toast with a purple color and a debug icon.
public static func debug(message: String) -> Toast {...}
/// Creates an error toast with a red color and an error icon.
public static func error(message: String) -> Toast {...}
/// Creates an info toast with a blue color and an info icon.
public static func info(message: String) -> Toast {...}
/// Creates a notice toast with an orange color and a notice icon.
public static func notice(message: String) -> Toast {...}
/// Creates a success toast with a green color and a success icon.
public static func success(message: String) -> Toast {...}
/// Creates a warning toast with a yellow color and a warning icon.
public static func warning(message: String) -> Toast {...}
}
```
3. Additional Options for Toast ViewModifier
```swift
/// Shows a toast with a provided configuration.
/// - Parameters:
/// - toast: A binding to the toast to display.
/// - edge: The edge of the screen where the toast appears.
/// - autoDismissable: Whether the toast should automatically dismiss.
/// - onDismiss: A closure to call when the toast is dismissed.
/// - trailingView: A closure that returns an optional trailing view to be displayed in the toast.
func toast(
_ toast: Binding,
edge: VerticalEdge = .top,
autoDismissable: Bool = false,
onDismiss: @escaping () -> Void = {},
@ViewBuilder trailingView: @escaping () -> TrailingView? = { nil }
) -> some View {...}
```
4. Adding a Trailing Views to Toasts
```swift
/// Add interactive elements such as buttons, icons, or loading indicators to the toast message.
/// Example usage:
@MainActor
struct ExampleView {
@State private var toastToPresent: Toast? = nil
private func showAction() {
toastToPresent = .notice(message: "A software update is available.")
}
private func updateAction() {
print("Update Pressed")
}
}
extension ExampleView: View {
var body: some View {
Button("Show Update Toast", action: showAction)
.frame(maxWidth: .infinity, maxHeight: .infinity)
.padding(40)
.toast($toastToPresent, trailingView: updateButton)
}
@ViewBuilder
private func updateButton() -> some View {
if let toastToPresent {
Button("Update", action: updateAction)
.buttonStyle(
.toastTrailing(tintColor: toastToPresent.color)
)
}
}
}
```
## Features
- **Multiple Toast Types**: `success`, `error`, `info`, `warning`, `notice`
- **Supports Trailing Views**: Buttons, Icons, Loaders
- **Auto-Dismiss & Manual Dismiss**: Configurable behavior
- **Flexible Customization**: Accepts any SwiftUI view as a trailing element
## Example Use Cases
| Feature | Example |
|--------------------|------------------------------------------------|
| Simple Toast | `.toast($toast)` |
| Actionable Toast | `.toast($toast) { Button("OK") { ... } }` |
| Loading Indicator | `.toast($toast) { ProgressView() }` |
| Auto-dismiss Toast | `.toast($toast, autoDismissable: true)` |
## Previews
https://github.com/user-attachments/assets/a22d7e4e-e3dd-4733-8070-235c631e8292