SwiftUI中如何让Voiceover正确朗读街道地址？

针对你遇到的VoiceOver对地址朗读不符合预期的问题，核心解决方案是利用带语音属性的AttributedString来精准控制每个地址片段的朗读方式，替代普通的accessibilityLabel字符串。

具体实现步骤 #

1. 拆分地址为独立片段，分别设置朗读规则

   • 门牌号：逐个朗读数字（启用spell out属性）
   • 街道缩写：替换为全称（如"St."→"Street"）
   • 州缩写：替换为全称（如"CA"→"California"）
   • 邮编：逐个朗读数字（启用spell out属性）
   • 城市/国家：保持正常朗读

2. 代码示例

import SwiftUI

struct AddressView: View {
    // 原始地址
    let originalAddress = "123 Main St. Los Angeles, CA 90210 United States"
    
    // 生成带语音属性的无障碍标签
    private func formattedAccessibilityLabel() -> AttributedString {
        var attributedLabel = AttributedString()
        
        // 1. 处理门牌号：逐个朗读数字
        let streetNumber = AttributedString("123 ")
        streetNumber.accessibilitySpeechSpellOutCharacters = true
        attributedLabel += streetNumber
        
        // 2. 处理街道：替换缩写为全称
        let processedStreet = AttributedString("Main Street, ")
        attributedLabel += processedStreet
        
        // 3. 处理城市
        let city = AttributedString("Los Angeles, ")
        attributedLabel += city
        
        // 4. 处理州：替换缩写为全称
        let processedState = AttributedString("California ")
        attributedLabel += processedState
        
        // 5. 处理邮编：逐个朗读数字
        let zipCode = AttributedString("90210 ")
        zipCode.accessibilitySpeechSpellOutCharacters = true
        attributedLabel += zipCode
        
        // 6. 处理国家
        let country = AttributedString("United States")
        attributedLabel += country
        
        return attributedLabel
    }
    
    var body: some View {
        Text(originalAddress)
            .accessibilityLabel(formattedAccessibilityLabel())
    }
}

适配动态地址的优化 #

如果地址是动态生成的，可以通过字典映射自动替换常见缩写，避免硬编码：

// 常见街道缩写映射
private let streetAbbrevMap = [
    "St.": "Street",
    "Ave.": "Avenue",
    "Rd.": "Road",
    "Blvd.": "Boulevard"
]

// 常见州缩写映射
private let stateAbbrevMap = [
    "CA": "California",
    "NY": "New York",
    "TX": "Texas",
    "FL": "Florida"
]

// 动态处理地址片段的函数
private func processStreet(_ street: String) -> String {
    streetAbbrevMap[street] ?? street
}

private func processState(_ state: String) -> String {
    stateAbbrevMap[state] ?? state
}

原理说明 #

普通的accessibilityLabel字符串会由VoiceOver自动解析数字、缩写，导致朗读不符合预期。而AttributedString的accessibilitySpeechSpellOutCharacters属性可以强制让VoiceOver逐个朗读字符，结合缩写替换为全称，就能完全匹配你想要的朗读效果。

内容的提问来源于stack exchange，提问作者kittonian