Skip to content

A11y: Broken ARIA menu #5752

@david-prv

Description

@david-prv

Describe the Bug

Since Directive (EU) 2019/882 of the European Union, products and services relevant to that directive are required to establish compliance with a set of obligatory accessibility rules. As BookStack is also used as publicly accessible community hubs, sometimes even for governmental purposes, I was interested in its out-of-the-box accessibility features.

While doing that, I noticed, that the dropdown menu is missing the required ARIA menu items. On first sight, this seems to be the only violation I could find. There may be more, however.

The above means, that each menu labelled with role="menu" requires its menu items to be labelled accordingly as well, i.e. role="menutiem", role="menuitemcheckbox" or role="menuitemradio".

Relevant standards and guidelines:

Steps to Reproduce

  1. Go to the startpage
  2. Open the dropdown menu by clicking on your username on the upper right corner
  3. Inspect the code

Alternatively:

  1. Install the "WAVE" browser extension
  2. Enable it while visiting the startpage
  3. Inspect the displayed error

Expected Behaviour

As described above, it should follow the a11y guidelines.

Screenshots or Additional Context

WAVE report:
Image

Browser Details

No response

Exact BookStack Version

v25.05.1

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions