as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
通过支持autofocus,TVFocusGuideView可帮助您编写直观的电视应用。此功能可找到或恢复焦点,并记住多次访问时的焦点。TVFocusGuide还支持trapping和focus redirection,让您可以在应用中自定义焦点行为。 该组件确保即使可设定焦点控件与其他控件未直接对齐,也可以导航到这些控件。RNTester中的一个示例显示了使用该组件的两种不同方式。 以下动画显示了使用TVFocusGuideView时的导航控件。 GIF动画,显示不同的布局元素以及焦点如何转移到不同的元素。右下角的文字显示: 上方的蓝色焦点指南容器,如果从外部导航,则始终指向按钮3。 有关焦点处理改进的更多信息,请参阅使用React Native革新电视应用程序中的焦点管理。

示例


参考

属性

autoFocus

如果为true,TVFocusGuide会为您管理焦点。TVFocusGuide会在首次访问时将焦点重定向到第一个可聚焦子元素。此属性还会记住最后一个聚焦的子项,并在随后的访问中将焦点重定向到该子项。使用时,destinations属性优先于此属性。

trapFocus* (Up、Down、Left、Right)

防止焦点在给定方向上从容器中逸出。

destinations

要注册为FocusGuideView目的地的Component数组。

enabled

控制TVFocusGuideView是否可见。当为true(默认值)时,视图会显示。当为false时,视图处于隐藏状态。

方法

setDestinations

要注册为FocusGuideView目的地的Component数组。

已知问题

  • 如果setDestinations未挂载,回调将无法更新。可以改用destinations属性,或在调用setDestinations之前用setTimeout添加延迟。
  • TVFocusGuide在.tsx中启用严格类型检查时导入会因Property children does not exist on type而失败。应用可在使用组件前添加{/* @ts-expect-error */}或{/* @ts-ignore */},以避免此错误。

其他资源

有关其他库的信息,请参阅支持的第三方库和服务。
最后修改于 2026年9月11日