用途:在 SwiftUI 与 UIKit 应用中实现或调试键盘焦点、方向焦点与场景级焦点,适用于 iOS 26+、iPadOS、macOS、tvOS 和 visionOS 的连接输入路径。涵盖键盘焦点、方向焦点、场景聚焦值、焦点恢复以及 UIKit 焦点指南。其中 focusSection() 指南适用于 macOS 和 tvOS;visionOS 的注视驱动悬停属于输入可供性,而非焦点。VoiceOver、Switch Control 等无障碍焦点位于 ios-accessibility 技能中。
主要能力:使用 @FocusState 在场景内读写焦点位置,单目标用 Bool,多目标用可哈希枚举;用 .defaultFocus 设置首选项初始焦点;用聚焦值暴露当前聚焦视图的状态,用聚焦场景值让命令或场景级 UI 在焦点移动后仍可访问该值;用 .focusable(_:interactions:) 让自定义 SwiftUI 视图参与键盘或方向焦点;在 macOS 13+ 与 tvOS 15+ 用 focusSection() 引导分组间的方向移动;在 sheet、popover 或临时浮层消失后恢复焦点;在 UIKit 或 tvOS 布局中需要跨空白区或异常几何路由时使用 UIFocusGuide。
使用方式:保持焦点状态属于拥有可聚焦控件的视图,避免放进共享模型;屏幕或焦点区域尽量只设一个明确的默认目标;优先使用 Button、Toggle、TextField 等语义控件,仅在语义控件无法表达时才对自定义视图使用 .focusable(interactions: .activate);macOS 或 tvOS 上先尝试 focusSection() 与更好的布局分组,再考虑 UIFocusGuide;临时呈现消失后要主动恢复焦点。
适用场景:登录表单字段间跳转、侧边栏默认焦点、面向命令与工具栏的聚焦值、电视端不平整布局的方向导航、UIKit 仪表盘的焦点路由。
限制:资料未提供收费、价格、平台可用版本之外的细节或效果量化;focusSection() 不适用于所有平台;visionOS 应把注视、直接触摸与指针定位描述为悬停/输入可供性,而非焦点;无障碍焦点相关问题应交给 ios-accessibility,不与键盘方向焦点混用;避免在装饰性视图上使用 .focusable()、在同一屏幕设置多个竞争默认焦点、用共享模型存 @FocusState、用自定义可聚焦控件的手势处理器承担主操作。