文章目录
- 前言
- 使用 @FocusState 属性包装器
- 高级技巧:专用辅助技术
- 可聚焦字段的高级用法
- 优化体验
- 运行截图
- 总结
前言
SwiftUI Release 引入了强大的新功能,其中之一是辅助焦点管理。
这个新功能使得在SwiftUI中处理辅助技术(如 VoiceOver 和 Switch Control)的焦点状态变得更加轻松。本文将介绍如何使用 @FocusState
属性包装器来在SwiftUI中管理和移动辅助焦点。
使用 @FocusState 属性包装器
在 SwiftUI Release 中,我们获得了一整套特殊工具来更有效地处理辅助焦点。其中包括 @FocusState
属性包装器和 focused
视图修饰符。通过使用这些工具,我们能够以与无辅助技术相同的方式处理辅助焦点。
核心代码如下:
import SwiftUIstruct SignInView: View {@FocusStateprivate var isEmailFocused: Bool@State private var email = ""var body: some View {NavigationView {Form {TextField("Email", text: $email, prompt: Text("Enter your email")).focused($isEmailFocused)}.navigationTitle("Sign In").onChange(of: isEmailFocused) { newValue inprint(newValue)}}}
}
如上例所示,我们使用 @FocusState
属性包装器定义一个变量,表示 email 字段是否聚焦。SwiftUI 默认使用 false
值初始化该变量,因为用户可以聚焦屏幕的任何其他区域。我们还使用 focused
视图修饰符将特定视图的焦点状态绑定到保存其值的变量。
请记住,您可以声明尽需要的变量,以使用 @FocusState
属性包装器涵盖辅助焦点逻辑。
高级技巧:专用辅助技术
核心代码如下:
import SwiftUIstruct SignInView: View {@FocusStateprivate var isEmailFocused: Bool@FocusStateprivate var isPasswordFocused: Bool@State private var email = ""@State private var password = ""var body: some View {NavigationView {Form {TextField("Email", text: $email, prompt: Text("Enter your email")).focused($isEmailFocused)SecureField("Password", text: $password, prompt: Text("Enter your password")).focused($isPasswordFocused)}.navigationTitle("Sign In")}}
}
@FocusState
属性包装器的好处之一是您可以将其行为限制为专用辅助技术。例如,您可以仅为VoiceOver或Switch Control激活 @FocusState
属性包装器。默认情况下,SwiftUI 会将设备上可用的所有辅助技术的值进行聚合。
可聚焦字段的高级用法
核心代码如下:
import SwiftUIstruct SignInView: View {@FocusState(for: .switchControl)private var isEmailFocused: Bool@State private var email = ""var body: some View {NavigationView {Form {TextField("Email", text: $email, prompt: Text("Enter your email")).focused($isEmailFocused)}.navigationTitle("Sign In").onChange(of: isEmailFocused) { newValue inprint(newValue)}}}
}
如上例所示,我们使用 @FocusState
属性包装器为 Switch Control 定义了可选变量 isEmailFocused
,以便在用户在视图之间移动焦点时进行切换。
通常,屏幕上有多个元素,您可能希望在它们之间移动焦点。为了支持这种情况,SwiftUI 提供了一种通过枚举定义可聚焦字段并在它们之间切换的方法。这种方法是使用 @FocusState
属性包装器,并为其提供一个用于标识焦点类型的参数(在此例中是 .switchControl
)。
优化体验
全部代码如下:
import SwiftUIenum FocusableField: Hashable {case emailcase password
}struct ContentView: View {@State private var email = ""@State private var password = ""@FocusStateprivate var focus: FocusableField?var body: some View {NavigationView {Form {TextField("email", text: $email, prompt: Text("email")).focused($focus, equals: .email)SecureField("password", text: $password, prompt: Text("password")).focused($focus, equals: .password)Button("login", action: login)}.toolbar {ToolbarItem(placement: .keyboard) {Button("next") {if email.isEmpty {focus = .email} else if password.isEmpty {focus = .password} else {focus = nil}}}}.navigationTitle("Sign in").onAppear {DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {focus = .email}}}}private func login() {// your logic here}
}
运行截图
如上例所示,我们使用了 @FocusState
属性包装器与我们的新 FocusableField
枚举一起使用。该枚举定义了屏幕上所有可聚焦视图,应确保 FocusableField
枚举是可散列的。
使用 @FocusState
属性包装器定义了可选变量 focus
,以便在用户将焦点从您定义的视图移动时将其值设置为 nil
。
我们还使用了 focused
修饰符的一个版本,将一个视图绑定到可散列枚举的特定情况。请记住,您可以通过更改 @FocusState
包装的变量的值来以编程方式移动 VoiceOver 或 Switch Control 的焦点。
总结
在这篇文章中,我们深入探讨了 SwiftUI Release 引入的辅助焦点管理功能,使得处理辅助技术(如 VoiceOver 和 Switch Control)的焦点状态变得更加轻松。通过 @FocusState
属性包装器,我们学习了如何灵活地管理焦点状态,以提高用户体验。通过详细的示例代码,我们演示了如何在 SwiftUI 中使用 @FocusState
,以及如何通过 focused
视图修饰符将焦点状态绑定到特定的视图。此外,我们介绍了一种高级用法,通过枚举定义可聚焦字段并在它们之间切换,以更好地支持屏幕上多个元素的焦点移动。最后,我们提供了一些优化 SwiftUI 应用的建议,以更好地整合焦点管理,并通过最佳实践和总结使读者更深入地了解了在 SwiftUI Release 中使用 @FocusState
管理焦点的方法。