SwiftUI判断旁白是否启用

@Environment(\.accessibilityVoiceOverEnabled) 是 SwiftUI 中用于检测辅助功能 (Accessibility) 状态的属性包装器，专门用于判断旁白（VoiceOver）是否被启用。

旁白的作用

旁白是苹果设备上的屏幕阅读功能，帮助视障用户使用设备。开启后，用户可以通过触摸和手势听到界面元素的描述。

判断旁白是否启用

@Environment(\.accessibilityVoiceOverEnabled) var accessibilityVoiceOverEnabled

accessibilityVoiceOverEnabled 的作用

这个环境变量是一个布尔值 (Bool)，其值表明用户设备上是否启用了 VoiceOver：

true：旁白已启用。

false：旁白未启用。

可以根据其值动态调整界面的行为或提供额外的辅助功能支持。

使用场景

当旁白开启时，可能需要调整 UI 元素或交互方式。例如：

1、为按钮添加更详细的描述。

2、提供替代的、对视觉障碍者更友好的布局。

3、修改手势或动画效果，使其更适合 VoiceOver 用户。

代码示例

以下是一个示例，动态调整按钮文本，确保更好地支持 VoiceOver 用户：

import SwiftUI

struct ContentView: View {
    @Environment(\.accessibilityVoiceOverEnabled) var accessibilityVoiceOverEnabled

    var body: some View {
        VStack {
            if accessibilityVoiceOverEnabled {
                Text("VoiceOver is enabled")
            } else {
                Text("VoiceOver is disabled")
            }

            Button(accessibilityVoiceOverEnabled ? "Tap to Continue" : "Proceed") {
                // Perform some action
            }
            .padding()
            .background(Color.blue)
            .foregroundColor(.white)
            .cornerRadius(8)
        }
        .padding()
    }
}

总结

@Environment(\.accessibilityVoiceOverEnabled) 是用于检测旁白状态的环境变量。

可根据其值调整 UI 或交互方式，以更好地支持辅助功能用户。

这是 SwiftUI 辅助功能支持的一部分，旨在帮助开发者为不同用户群体创建包容性的应用程序。

相关文章

1、Swift用于旁白识别的辅助信息修饰符：https://fangjunyu.com/2024/12/04/swift%e7%94%a8%e4%ba%8e%e6%97%81%e7%99%bd%e8%af%86%e5%88%ab%e7%9a%84%e8%be%85%e5%8a%a9%e4%bf%a1%e6%81%af%e4%bf%ae%e9%a5%b0%e7%ac%a6/

2、Swift用于旁白识别的控件读取修饰符：https://fangjunyu.com/2024/12/03/swift%e7%94%a8%e4%ba%8e%e6%97%81%e7%99%bd%e8%af%86%e5%88%ab%e7%9a%84%e6%8e%a7%e4%bb%b6%e8%af%bb%e5%8f%96%e4%bf%ae%e9%a5%b0%e7%ac%a6/

3、Swift用于旁白识别的隐藏和分组视图标签：https://fangjunyu.com/2024/12/03/swift%e7%94%a8%e4%ba%8e%e6%97%81%e7%99%bd%e8%af%86%e5%88%ab%e7%9a%84%e9%9a%90%e8%97%8f%e5%92%8c%e5%88%86%e7%bb%84%e8%a7%86%e5%9b%be%e6%a0%87%e7%ad%be/

4、Swift用于旁白识别的视图标签：https://fangjunyu.com/2024/12/03/swift%e7%94%a8%e4%ba%8e%e6%97%81%e7%99%bd%e8%af%86%e5%88%ab%e7%9a%84%e8%a7%86%e5%9b%be%e6%a0%87%e7%ad%be/