iOS Developer Library

Developer

UIKit Framework Reference UIAccessibilityFocus Protocol Reference

Options
Deployment Target:

On This Page
Language:

UIAccessibilityFocus

Inheritance


Not Applicable

Conforms To


Not Applicable

Import Statement


Swift

import UIKit

Objective-C

@import UIKit;

Availability


Available in iOS 4.0 and later.

The UIAccessibilityFocus informal protocol provides a way to find out whether an assistive technology, such as VoiceOver, is focused on an accessible element.

VoiceOver and other assistive technologies place a virtual focus on elements, which allows users to inspect an element without activating it. If you know the current location of the virtual focus, you can optimize the user experience for assistive technology users. For example, if your application expects people to tap once to select an object and then double-tap to activate it, VoiceOver users must make an extra tap to focus VoiceOver on the object before tapping to select it. To improve the VoiceOver user’s experience, you can move selection to an element at the same time VoiceOver focuses on the element. In this way, the user can activate the element without having to tap again to select the element.

  • Sent after an assistive technology has set its virtual focus on the accessibility element.

    Declaration

    Swift

    func accessibilityElementDidBecomeFocused()

    Objective-C

    - (void)accessibilityElementDidBecomeFocused

    Discussion

    Override accessibilityElementDidBecomeFocused if you need to know when an assistive technology has set its virtual focus on an accessibility element.

    Import Statement

    Objective-C

    @import UIKit;

    Swift

    import UIKit

    Availability

    Available in iOS 4.0 and later.

  • Sent after an assistive technology has removed its virtual focus from an accessibility element.

    Declaration

    Swift

    func accessibilityElementDidLoseFocus()

    Objective-C

    - (void)accessibilityElementDidLoseFocus

    Discussion

    Override accessibilityElementDidLoseFocus if you need to know when an assistive technology has removed its virtual focus from an accessibility element. Note that accessibilityElementDidLoseFocus is sent before accessibilityElementDidBecomeFocused.

    Import Statement

    Objective-C

    @import UIKit;

    Swift

    import UIKit

    Availability

    Available in iOS 4.0 and later.

  • Returns a Boolean value indicating whether an assistive technology is focused on the accessibility element.

    Declaration

    Swift

    func accessibilityElementIsFocused() -> Bool

    Objective-C

    - (BOOL)accessibilityElementIsFocused

    Return Value

    YEStrue if an assistive technology is virtually focused on the element; otherwise, NOfalse.

    Import Statement

    Objective-C

    @import UIKit;

    Swift

    import UIKit

    Availability

    Available in iOS 4.0 and later.