[v15.0/forgejo] Fix @mention combobox semantics for screen reader accessibility (#11922)

**Backport:** https://codeberg.org/forgejo/forgejo/pulls/11860

Fixes https://codeberg.org/forgejo/forgejo/issues/7668.

This was simpler to fix than my theory I posted on https://codeberg.org/forgejo/forgejo/issues/7668 about needing to patch the upstream package. When testing in Firefox with the developer console open and warnings enabled, I noticed a `Empty string passed to getElementById()` warning coming from `@github/combobox-nav` while attempting to manage the `aria-activedescendant` attribute. Then I found this in the [README for that project](https://github.com/github/combobox-nav).

> Markup requirements:
> - Each option needs to have role="option" and a unique id

This was easy to miss, as we're using `@github/text-expander-element` and the combobox-nav package is one of _its_ dependencies. Without a unique ID on each dropdown menu item, `@github/text-expander-element` is unable to set an appropriate `aria-activedescendant` attribute on the textarea. Once that's in place, the screen reader announcements come to life beautifully.

While working on it I noticed the emoji picker combobox was affected by the same problem and patched that as well.

Co-authored-by: Henry Catalini Smith <henry@catalinismith.se>
Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/11922
Reviewed-by: Otto <otto@codeberg.org>
Co-authored-by: forgejo-backport-action <forgejo-backport-action@noreply.codeberg.org>
Co-committed-by: forgejo-backport-action <forgejo-backport-action@noreply.codeberg.org>
This commit is contained in:
forgejo-backport-action 2026-04-01 02:17:05 +02:00 committed by Gusted
parent d42c66471a
commit 2c59849072
2 changed files with 4 additions and 1 deletions

View file

@ -12,6 +12,7 @@ export function initTextExpander(expander) {
ul.classList.add('suggestions');
for (const name of matches) {
const li = document.createElement('li');
li.setAttribute('id', `combobox-emoji-${name}`);
li.setAttribute('role', 'option');
li.setAttribute('data-value', emojiString(name));
if (customEmojis.has(name)) {
@ -33,10 +34,12 @@ export function initTextExpander(expander) {
ul.classList.add('suggestions');
for (const {value, name, fullname, avatar} of matches) {
const li = document.createElement('li');
li.setAttribute('id', `combobox-user-${name}`);
li.setAttribute('role', 'option');
li.setAttribute('data-value', `${key}${value}`);
const img = document.createElement('img');
img.setAttribute('aria-hidden', 'true');
img.src = avatar;
li.append(img);