GTAlertCollection

The GTAlertCollection shared instance.

The presented alert controller.

The view controller that the alert controller is presented to.

The activity indicator of the alert.

The UIProgressView object that displays the progress bar.

The label right below the progress bar.

The image view of the alert.

Custom init method that accepts the host view controller as an argument.

You are advised to use this initializer when creating objects of this class and you are not using the shared instance.

It dismisses the alert controller.

It presents the alert controller with one action button only.

It presents an alert controller with as many action buttons as the buttonTitles array items, using the provided title and message for the displayed text. It can have one Cancel-styled and one or more Destructive-styled action buttons.

It presents a buttonless alert controller.

It presents a buttonless alert controller with an activity indicator in it. The indicator’s color and size can be optionally customized.

Implementation Example:

GTAlertCollection.shared.presentActivityAlert(withTitle: "Please wait",
                                              message: "You are being connected to your account...",
                                              activityIndicatorColor: .blue,
                                              showLargeIndicator: false) { (success) in
    if success {
        // The alert controller was presented successfully...
    }
}

It presents an alert controller that contains a text field, and two action buttons (Done & Cancel). Title and message are included too. The action button titles are modifiable.

Implementation Example:

GTAlertCollection.shared.presentSingleTextFieldAlert(withTitle: "Editor",
                                                     message: "Type something:",
                                                     doneButtonTitle: "OK",
                                                     cancelButtonTitle: "Cancel",
                                                     configurationHandler: { (textField, didFinishConfiguration) in

    if let textField = textField {
        // Configure the textfield properties.
        textField.delegate = self
        textField.placeholder = "Write here"
        // ... more configuration ...

        // Always call the following to let the alert controller appear.
        didFinishConfiguration()
    }

}) { (textField) in
    if let textField = textField {
        // Do something with the textfield's text.
    }
}

It presents an alert controller with variable number of text fields, as well as a Done and a Cancel action button. Titles of both are modifiable. Alert title and message included too.

Implementation Example:

GTAlertCollection.shared.presentMultipleTextFieldsAlert(withTitle: "Input Data",
                                                        message: "Lots of stuff to type here...",
                                                        doneButtonTitle: "OK",
                                                        cancelButtonTitle: "Cancel",
                                                        numberOfTextFields: 5,
                                                        configurationHandler: { (textFields, didFinishConfiguration) in
    if let textFields = textFields {
        let placeholders = ["First name", "Last name", "Nickname", "Email", "Password"]
        for i in 0..<textFields.count {
            textFields[i].placeholder = placeholders[i]
        }

        textFields.last?.isSecureTextEntry = true

        // ... more configuration ...

        didFinishConfiguration()
    }
}) { (textFields) in
    if let textFields = textFields {
        // Do something with the textfields.
    }
}

It presents a buttonless alert controller with a progress bar, and optionally a label indicating the progress percentage or the progress steps made out of all steps at any given moment.

The default configuration of the progress view and the label taking place in this method is good enough for most cases. However, if you want to set or modify additional properties on any of those two controls, you can use the class properties progressBar and label respectively.

Implementation Example:

// Step 1: In your class declare the following property:
var updateHandler: ((_ currentItem: Int, _ totalItems: Int) -> Void)!

// Step 2: Implement the alert presentation somewhere in a method:
GTAlertCollection.shared.presentProgressBarAlert(withTitle: "Upload", message: "Your files are being uploaded...", progressTintColor: .red, trackTintColor: .lightGray, showPercentage: true, showStepsCount: false, updateHandler: { (updateHandler) in

    self.updateHandler = updateHandler

}) { (success) in
    if success {
        // doRealWork() is a method that makes the actual work and updates the progress as well.
        self.doRealWork()
    }
}

// Step 3: In the doRealWork() method:
func doRealWork() {
    // Implement the method's logic.

    // When the time comes to update the progress:
    if let updateHandler = self.updateHandler {
        // currentStep and totalSteps represent the progress steps.
        updateHandler(currentStep, totalSteps)
    }
}

It presents an alert controller that contains an image view. It also displays action buttons, and the default title and message of the alert.

To access the image view and set or modify additional properties, use the imageView class property.

Implementation example:

// Specify your image:
// let image = ...

// Present the alert.
GTAlertCollection.shared.presentImageViewAlert(withTitle: "Your Avatar", message: "What do you want to do with it?", buttonTitles: ["Change it", "Remove it", "Cancel"], cancelButtonIndex: 2, destructiveButtonIndices: [1], image: image) { (actionIndex) in
    // Handle the actionIndex value...
}