Skip to content

[9.2] [Search][Accessibility] Announce changes when resetting terms in synonyms panel (#237877)#238420

Merged
kibanamachine merged 1 commit intoelastic:9.2from
kibanamachine:backport/9.2/pr-237877
Oct 10, 2025
Merged

[9.2] [Search][Accessibility] Announce changes when resetting terms in synonyms panel (#237877)#238420
kibanamachine merged 1 commit intoelastic:9.2from
kibanamachine:backport/9.2/pr-237877

Conversation

@kibanamachine
Copy link
Contributor

Backport

This will backport the following commits from main to 9.2:

Questions ?

Please refer to the Backport tool documentation

…nyms panel (elastic#237877)

## Summary
Currently, when a user clicks `Reset changes` or `Remove all` on the Add
Terms panel (for either equivalent or explicit types) in the Synonyms
set editor, the terms are reset visually but the change is not announced
by VoiceOver on macOS Safari. This breaks WCAG 4.1.2: Name, Role, Value
(Level A).

This PR updates the Add Terms panel to use `aria-live="polite"`
announcements when either buttons are clicked, so screen readers can
inform users of the change.

### How to test
1. Enable VoiceOver on macOS (Cmd + F5).
2. Open Kibana and navigate to **Search → Synonyms**.
3. Create a new synonyms set and select either "equivalent" or
"explicit" rule.
4. Add terms and click "Reset changes".
5. Confirm that VoiceOver announces that the terms have been reset.
6. Add terms and click "Remove all".
5. Confirm that VoiceOver announces that the terms have been removed.

### Checklist

Check the PR satisfies following conditions.

Reviewers should verify this PR satisfies this list as well.

- [ ] ~Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/src/platform/packages/shared/kbn-i18n/README.md)~
- [ ]
~[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials~
- [ ] ~[Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios~
- [ ] ~If a plugin configuration key changed, check if it needs to be
allowlisted in the cloud and added to the [docker
list](https://github.com/elastic/kibana/blob/main/src/dev/build/tasks/os_packages/docker_generator/resources/base/bin/kibana-docker)~
- [ ] ~This was checked for breaking HTTP API changes, and any breaking
changes have been approved by the breaking-change committee. The
`release_note:breaking` label should be applied in these situations.~
- [ ] ~[Flaky Test
Runner](https://ci-stats.kibana.dev/trigger_flaky_test_runner/1) was
used on any tests changed~
- [x] The PR description includes the appropriate Release Notes section,
and the correct `release_note:*` label is applied per the
[guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)
- [x] Review the [backport
guidelines](https://docs.google.com/document/d/1VyN5k91e5OVumlc0Gb9RPa3h1ewuPE705nRtioPiTvY/edit?usp=sharing)
and apply applicable `backport:*` labels.

## Release Note

Fixes an accessibility issue where resetting changes or removing all
terms in the Synonyms panel was not announced by screen readers.
VoiceOver users on Safari will now hear updates when terms are reset.

(cherry picked from commit 9e7e748)
@kibanamachine kibanamachine requested a review from a team as a code owner October 10, 2025 11:21
@kibanamachine kibanamachine added the backport This PR is a backport of another PR label Oct 10, 2025
@kibanamachine kibanamachine enabled auto-merge (squash) October 10, 2025 11:21
@kibanamachine kibanamachine merged commit 71c7e5c into elastic:9.2 Oct 10, 2025
16 checks passed
@elasticmachine
Copy link
Contributor

💚 Build Succeeded

Metrics [docs]

Async chunks

Total size of all lazy-loaded chunks that will be downloaded as the user navigates the app

id before after diff
searchSynonyms 64.9KB 65.8KB +976.0B

cc @seialkali

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport This PR is a backport of another PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants