Creating Alerts with UIAlertController in Swift

Introduction

In iOS development, displaying alerts to users is a common requirement. Historically, developers used UIAlertView for this purpose, but since iOS 8, UIAlertView has been deprecated in favor of UIAlertController. As a subclass of UIViewController, UIAlertController offers a more flexible and consistent API for alerts and action sheets. This article will guide you step-by-step through using UIAlertController in Swift, including basic setup, action handling, user input, and code optimization.

Basic Usage of UIAlertController

Initializing a UIAlertController requires a title, message, and preferred style. The preferred style can be .alert for modal alerts or .actionSheet for action sheets. The following example demonstrates how to create and display a basic alert.

let alert = UIAlertController(title: "Alert Title", message: "This is the alert message", preferredStyle: .alert)
self.present(alert, animated: true, completion: nil)

However, this alert lacks buttons and cannot be dismissed by the user. To add interactivity, action buttons must be included.

Adding Action Buttons

Action buttons are implemented using UIAlertAction objects. Each action includes a title, style, and a handler closure. Styles include .default, .cancel, and .destructive, representing default, cancel, and destructive operations, respectively. The code below shows how to add an OK button.

let okAction = UIAlertAction(title: "OK", style: .default) { action in
    print("OK button tapped")
}
alert.addAction(okAction)

Once actions are added, the alert can respond to user taps. The handler closure allows for custom code execution, such as data updates or navigation.

Handling Multiple Buttons

UIAlertController supports adding multiple buttons, for example, in a confirmation dialog with OK and Cancel buttons. The order of adding actions affects their display order, with cancel buttons typically adjusted automatically to conform to iOS design guidelines.

let alert = UIAlertController(title: "Confirmation", message: "Are you sure you want to proceed?", preferredStyle: .alert)
alert.addAction(UIAlertAction(title: "OK", style: .default) { _ in
    // Handle OK action
})
alert.addAction(UIAlertAction(title: "Cancel", style: .cancel) { _ in
    // Handle cancel action
})
self.present(alert, animated: true, completion: nil)

This code creates a standard two-button alert, executing the respective closure when a button is tapped. For more buttons, additional actions can be added, but it is recommended to limit to three to avoid cluttering the interface.

Adding Text Fields for User Input

UIAlertController allows the addition of text fields to collect user input using the addTextField method. To prevent memory leaks, it is advisable to use a local variable to capture the text field reference. The following example demonstrates how to add a text field and handle the input.

var inputTextField: UITextField?
let alert = UIAlertController(title: "Input", message: "Please enter your name", preferredStyle: .alert)
alert.addTextField { textField in
    inputTextField = textField
    textField.placeholder = "Name"
}
alert.addAction(UIAlertAction(title: "Submit", style: .default) { _ in
    if let text = inputTextField?.text {
        print("User entered: \(text)")
    }
})
self.present(alert, animated: true, completion: nil)

This approach ensures safe access to the text field content within the action closure while maintaining code simplicity and maintainability.

Swift Version Adaptation

The API for UIAlertController has minor variations across different Swift versions. For instance, in Swift 3 and later, style enums use lowercase, such as .alert and .default. The code below shows a compatible implementation for Swift 4.x.

let alert = UIAlertController(title: "Alert", message: "Message content", preferredStyle: .alert)
alert.addAction(UIAlertAction(title: "OK", style: .default) { action in
    switch action.style {
    case .default:
        print("Default action")
    case .cancel:
        print("Cancel action")
    case .destructive:
        print("Destructive action")
    default:
        break
    }
})
self.present(alert, animated: true, completion: nil)

Developers should adjust the code based on the Swift version used in their project to ensure compatibility and performance.

Conclusion

UIAlertController is the modern solution for handling alerts in iOS, offering a clear API, flexible style options, and closure-based action handling. Through the examples and explanations in this article, developers can quickly master its usage and avoid the deprecated UIAlertView. In practice, it is recommended to prioritize UIAlertController to enhance application maintainability and user experience.