Android 切换 textOn/Off 防止从 Talkback 读取

Question

我有一个 SwitchCompat 作为带有文本的开关（HQ/LQ 用于不同质量的流）。对于视力好的用户，我认为这意味着什么是显而易见的。但是我很难找到一个好的解决方案如何让它易于访问。

我已经为SwitchCompat一般

设置了ContentDescription

<android.support.v7.widget.SwitchCompat
            android:id="@+id/qualitySwitch"
            style="@style/SwitchStyleCompat"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textOff="LQ"
            android:textOn="HQ"
            android:contentDescription="stream quality"

并且想在每次切换 SwitchCompat 时设置一个 contentDescription。

if (isChecked) {
 streamPlayerService.desireHighQuality();
 mQualitySwitch.setContentDescription("quality high");

} else {
 streamPlayerService.desireLowQuality();
 mQualitySwitch.setContentDescription("quality low");
}

但即使使用 contentDescription，textOn/textOff 标志仍会被 Talkback 读取，从而导致类似 "Quality high HQ switch" 的结果。有什么方法可以禁止读取 textOn/textOff 属性，以便只向用户读取 contentDescription？

Answer 1

您可以获得您想要的确切行为。但唯一的方法是自定义控件，或者一些涉及开关背后不可见视图的黑客行为。如果 TalkBack 遇到一个开关，它会按照你说的方式读出来。共享状态和价值信息。在您开始组装自定义控件之前，让我向您展示我认为更易于访问的解决方案。并鼓励您查看我的开源应用程序，它涉及许多可访问性概念，实际上包含我在这里与您分享的方法示例。

https://github.com/dequelabs/Deque-University-for-Android

请记住，对于可访问性，必须以等效方式共享任何文本或状态。您无法将用户听到的内容与他们看到的内容分开。我们不仅关心盲人，还关心那些可能只是视力有困难的人。如果公告与他们的预期完全不同，可能会非常混乱。另外，如果公告令人困惑，也许你应该重新考虑它是否同样让视力正常的用户感到困惑......

因此，如果您有一个 on/off 开关，则在公告期间的某个时间点打开或关闭它是合适的。这是用户将习惯的，并且对于使用您的控件的阅读障碍用户来说，如果您要覆盖此行为，他们会非常困惑。如果您的控件文本让有视力的用户感到困惑，并且您重复了这个确切的文本，那么对于没有视力的用户来说同样会造成混淆。这实际上比为 TalkBack 用户创建单独的用户体验更 "accessible"。因为这只是意味着您遇到了用户体验问题，需要更改标签的措辞。

实现此目的的最佳方法是使用 LabelFor 属性。

<TextView
    android:labelFor="@+id/your_id"
    android:text="My Text" />

<ToggleButton android:id="@+id/your_id"/>

这将导致它像这样读取：

HQ, switch, for Quality High

如果您专注于开关，这正是您需要的信息。开关上的文字是 "HQ" 它是一个开关，它与视觉标签 "quality high" 相关联。状态、角色、名称……接二连三。这是一件美丽的事情！

如果您认为这仍然令人困惑，您还可以向 TextView 添加内容描述，以便 TalkBack 用户获得一些额外的上下文，尽管它应该与实际文本非常相似。（例如：包含实际文本，附加信息，或者可能做一些首字母缩略词扩展）。

<TextView
    android:labelFor="@+id/my_id"
    android:text="Quality High"
    android:contentDescription="... Quality High ..." />

<ToggleButton android:id="@+id/my_id"/>

这将导致内容描述被读出，所以它改为这样读：

HQ, switch for ... Quality High ...

或者像这样：

<TextView
    android:labelFor="@+id/my_id"
    android:text="A misleading acronym CA"
    android:contentDescription="A misleading acronym Certificate Authority" />

<ToggleButton android:id="@+id/my_id"/>

Android 切换 textOn/Off 防止从 Talkback 读取

Android toggle textOn/Off prevent reading from Talkback

android

talkback

switchcompat

accessibility