[JSDSERVER-12287] Help center: No status message provided for dynamically updating search results.

Type: Bug
Resolution: Fixed
Priority: Highest
Fix Version/s: 5.10.1
Affects Version/s: 5.5.0
Component/s: Accessibility
Labels:
- 4.1.3
- AXSR-60
- Accessibility
- Level-A
- WCAG21
- ax-at-JAWS
- ax-at-NVDA
- ax-at-VO
- ax-at-user
- ax-bug
- ax-critical
- ax-critical-priority
- ax-customer-escalated
- ax-dev-ready
- ax-esc-ssa
- ax-kb-user
- ax-qa
- ax-qa-prioritised

Symptom Severity:
Severity 3 - Minor
Bug Fix Policy:
View Atlassian Server bug fix policy

Issue Summary

The number of search results available when user search is not communicated to screen reader users.

Steps to Reproduce

With screen reader turned on, navigate to the help portal.
Navigate to he "Search" Input field, try to search for some content eg. Requests.
Observe the number of results available not announced to the users.

Actual Results

While navigating with screen reader, when user input something into "search" field, the results in main content area are updated dynamically. Although for sighted users it is easy to perceive this update, for screen reader users it is difficult to perceive since no such message is conveyed. So it would confuse them if the results are actually displayed or not resulting into bad user experience.

Expected Results

Dynamic changes happening on the page must be conveyed to all the users, including screen reader users.

The number of results available when user input something into "Search" fields must be announced by screen reader using status message.

Status messages must be programmatically determined. To achieve this, use a ARIA live region role, such as role=”status” ensure that the entire text node containing the number of results is always announced. The instruction could be visible on the page or off-screen.

Code Snippet

<span role="status">10 results found.</span>

Refer to Atlassian Accessibility standards of Status messages: https://hello.atlassian.net/wiki/spaces/A11Y/pages/1495220670/Status+Messages

Also as a best practice provide additional instruction to help screen reader users understand the behaviour ahead of time.

For example: "When you type the results will be displayed in main content"

This instruction can be off-screen & should be associated with the search input field via aria-describedby attribute.

Screen recording

Screen Recording 2023-01-04 at 5.27.29 PM.mov

Workaround

Currently, there is no known workaround for this behavior. A workaround will be added here when available

- - Sort By Name
  - Sort By Date
  - Ascending
  - Descending
  - Thumbnails
  - List

Screen Recording 2023-01-04 at 5.27.29 PM.mov
6.27 MB
04/Jan/2023 11:58 AM

mentioned in: Page Failed to load; Page Failed to load; Page Failed to load; Page Failed to load; Page Failed to load

Form Name

Bartosz Ornatowski made changes - 04/Apr/2025 12:25 AM

Priority

Original: High [ 2 ]

New: Highest [ 1 ]

Divyanshi made changes - 04/Jun/2024 4:51 AM

Remote Link

New: This issue links to "Page (Confluence)" [ 912096 ]

Satej Mirpagar made changes - 02/Aug/2023 12:19 PM

Resolution		New: Fixed [ 1 ]
Status	Original: Waiting for Release [ 12075 ]	New: Closed [ 6 ]

Jim Alexander made changes - 06/Jul/2023 12:11 AM

Fix Version/s

New: 5.10.1 [ 105791 ]

Jim Alexander made changes - 06/Jul/2023 12:11 AM

Status

Original: In Progress [ 3 ]

New: Waiting for Release [ 12075 ]