autofocus. This feature finds or recovers the focus and remembers the focus on multiple visits. TVFocusGuide also supports trapping and focus redirection, allowing you to customize the focus behavior in your app.
This component makes sure that focusable controls can be navigated to, even if they are not directly in line with other controls. An example in RNTester shows two different ways of using this component.
TVFocusGuideView.
For more information on the focus handling improvements, see Revolutionizing Focus Management in TV Applications with React Native.
Example
Reference
Props
autoFocus
If true,TVFocusGuide manages the focus for you. TVFocusGuide redirects the focus to the first focusable child on the first visit. This prop also remembers the last focused child and redirects the focus to it on the subsequent visits. The destinations prop takes precedence over this prop when used.
trapFocus* (Up, Down, Left, Right)
Prevents focus escaping from the container for the given directions.destinations
Array of Components to register as destinations of the FocusGuideView.Methods
setDestinations
Known issues
- If
setDestinationsisn’t mounted, the callback fails to update. Either use thedestinationsprop instead or add a delay usingsetTimeoutbefore callingsetDestinations. TVFocusGuidefails withProperty children does not exist on typewhen imported in .tsx with strict typechecking. Apps can add{/* @ts-expect-error */}or{/* @ts-ignore */}before using a component to avoid the error.

