Issue Summary

The instruction is not associated with the "Contact Email" and "Contact Name" form fields.

Steps to Reproduce

1. Open the Jira DC instance.
2. Navigate to the header section and activate the "Create" button to open the "Create issue" modal dialog.
3. Using a screen reader, navigate to the mentioned form fields.
4. Listen that the instruction is not announced along with label text of mentioned form fields.

Screen Recording

Instruction Issue.mp4

Actual Results

When screen reader users navigate through the "Contact Email" and "Contact Name" form fields in the "Create issue" modal dialog, the instructions such as "xyz@gmail.com" and "Please enter a contact name." are not announced along with the form field labels.

This issue occurs because the instructions are not programmatically associated with their respective form fields.

As a result, screen reader users might miss out important instructions.

Expected Results

The screen reader should announce the instruction along with label text.

Apply the following changes:

• Add "aria-describedby" attribute to the form field.
• Reference the "id" value of the element used to display the instruction text in the "aria-describedby" attribute.

Code Snippet:

<label for="customfield_10301">Contact email</label>
<input id="customfield_10301" type="text" aria-describedby="a1">
<p id="a1">xyz@gmail.com</p>

<label for="customfield_10300">Contact Name:</label>
<input id="customfield_10300" type="text" aria-describedby="b1">
<p id="b1">Please enter a contact name.</p>

Workaround

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

Environment

MacBook Pro (16-inch, 2021)
macOS Sequoia 15.4.1
Operations - Windows11
Chrome - Version 137.0.7151.41 (Official Build) (64-bit)
Safari- Version 18.4
Firefox- Version 138.0.1 (64-bit)
JAWS- Version 2023
NVDA- Version 2024.4.2
VoiceOver - Version Latest