PopUp

1.0.0

SwiftUI library of simple pop up view implementation.
maxgribov/PopUp

What's New

Initial

2024-01-28T15:36:18Z

PopUp basic implementation and documentation

PopUp

SwiftUI simple pop up view implementation:

drawing

Installing

PopUp Library can be installed using Swift Package Manager.

Use the package URL to search for the PopUp package: https://github.com/maxgribov/PopUp

For how-to integrate package dependencies refer to Adding Package Dependencies to Your App documentation.

Usage

Show

You can easily present a pop up with View modifier popUp. This is very similar how to present a sheet:

struct CustomAlertModel: Identifiable {
    var id: UUID = UUID()
    let title: String
    let message: String
}

struct ContentView: View {
    @State var customAlert: CustomAlertModel?
    var body: some View {
        
        Button("Show custom alert") {
            customAlert = CustomAlertModel(
                title: "Pop Up",
                message: "Some message here..."
            )
        }
        .popUp(item: $customAlert) { viewModel in
            CustomAlert(viewModel: viewModel)
        }
    }
}

struct CustomAlert: View {
    let viewModel: CustomAlertModel
    var body: some View {
        VStack {
            Text(viewModel.title)
                .font(.title)
            Text(viewModel.message)
        }
        .padding(40)
        .background(
            RoundedRectangle(cornerRadius: 30)
                .foregroundStyle(.white)
        )
    }
}

Customise

There are few methods that you can use to customise look and behaviour of the pop up:

Example:

struct ContentView: View {
    @State var customAlert: CustomAlertModel?
    var body: some View {
        
        Group {
            // ...
        }
        .popUp(item: $customAlert) { viewModel in
            CustomAlert(viewModel: viewModel)
        }
        .popUpBackgroundMaterial(.ultraThin)
    }
}

Notes

PopUp does not have any background or a style for the content (like the system alert view is for example). The look of your popup you have implement by yourself.

This is not a modal view (like a sheet for example). It can not cover views above it.

It is possible to open many pop ups one above other. There is no limitations like for the sheet.

System Requirements

Swift 5.9

  • iOS 15+
  • macOS 12+

License

This project is licensed under the MIT License - see the LICENSE file for details

Description

  • Swift Tools 5.9.0
View More Packages from this Author

Dependencies

  • None
Last updated: Sun Dec 15 2024 11:48:21 GMT-1000 (Hawaii-Aleutian Standard Time)