Space | Attachments | Properties form: Error message not announced by Screen Reader

XMLWordPrintable

    • Severity 3 - Minor
    • Accessibility

      Issue Summary

      The error message "A file name is required" is not announced by screen readers.

      Test URL

      https://instenv-721616-jb2q.instenv.internal.atlassian.com/#all-updates

      Steps to Reproduce

      1. Open the Confluence Data Center instance.
      2. Select any "Space" from the header, then navigate to a page that contains attachments.
      3. Navigate to the "More options" button on the page.
      4. Select "Attachments" from the dropdown menu -> a list of pages containing attachments will be displayed.
      5. Navigate to the "Properties" link and activate it -> a form will appear on the page.
      6. Using a screen reader, navigate to the form fields, leave the "File Name" field empty, and activate the "Save" button.
      7. Observe that error message is dynamically displayed above the form fields.
      8. Notice that the screen reader does not announce the error message, and the focus moves inappropriately to the top of the page.

      Screenshot

      Screen Recording

      Screen Recording 2026-05-15 at 4.27.05 PM.mov

      Actual Results

      When users submit the "Properties" form with empty fields, an error message such as "A file name is required" is dynamically displayed above the form fields. However, this error message is not announced by screen readers, and after activating the "Save" button, the screen reader focus moves inappropriately to the top of the page.

      As a result, screen reader users are unaware about the occurrence of errors.

      Expected Results

      Ensure error messages are conveyed to screen reader users. In this scenario, when the "Save" button is activated, focus should move immediately to the "File Name" field, and the screen reader should announce the error message.

      Apply the following changes ->

      • Add 'aria-describedby' attribute on the <input> element.
      • Ensure the 'aria-describedby' attribute references the 'id' attribute value of the <div> that contains the error message.
      • Update the attribute role="alert" to the <div> element that contains the error message to ensure it is announced immediately.
      • Set focus on the first field with error using the JavaScript .focus() method as soon as the form is submitted.

      Code Snippet:

      <div role="alert" id="rename-error" ...>A file name is required</div>
      ...
      <label for="newFileName">File Name</label>
      <input id="newFileName" aria-describedby="rename-error" ...>

      Note: This code example is intended only as a general illustration of how to address the violation and should not be considered a complete or production-ready solution. If you have any questions, please attach this ticket to a #help-accessibility request.

      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 26.4
      Windows - 11 pro
      Chrome - Version 148.0.7778.97 (Official Build) (arm64)
      Safari - Version 26.4 (21624.1.16.11.4)
      JAWS - Version 2026
      NVDA - Version 2024.4.2.35031
      Voiceover - Version Latest

              Assignee:
              Unassigned
              Reporter:
              Anusooya .
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: