用途:为 SwiftUI 与 UIKit 应用实现键盘、方向与场景级焦点行为,适用于 iOS 26+、iPadOS、macOS、tvOS 及 visionOS 的连接输入路径。
主要能力:使用 @FocusState 读写场景内焦点位置(Bool 或 Hashable 枚举);用 .defaultFocus 设置初始焦点;用 focusedValue / focusedSceneValue 向菜单、命令和工具栏暴露当前焦点内容;用 .focusable(interactions:) 让自定义视图参与焦点;在 macOS 13+ 与 tvOS 15+ 用 focusSection() 引导方向移动;在弹窗关闭后恢复焦点;在 UIKit 中用 UIFocusGuide 自定义路由。
使用方式:焦点状态应保留在拥有可聚焦控件的视图内;优先使用 Button、Toggle、TextField 等语义控件,仅在语义控件无法表达时才对自定义控件使用 .focusable(interactions: .activate);每屏只设一个明确的默认焦点目标;临时呈现消失后主动恢复焦点。
适用场景:登录表单字段切换、侧边栏初始焦点、tvOS 与 macOS 的不规则方向布局、命令与工具栏读取当前场景内容、UIKit 或 tvOS 中跨空白区域的自定义焦点路由。
限制:focusSection() 仅适用于 macOS 与 tvOS;visionOS 的注视悬停属于输入可供性而非焦点;VoiceOver、Switch Control 等无障碍焦点由 ios-accessibility 技能处理,本技能仅做简要交接。常见错误包括混用无障碍焦点与键盘焦点、把 @FocusState 放入共享模型、设置多个竞争默认焦点、对装饰性视图使用 .focusable()、忘记焦点恢复,以及在 macOS/tvOS 上跳过 focusSection() 直接使用 UIFocusGuide。