https://github.com/divadretlaw/customalert

🔔 Custom Alert for SwiftUI
https://github.com/divadretlaw/customalert

alert swift swiftui

Last synced: 3 days ago
JSON representation

🔔 Custom Alert for SwiftUI

• Host: GitHub
• URL: https://github.com/divadretlaw/customalert
• Owner: divadretlaw
• License: mit
• Created: 2022-04-03T17:07:53.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-16T09:18:52.000Z (about 1 month ago)
• Last Synced: 2024-12-13T17:25:49.263Z (10 days ago)
• Topics: alert, swift, swiftui
• Language: Swift
• Homepage:
• Size: 626 KB
• Stars: 200
• Watchers: 3
• Forks: 18
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CustomAlert

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fdivadretlaw%2FCustomAlert%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/divadretlaw/CustomAlert)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fdivadretlaw%2FCustomAlert%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/divadretlaw/CustomAlert)

## Why

In iOS Alerts cannot contain Images or anything other than Text. This allows you to easily customize the message part with any custom view.

While the alert is completely rebuilt in SwiftUI, it has been designed to look and behave exactly like a native alert. The alert uses it's own window to be displayed and utilizes accessibility scaling but with the advantage of a custom view.

If the content is too large because the text is too long or the text doesn't fit because of accessibility scaling the content will scroll just like in a SwiftUI Alert.

## Usage

| SwiftUI Alert | Custom Alert |

|:-:|:-:|

| ![Native Alert](Sources/CustomAlert/Documentation.docc/Resources/SwiftUI.png) | ![Custom Alert](Sources/CustomAlert/Documentation.docc/Resources/Custom.png) |

You can easily add an Image or change the Font used in the alert, or anything else to your imagination.

Something simple with an image and a text field



Or more complex layouts



The API is very similar to the SwiftUI Alerts

```swift

.customAlert("Some Fancy Alert", isPresented: $showAlert) {

    Text("I'm a custom Message")

        .font(.custom("Noteworthy", size: 24))

    Image(systemName: "swift")

        .resizable()

        .scaledToFit()

        .frame(maxHeight: 100)

        .foregroundColor(.blue)

} actions: {

    Button {

        // some Action

    } label: {

        Label("Swift", systemImage: "swift")

    }

    

    Button(role: .cancel) {

        // some Action

    } label: {

        Text("Cancel")

    }

}

```

You can create Side by Side Buttons using `MultiButton`

```swift

.customAlert("Alert with Side by Side Buttons", isPresented: $showAlert) {

    Text("Choose left or right")

} actions: {

    MultiButton {

        Button {

            // some Action

        } label: {

            Text("Left")

        }

        Button {

            // some Action

        } label: {

            Text("Right")

        }

    }

}

```

The alert is customizable via the `Environment`



```swift

.configureCustomAlert { configuration in

    // Adapt the default configuration

}

```

You can also display an Alert inline, within a `List` for example



```swift

CustomAlertRow {

    // Content

} actions: {

    // Actions

}

```

## Install

### SwiftPM

```

https://github.com/divadretlaw/CustomAlert.git

```

## License

See [LICENSE](LICENSE)

Copyright © 2024 David Walter (www.davidwalter.at)