ankidroid / ankidroid/Anki-Android
Accessibility: Missing labels on Home Screen ("Collection is empty") and other fixes
- Dominant language
- Kotlin
- Stars
- 11.8k
- Forks
- 2.9k
- Avg merge
- 2d 3h
- Merged PRs (30d)
- 171
Description
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,
Contributor guide
Assessment
This issue has not been assessed yet.