Instance Property


A succinct label that identifies the accessibility element, in a localized string.


@property(nonatomic, copy) NSString *accessibilityLabel;


The default value for this property is nil unless the receiver is a UIKit control, in which case the value is a label derived from the control’s title.

If you implement a custom control or view or if you display a custom icon on a UIKit control, set this property to make sure your accessibility elements have appropriate labels. If an accessibility element does not display a descriptive label, set this property to supply a short, localized label that succinctly identifies the element. For example, a “Play music” button might display an icon that shows sighted users what it does. To be accessible, however, the button should have the accessibility label “Play” or “Play music” so that an assistive application can provide this information to users with disabilities. Note, however, that the label should never include the control type (such as “button”) because this information is contained in the traits associated with the accessibility element.

See Also

Configuring an Accessibility Element


The activation point for the accessibility element, in screen coordinates.


A Boolean value indicating whether the accessibility elements contained within this accessibility element are hidden.


The frame of the accessibility element, in screen coordinates.


A brief description of the result of performing an action on the accessibility element, in a localized string.


The language in which to speak the accessibility element's label, value, and hint.


The path of the element, in screen coordinates.


The combination of accessibility traits that best characterize the accessibility element.


The value of the accessibility element, in a localized string.


A Boolean value indicating whether VoiceOver should ignore the elements within views that are siblings of the receiver.


A Boolean value indicating whether VoiceOver should group together the elements that are children of the receiver, regardless of their positions on the screen.


The navigation style to apply to the object and its elements.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software