In apps that run in versions of iOS prior to iOS 8, use the UIAlertView class to display an alert message to the user. An alert view functions similar to but differs in appearance from an action sheet (an instance of UIActionSheet).


UIAlertView is deprecated in iOS 8. (Note that UIAlertViewDelegate is also deprecated.) To create and manage alerts in iOS 8 and later, instead use UIAlertController with a preferredStyle of alert.

Using an Alert View

Use the properties and methods defined in this class to set the title, message, and delegate of an alert view and configure the buttons in apps that run in versions of iOS prior to iOS 8. You must set a delegate if you add custom buttons. The delegate should conform to the UIAlertViewDelegate protocol. Use the show() method to display an alert view after it is configured.

Subclassing Notes

The UIAlertView class is intended to be used as-is and does not support subclassing. The view hierarchy for this class is private and must not be modified.


Creating Alert Views

Setting Properties

var delegate: AnyObject?

The receiver’s delegate or nil if it doesn’t have a delegate.

var alertViewStyle: UIAlertViewStyle

The kind of alert displayed to the user.

var title: String

The string that appears in the receiver’s title bar.

var message: String?

Descriptive text that provides more details than the title.

var isVisible: Bool

A Boolean value that indicates whether the receiver is displayed.

Configuring Buttons

func addButton(withTitle: String?)

Adds a button to the receiver with the given title.

var numberOfButtons: Int

The number of buttons on the alert view.

func buttonTitle(at: Int)

Returns the title of the button at the given index.

func textField(at: Int)

Returns the text field at the given index

var cancelButtonIndex: Int

The index number of the cancel button.

var firstOtherButtonIndex: Int

The index of the first other button.


func show()

Displays the receiver using animation.


func dismiss(withClickedButtonIndex: Int, animated: Bool)

Dismisses the receiver, optionally with animation.