glanceapp / glanceapp/glance

Improve Screen Reader Accessibility for Docker Containers Widget

Open
#438 2 comments 0 reactions 0 assignees View on GitHub
feature request
Dominant language
Go
Stars
37.1k
Forks
1.5k
Avg merge
1h 11m
Merged PRs (30d)
1

Description

The Docker Containers widget currently lacks accessibility for screen reader users. While it provides a list of container names, it does not convey additional information, such as the status of each container, in a screen reader-accessible format. This makes the widget less useful for blind users who rely on assistive technologies.

## Current Experience
When navigating the Docker Containers widget with JAWS screen reader, I hear:

```
DOCKER CONTAINERS
heading level 2

typesense

Graphic
dozzle

Graphic
glance

Graphic
[and so on for all containers]
```

## Impact
This accessibility barrier:
1. Prevents blind users from accessing critical information about container statuses.
2. Creates an unequal experience compared to sighted users.
3. Reduces the usability of the widget for monitoring Docker containers.

## Suggested Improvements
1. **Add Descriptive Alt Text**: Ensure graphics representing container statuses include alt text describing their meaning (e.g., "Running", "Stopped", "Error").
2. **Programmatic Association**: Link status information programmatically to container names so screen readers can announce both together.
3. **Follow Accessibility Standards**: Implement changes in compliance with WCAG 2.1 AA guidelines:
- **1.1.1 Non-text Content**: Provide text alternatives for graphics.
- **4.1.2 Name, Role, Value**: Ensure proper accessibility metadata is included.

## Offering Assistance
As a blind user and accessibility advocate, I am happy to test any changes and provide feedback to ensure the widget meets accessibility standards. Please feel free to reach out if you need clarification or want to discuss potential solutions.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.