Skip to content

Enhance Accessibility (a11y): Add Keyboard Focus Indicators & Screen Reader Labels to Controls #126

Description

@Abhi666-max

Problem Statement

Upon auditing the frontend accessibility of the application, I noticed that several interactive control elements (such as icon-only action buttons) lack descriptive aria-labels. This renders them confusing to screen readers, violating WCAG 4.1.2 (Name, Role, Value).

Furthermore, relying on default CSS resets often suppresses native focus outlines without replacing them with :focus-visible. This leaves keyboard-only users (who rely on Tab navigation) unable to see which link or action button is currently focused, strictly violating WCAG 2.4.7 (Focus Visible).

Proposed Solution

I propose enhancing the accessibility of the UI components by implementing proper ARIA attributes and a modern, high-contrast keyboard focus ring.

The technical implementation will involve:

  1. Auditing the HTML structure (e.g., in the admin/dashboard views) to append context-specific aria-label tags to icon-only <button> and <a> elements.
  2. Updating the global stylesheet to prevent the default mouse-click outline (outline: none on :focus) while strictly enforcing a highly visible focus ring for keyboard users using the :focus-visible pseudo-class (e.g., applying an outline-offset and box-shadow that matches the brand color).

Assignment Request

I am actively participating in GSSoC '26 and am prepared to implement these accessibility standards. Please assign this issue to me. Kindly apply the relevant labels (e.g., gssoc, gssoc26, a11y, enhancement).

Metadata

Metadata

Assignees

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions