ankidroid / ankidroid/Anki-Android

Accessibility: Missing labels on Home Screen ("Collection is empty") and other fixes

未关闭
#20,110 5 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
Accessibility
主要语言
Kotlin
星标
11.8k
派生
2.9k
平均合并
2 天 3 小时
30 天内合并 PR
171

描述

Hi! I’m **Ana Ferreira**, a Master's student in Computer Science.

As part of my research on mobile accessibility, I am analyzing open-source Android applications to help identify and correct accessibility barriers so users can utilize assistive technologies (like TalkBack) more effectively.

I’ve been exploring **AnkiDroid** and found a specific issue on the main screen, so I wanted to propose a fix.

### 1. The Issue

On the **Home Screen (Empty Collection state)**, the **Add Deck FAB** presents the following behavior:

- **Current behavior:** The element lacks a descriptive text label. TalkBack announces it simply as "Unlabelled" (or reads the icon name without context), violating WCAG 4.1.2 (Name, Role, Value).
- **Impact:** Users relying on screen readers cannot distinguish this control or understand its function immediately.

### 2. Proposed Solution

To fix this, I suggest adding an `android:contentDescription` to the element in the XML layout.

**Code snippet / XML suggestion:**

```xml

```
*(Note: We should use an existing string resource or create a new one to support localization)*

### 3. Additional fixes (Need your input)

I have identified **3** other categories of accessibility improvements for the AnkiDroid Home Screen.

**To avoid spamming your notification feed, how would you prefer I submit these?**

- [ ] **Option A:** List them all here in this issue (I can update the comment below).
- [ ] **Option B:** Open separate issues for each specific problem.

I can provide detailed fixes for these upon request.

Please let me know your preference, and I will proceed accordingly.

Best regards,

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。