Skip to content

Accessibility: Missing labels on service ratings and navigation fixes #5

@AnaFerreira015

Description

@AnaFerreira015

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 ToS;DR and identified several accessibility issues across the service list and detail screens, so I wanted to propose a fix.

1. The Issue

On the Service List and Detail screens, several interactive elements (specifically the rating icons and expansion buttons) present the following behavior:

  • Current behavior: The elements lack descriptive text labels. TalkBack announces them simply as "Unlabelled" or "Button", violating WCAG 4.1.2 (Name, Role, Value).
  • Impact: Users relying on screen readers cannot understand the classification of a service (e.g., if it's Grade A or Grade E) or what a specific button does without trial and error.

2. Proposed Solution

To fix this, I suggest adding an android:contentDescription to the rating icons and interactive buttons in the layout XML.

Code snippet / XML suggestion:

<ImageView
    ...
    android:contentDescription="@string/grade_a_rating" />

3. Additional fixes (Need your input)

I have identified 6 other categories of accessibility improvements for ToS;DR.

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.

If you prefer to review everything at once, here is the summary of the other findings:

  1. Focus Order Failure (WCAG 2.4.3): The navigation sequence via TalkBack is illogical, skipping important service details or jumping between sections in a confusing way.
  2. Target Size Failure (WCAG 2.5.8 AA & 2.5.5 AAA): Many interactive elements are too small (below 24x24dp), making them difficult to tap accurately.
  3. Missing Labels or Instructions (WCAG 3.3.2): Search fields or filter options lack persistent labels or clear instructions for screen reader users.
  4. Gesture-Only Navigation (WCAG 2.5.1): Certain actions rely solely on gestures without simple pointer alternatives.
  5. Text Resizing Issues (WCAG 1.4.4):
    • Insufficient Increase: Text content (legal summaries) does not scale properly when the system font size is maximized.
    • Insufficient Reduction: Layout issues occur when font size is reduced (Advisory).

I can provide detailed fixes for these upon request.

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

Best regards,

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions