使用 TextInputLayout 时可访问性检查失败答案

【问题标题】：Accessibility Check fail when using TextInputLayout使用 TextInputLayout 时可访问性检查失败
【发布时间】：2015-06-11 01:19:47
【问题描述】：

我正在使用 Android.support 提供的新 TextInputLayout 来做浮动标签。但它将无法通过 Espresso 可访问性检查，因为“视图缺少屏幕阅读器所需的可朗读文本”。

查看它并发现当父执行 addView() 时 TextInputLayout 将无效提示。这基本上就是它如何使标签向上浮动（设置标签，取消提示）。并且任何带有 null 提示的 EditText 都将无法通过可访问性检查。

有人知道如何解决这个问题吗？这真的让我发疯了..

非常感谢！！！！

【问题讨论】：

标签： android accessibility

【解决方案1】：

使 TextInputLayout 可访问的一个好方法是使用 ChrisCM 推荐的“LabelFor”，但您不必添加不可见的标签视图来执行此操作：只需输入 labelFor 或您的 @987654323 @ 并使其指向您的 EditText

示例：

<android.support.design.widget.TextInputLayout
  android:labelFor="@+id/username"
  android:contentDescription="@string/username_hint"
  android:accessibilityLiveRegion="polite">
    <edittext
      android:id="@+id/username"
      android:hint="@string/username_hint"
       …/>
</android.support.design.widget.TextInputLayout>

通过这种方式，您可以获得完全相同的视觉行为，并使“Espresso 可访问性检查”和 Talkback 满意:)

（为了让 TextInputLayout 完全可访问，我还在 TextInputLayout 元素上添加了android:accessibilityliveregion，以便在弹出错误时触发对讲）

非常感谢这篇帖子this blog post 帮了大忙

【讨论】：

现在它显示错误 Unknown attribute android:labelfor 和 Unknown attribute android:contentdescription 并且在构建项目时 aapt2 检查将失败
@HendraWD 您需要修复属性中的大写/小写。我也在上面的答案中修复了它
我添加了这个，但 TalkBack 没有从 TextInputLayout 读取 contentDescription。它只从 EditText 中读出hint。我还有什么需要做的吗？

【解决方案2】：

一般来说，提示对于可访问性不是很好。输入文本时它们会消失。尝试改用“LabelFor”。如果您不想要可见的标签，可以将标签设置为不显示。

这个应用程序将为您提供有关如何使文本框易于访问的提示。

https://play.google.com/store/apps/details?id=com.dequesystems.accessibility101

【讨论】：

链接已损坏。

【解决方案3】：

或者，如果这是误报，您可以忽略检查，如 here 所述

val validator: AccessibilityValidator = AccessibilityChecks.enable().apply {
setSuppressingResultMatcher(
        allOf(
                matchesCheckNames(`is`("TouchTargetSizeViewCheck")),
                matchesViews(withId(R.id.my_overflow))
        )
)}

当我们启用可访问性检查的测试时，会调用以下规则：

TouchTargetSizeViewCheck 目标高度或目标宽度小于 48 dp 被标记，除非检测到 touchdelegate。
TextContrastViewCheck 检查文本颜色和背景以及影响因素大文本，并计算对比度： - 4.5 用于常规文本，3 表示大文本。
DuplicateSpeakableTextViewHierarchyCheck If 层次结构中的两个视图具有相同的可朗读文本，可以是如果其中至少有一个是可点击的，这会让用户感到困惑。
SpeakableTextPresentViewCheck 如果视图可聚焦，则检查是否存在有效的可朗读文本，如果视图存在则错误缺少屏幕阅读器所需的朗读文本。
EditableContentDescViewCheck 如果 Editable TextView 具有一个内容描述。
ClickableSpanViewCheck 检查 ClickableSpan 无法访问。单个跨度不能在单个 TextView，辅助服务无法调用 ClickableSpan#onClick。
RedundantContentDescViewCheck 可访问性服务知道视图的类型，并且可以使用该信息作为需要。例如，如果内容描述有一个多余的词，例如“按钮”。
DuplicateClickableBoundsViewCheck 如果可点击视图抛出错误与另一个可点击视图（可能是后代）具有相同的边界。有时有标记为可点击的容器，但它们没有处理任何点击事件。

【讨论】：

【解决方案4】：

您可以制作一个具有

的 TextView

android:text="My Announcement For Edit Text"
android:labelFor="@id/my_edit_text".

Visibility = gone 和 visibility = invisible 会成功，所以这个标签不会被公布。此外，如果您将高度和宽度设置为 0dp，则不会宣布。相反，请使用以下内容将视图限制在屏幕之外：

app:layout_constraintEnd_toStartOf="parent"

所以你的文本视图将如下所示：

<TextView
        android:id="@+id/edit_text_label"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:labelFor="@+id/my_edit_text"
        android:text="Label For My Edit Text"
        app:layout_constraintEnd_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        />

【讨论】：

【解决方案5】：

这对我使用 withClassName 进行查看很有用

AccessibilityChecks.enable().setSuppressingResultMatcher(
        AccessibilityCheckResultUtils.matchesViews(
            Matchers.anyOf(
                ViewMatchers.withResourceName("textview1"),
                ViewMatchers.withResourceName("button1"),
                ViewMatchers.withClassName(Matchers.endsWith("TextInputLayout"))
            )
        )
    )

【讨论】：