如何让UISlider的VoiceOver播报与iOS设置中的效果一致？

问题描述 #

iOS系统自带的滑块（如设置中的“SPEAKING RATE”滑块）被VoiceOver识别时，会播报：“Speaking rate 65% adjustable. Slide up or down to adjust the value”，包含清晰的操作提示。但自己实现的UISlider播报内容为 “Volume Control, 50%, Adjustable”，缺少操作引导语句，希望调整为系统同款效果。

当前代码如下：

import UIKit

class ViewController: UIViewController {
    let slider = UISlider()

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        
        // Set up the slider
        slider.frame = CGRect(x: 50, y: 100, width: 200, height: 20)
        slider.minimumValue = 0
        slider.maximumValue = 100
        slider.accessibilityIncrement()
        slider.value = 50
        
        // Set accessibility properties for the slider
        slider.isAccessibilityElement = true
        slider.accessibilityLabel = "Volume Control"
        slider.accessibilityValue = "\(Int(slider.value))%"
        slider.accessibilityTraits = .adjustable
        
        // Add the slider to the view
        view.addSubview(slider)
    }
}

问题原因及修复方案 #

1. 移除isAccessibilityElement = true
   系统原生UISlider本身就是默认的可访问元素，手动设置该属性会覆盖系统内置的VoiceOver播报逻辑，导致丢失操作提示语句。直接删除这一行即可恢复系统默认的播报规则。

2. 删除无效的slider.accessibilityIncrement()调用
   accessibilityIncrement()是用于触发滑块递增操作的方法，而非配置属性，此处单纯调用没有实际意义，属于冗余代码，直接移除。

3. 补充滑块值变化时的可访问性更新（可选但推荐）
   原代码只在初始化时设置了accessibilityValue，滑块拖动时数值不会实时更新，建议添加值变化监听，同步更新可访问性数值。

修改后的完整代码 #

import UIKit

class ViewController: UIViewController {
    let slider = UISlider()

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Set up the slider
        slider.frame = CGRect(x: 50, y: 100, width: 200, height: 20)
        slider.minimumValue = 0
        slider.maximumValue = 100
        slider.value = 50
        
        // 添加值变化监听
        slider.addTarget(self, action: #selector(sliderValueChanged(_:)), for: .valueChanged)
        
        // Set accessibility properties for the slider
        slider.accessibilityLabel = "Volume Control"
        slider.accessibilityValue = "\(Int(slider.value))%"
        slider.accessibilityTraits = .adjustable
        
        // Add the slider to the view
        view.addSubview(slider)
    }
    
    /// 滑块值变化时更新可访问性数值
    @objc private func sliderValueChanged(_ sender: UISlider) {
        sender.accessibilityValue = "\(Int(sender.value))%"
    }
}

修改后，VoiceOver会像系统滑块一样播报：“Volume Control 50% adjustable. Slide up or down to adjust the value”，同时拖动滑块时会实时播报最新数值。

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