Properly Presenting UIAlertController on iPad: A Deep Dive into UIPopoverPresentationController in iOS 8

Introduction

With the release of iOS 8.0, Apple introduced UIAlertController to replace traditional UIActionSheet and UIAlertView. This new API aims to unify the presentation of alerts and action sheets, but on iPad devices, developers often encounter interface misalignment issues, as shown in the images. This technical article will delve into the root cause of this problem and provide a solution based on UIPopoverPresentationController.

Challenges of Presenting UIAlertController on iPad

On iPad, the UIAlertControllerStyleActionSheet style of UIAlertController is presented by default as UIModalPresentationPopover, which requires developers to provide location information; otherwise, it may cause exceptions or interface misalignment. For example, using the simple presentModalViewController method (deprecated in iOS, should use presentViewController:animated:completion:) without setting an anchor point triggers an NSGenericException, with an error message indicating that sourceView and sourceRect or barButtonItem must be provided via popoverPresentationController.

Core Solution: Using UIPopoverPresentationController

To properly present UIAlertController, the key is to configure its UIPopoverPresentationController property. This can be achieved through the following steps:

1. Create a UIAlertController instance and set its preferredStyle to UIAlertControllerStyleActionSheet.
2. Add UIAlertAction buttons, defining the handling logic.
3. Obtain the alertController's popoverPresentationController and set the anchor point. The anchor point can be one of the following:
   • sourceView and sourceRect: Specify a view and its bounding rectangle as the popover location.
   • barButtonItem: Specify a UIBarButtonItem as the anchor point.
4. Call the presentViewController:animated:completion: method to present the controller.

Example code (based on Objective-C, referencing Answer 1):

UIAlertController *alertController = [UIAlertController alertControllerWithTitle:nil
                                                                          message:nil
                                                                   preferredStyle:UIAlertControllerStyleActionSheet];
UIAlertAction *destroyAction = [UIAlertAction actionWithTitle:@"Remove All Data"
                                                         style:UIAlertActionStyleDestructive
                                                       handler:^(UIAlertAction *action) {
                                                           // Handle destructive action
                                                       }];
UIAlertAction *otherAction = [UIAlertAction actionWithTitle:@"Blah"
                                                       style:UIAlertActionStyleDefault
                                                     handler:^(UIAlertAction *action) {
                                                         // Handle other action
                                                     }];
[alertController addAction:destroyAction];
[alertController addAction:otherAction];

UIPopoverPresentationController *popPresenter = [alertController popoverPresentationController];
popPresenter.sourceView = button; // button is the UIButton instance that triggers the action
popPresenter.sourceRect = button.bounds;
[self presentViewController:alertController animated:YES completion:nil];

In Swift (referencing Answer 3), the code is similar:

let alert = UIAlertController(title: "Delete Contact?", message: "This action will delete all downloaded audio files.", preferredStyle: .ActionSheet)
alert.modalPresentationStyle = .Popover

let action = UIAlertAction(title: "Delete", style: .Destructive) { _ in
    // Handle delete action
}
let cancel = UIAlertAction(title: "Cancel", style: .Cancel, handler: nil)
alert.addAction(cancel)
alert.addAction(action)

if let presenter = alert.popoverPresentationController {
    presenter.sourceView = button
    presenter.sourceRect = button.bounds
}
presentViewController(alert, animated: true, completion: nil)

In-Depth Analysis and Best Practices

UIPopoverPresentationController is a class introduced in iOS 8 to manage the presentation of popover controllers. On iPad, it ensures that UIAlertController is correctly aligned as a popover, avoiding overlap with critical interface elements. Developers should note:

• Always check device type: While this article focuses on iPad, on iPhone, UIAlertControllerStyleActionSheet is typically presented as a bottom sheet without additional configuration. Use conditional code to adapt to different devices.
• Error handling: If no anchor point is set, the system throws an exception, as described in Answer 3. Therefore, validating the properties of popoverPresentationController before presentation is a good programming practice.
• Performance considerations: Configuration of UIPopoverPresentationController should be lightweight, avoiding layout calculation overhead when setting sourceRect in complex view hierarchies.

Supplementing from Answer 2, barButtonItem can also be used as an anchor point, which is particularly useful in navigation bar or toolbar scenarios:

alertController.popoverPresentationController.barButtonItem = buttonItem;

Conclusion

By correctly using UIPopoverPresentationController, developers can ensure that UIAlertController is presented as expected on iPad, enhancing the application's user experience and stability. This article, based on community-verified solutions, provides guidance from basics to advanced techniques, helping to address common interface challenges in iOS development. In the future, as iOS versions update, it is recommended to refer to Apple's official documentation for the latest API changes.