Skip to content

Missing aria label and title on "theme toggle" button #9023

Description

@davidje13

URL:

https://beta.docs.nodejs.org/http.html

Browser Name:

Firefox, Chrome

Browser Version:

153.0

Operating System:

macOS 15.7.8

How to reproduce the issue:

The theme switcher button near the search at the top of the page does not have any title (tooltip) defined, nor an aria label. This makes it potentially confusing for sighted users who must infer its purpose from the icon, and opaque to visually impaired users who are told only that it opens a menu. Adding a title can help on desktop by allowing users to check what the button does before interacting with it.

The missing title also applies to the GitHub link. Although this icon is more recognisable, I'd still suggest adding a title for clarity.

The icon itself for the theme switcher is also confusing when set to "system" (the default). It may be better to swap it out for the light or dark icon, depending on what the system is currently set to, as these icons are more recognisable.

The previous docs did include a tooltip for this button:

Old

Old docs theme switcher

New

New docs theme switcher

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status
    📋 Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions