Uploaded image for project: 'Sakai'
  1. Sakai
  2. SAK-38350

Ensure custom controls provide proper textual name, role, and state information

    Details

    • Previous Issue Keys:
      A11YTEST-282

      Description

      [Partially Fixed] - 3/23/2018When it is expanded, screen reader announced this expanded state. However, there is no indication about a collapsed state.The "Create Folder" page of the Resources section of the environment provides the user with the ability to create custom folders listed in the shared resources of Brock University. After giving the custom folder a name, a link is provided that is titled "Add details for this item". Activating this link reveals a series of input fields further down the page that allows the user to enter further information about the folder they are creating. Once this section has expanded, there are two more links provided to expand options for even more additional fields for the folder being created. However, these links do not inform screen reader users that they expand a section of content on the page. As they are simply announced as links, screen reader users will believe that activating the link will navigate them away from the current page, as opposed to provide more options on the current one.

      <a title="Show label.dc" href="#hideMetadata_dublin_core_0" id="showMetadata_dublin_core_0"><img width="13" border="0" height="13" align="top" alt="Show label.dc" src="/library/image/sakai/expand.gif" id="showMetadataImage_dublin_core_0">Optional properties</a>

      Developers must ensure that all controls inform screen reader users of their role and state. As this link controls the expansion of additional content on the current page, it must be assigned the

      <aria-expanded> attribute with a value switching between "true" and "false" depending on the state of the control.  Currently this link utilizes both the <title> attribute on the anchor with a value of "Show label.dc", as well as the <alt> attribute on the inner image with the same value.  Not only are these values not informative to the purpose of the control, but they cause serious confusion for a screen reader user.  As such, the <title> attribute on the anchor element must be removed, and the <alt> attribute value changed to null ("") on the inner image.  This combined with the addition of the <aria-expanded> attribute will more clearly inform screen reader users of the purpose of the control.  The code below is provided as an example of this remediation:WHEN EXPANDED<a href="#hideMetadata_dublin_core_0" id="showMetadata_dublin_core_0" aria-expanded="true"><img width="13" border="0" height="13" align="top" alt="" src="/library/image/sakai/expand.gif" id="showMetadataImage_dublin_core_0">Optional properties</a>WHEN COLLAPSED<a href="#hideMetadata_dublin_core_0" id="showMetadata_dublin_core_0" aria-expanded="false"><img width="13" border="0" height="13" align="top" alt="" src="/library/image/sakai/expand.gif" id="showMetadataImage_dublin_core_0">Optional properties</a>

        Gliffy Diagrams

          Attachments

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                jonespm Matthew Jones
              • Votes:
                0 Vote for this issue
                Watchers:
                0 Start watching this issue

                Dates

                • Created:
                  Updated:

                  Git Source Code