Protocol

UIFocusItem

An object that can become focused.

Declaration

protocol UIFocusItem

Overview

An object that conforms to the UIFocusItem protocol is capable of participating in the focus system; further, only UIFocusItem objects can be focused.

Even when an object that conforms to UIFocusItem is not currently focusable, it may still have an effect on the focus system. For example, items that are not focusable, but that completely obscure other items, may prevent those other items from being focusable, because they are not visible to the user. Also, because UIFocusItem conforms to UIFocusEnvironment, items that are not focusable may still affect the focus behavior of items they contain, or react to focus updates.

Topics

Determining Focusability

var canBecomeFocused: Bool

A Boolean value that indicates whether the item can become focused.

Required.

var isFocused: Bool

A Boolean value indicating whether the item is currently focused.

Retrieving the Item Frame

var frame: CGRect

The geometric frame of the item.

Required.

Providing Movement Hints

func didHintFocusMovement(UIFocusMovementHint)

Indicates to the currently focused item that focus movement might occur.

Relationships

Inherits From

Conforming Types

See Also

Focus Interactions

About Focus Interactions for Apple TV

Design and implement intuitive control schemes for menus and interactive user interface layouts.

Adding User-Focusable Elements to a tvOS App

Create intuitive and easily manipulated user-interactive controls for your tvOS app.

protocol UIFocusEnvironment

A set of methods that define the focus behavior for a branch of the view hierarchy.

class UIFocusSystem

Queries and reevaluates the currently focused item.

class UIFocusUpdateContext

An object that provides information relevant to a specific focus update from one view to another.

class UIFocusMovementHint

Provides movement hint information for the focused item.

protocol UIFocusItemContainer

The container responsible for providing geometric context to focus items within a given focus environment.

protocol UIFocusItemScrollableContainer

A type of focus item container that supports automatic scrolling of focusable content.