如何在macOS上实现支持VoiceOver的NSSlider无障碍访问？

咱把你遇到的问题和解决方案拆解清楚，确保VoiceOver用户能顺畅感知滑块和标签的关联，还能正确读取数值（不再读成百分比）：

一、基础无障碍标识配置 #

首先得给滑块和标签设置清晰的无障碍标签，让VoiceOver知道它们的用途：

• 给NSSlider设置accessibilityLabel，明确它的功能：

  slider.accessibilityLabel = "音量调节" // 替换成你的滑块实际用途，比如"亮度调节"
  

• 给NSTextField（也就是你的valueLabel）也设置对应的标签：

  valueLabel.accessibilityLabel = "当前数值"
  

二、解决滑块数值被读成百分比的核心操作 #

你尝试用setAccessibilityValueDescription的方向完全正确！系统默认会把滑块的相对值转成百分比读取，咱们直接用这个方法覆盖默认行为，让VoiceOver读取和标签显示一致的数值：
在你的sliderChanged函数里，更新标签后立刻给滑块设置自定义的数值描述：

func sliderChanged(_ sender: NSSlider) {
    let currentValue = sender.integerValue
    // 更新视觉标签的显示
    valueLabel.stringValue = String(currentValue)
    // 关键：设置滑块的无障碍数值描述，替换默认的百分比读取
    sender.setAccessibilityValueDescription(String(currentValue))
}

三、强化滑块和标签的关联（可选但推荐） #

为了让VoiceOver用户更清晰地知道这两个控件是配套的，还可以把标签设为滑块的无障碍附属元素，这样聚焦滑块时，VoiceOver会同时读取标签的信息：

// 在初始化滑块和标签时设置
slider.accessibilityElements = [valueLabel]

或者也可以在滑块的accessibilityLabel里直接关联标签，比如：

slider.accessibilityLabel = "音量调节，当前值显示在右侧标签"

四、额外优化：补充范围提示（如果需要） #

如果你的滑块有明确的数值范围（比如0-100），可以设置最小值和最大值的无障碍描述，让用户滑动时更清楚边界：

slider.setAccessibilityMinValueDescription("0")
slider.setAccessibilityMaxValueDescription("100")

这样配置后，VoiceOver用户操作滑块时，会先读取滑块的功能标签，然后读取你自定义的数值（和视觉标签完全一致），再也不会出现读百分比的问题啦～

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