Accessibility Module

Button is missing an accessible name

• Submit a request for assistance

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant table cells
• Review the Tables help page
• Update the identified table to only use one layer of header cells and ensure proper scope is set for all header cells

• Submit a request for assistance

Indicates the use of links in collapsible list headings (these elements serve to open and close the expandable content and must not also include links)

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant headings
• Remove any links from these headings

• Submit a request for assistance

Likely indicating:

• One or more headings are included on the page with no content in them — this occurs most often when an editor has tried to add extra visual space between elements on the page by including an empty heading
• An image is within a heading — this occurs most often when an editor has inserted an image and it was inadvertently inserted within a heading instead of the adjacent paragraph
• Erroneous, hidden code was pasted in from another source when adding the text of the heading to the page

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the issue on the page. When you highlight the reported issue in the information panel, you may see it as something similar to <h2>&nbsp;</h2> or <h3> </h3> — the "&nbsp;" or " " are the equivalent of an empty heading.
• If it's an empty heading, delete it
• If it's an image within a heading tag, delete the image from the page and re-insert it — ensure you do not insert it in a heading
• If it's erroneous code, select the visible heading text and select Format > Clear formatting — then reapply the heading format (review the Formatting help page for details) 
• Contact your Cascade Manager for assistance, if needed

• Remediating this issue requires access to the source code
• Discuss with the member of your team who is responsible for the embed and contact your Cascade Manager for assistance

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the affected image(s)
• Update the image's file and update the Display Name field — this is the image's default alt text and will be included each time the image is used unless overridden by the Image Description field for content images
• For content images, you must also edit the page, select the affected image, select the Insert/edit image button to open the dialog box, un-check the 'This is a decorative image. No description needed.' check box. Fill in a brief description of the image in the 'Image description' field — this field overrides the default alt text you provided in the Display Name field, for that specific usage of the image only.
• Contact your Cascade Manager for assistance, if needed

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant aria labels in the source code
• Edit the page, use your cursor to select the portion of content you think holds the offending hidden code and select Format >> Clear formatting
• Contact your Cascade Manager for assistance, if needed

Likely indicates the use of a table for layout/formatting purposes. All tables in Cascade require a caption be provided, so they must only be used to organize data meaningfully into rows and columns, where a caption is appropriate.

Collapsible lists are a unique exception. They are used for layout/formatting purposes, but they are handled uniquely in the source code to ensure they meet accessibility requirements.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant table
• Tables used for collapsible lists should not trigger this issue — the templates programmatically suppress the table caption for screen readers, thus improving their accessibility 
• If the table is organizing data into meaningful rows and columns, the issue can be resolved by adding appropriate header cells (review the Tables help page to learn how)
• If the table is not a collapsible list and is being used for layout purposes, update the page to include the content without the use of a table

This will be rare and indicates an old hidden table summary is still included in the source code of the page.

Cascade now uses a caption to provide a description to those using screen readers.

• Contact your Cascade Manager for assistance in removing the table's summary from the source code

Indicates a link in the source code with no visible link text on the page, or a linked image with no alt text for the image.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant link
• If it a link with no visible text, contact your Cascade Manager for assistance in removing the link from the source code
• If it is an image that is linked, ensure the image has alt text:
  • Update the image's file and update the Display Name field — this is the image's default alt text and will be included each time the image is used unless overridden by the Image Description field for content images
  • For content images, you must also edit the page, select the affected image, select the Insert/edit image button to open the dialog box, ensure the Image Description field is filled in with a brief description of the image  —if the 'This is a decorative image. No description needed.' check box is selected, un-check it to un-hide the Image Description field. This field overrides the default alt text you provided in the Display Name field, for that specific usage of the image only.

This will be rare and indicates the page includes a link for visitors to follow to an element you should not link to, such as a row or deprecated page type.

• If the indicated "page" missing a title is a Cascade row file, check relationships to that row to help locate on what page you may be inadvertently linking to a row file in the body of the page.
• If the indicated "page" missing a title is something other than a row, contact your Cascade Manager for assistance.

This is less common, but identifies large tables that may be causing an issue on some devices.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant link
• If it is a table used for layout/formatting purposes, adjust the page to present the content without a table
• If it is a table used correctly for organizing data logically into rows and columns (review the Tables help page for details), submit a request for assistance
• If it is something other than a table, submit a request for assistance

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the non-compliant table cells
• Adjust the setting for  the header cells to assign correct scope (review the Tables help page for details)

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the identified image(s)
• If the images contain no meaningful content, you can disregard the warning for that image
• If the image does contain meaningful content:
  • Update the image's file and update the Display Name field — this is the image's default alt text and will be included each time the image is used unless overridden by the Image Description field for content images
  • For content images, you must also edit the page, select the affected image, select the Insert/edit image button to open the dialog box and un-check the 'This is a decorative image. No description needed.' check box, and fill in a brief description of the image in the 'Image description' field that is now available — this field overrides the default alt text you provided in the Display Name field, for that specific usage of the image only.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the spaces
• If unintentional, update the page to remove the extra spaces
• If intentional, update the page to use appropriate page elements such as headings followed by paragraph text or tables to communicate the information accessibly

• Review the page and update the link text to more unique and meaningful phrases

• Select the magnifying glass icon to inspect the page with the web browser extension to locate and review the identified issue
• If it is flagging multiple YouTube videos embedded on the page using the supported methods (widget, page embed using {{ }}, video feature or 50-50 rows), this warning can be disregarded
• If it is flagging a non-YouTube embed, discuss with the member of your team who is responsible for the embed and contact your Cascade Manager for assistance

Indicates images and graphic elements that do have alternative text in place. Your task is to confirm if the text serves as a good alternative for the image — it should clearly describe its purpose or meaning. If the description is too vague or generic, users who rely on screen readers may not understand the image's relevance or intent.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate and review the image(s).
• The current accessible name, or alt text, for each image will be displayed in the information panel as part of the code snippet displayed in each pink box — it's the quoted text that follows alt=.
• If the alt text is appropriately descriptive, no changes are needed.
• If it is not appropriately descriptive, update it in Cascade:
  • Edit the image's file and update the Display Name field — this is the image's default alt text and will be included each time the image is used unless overridden by the Image Description field for content images
  • For content images, also update the Image Description field by editing the page, selecting the image and selecting 'Insert/edit image' — this field overrides the default alt text you provided in the Display Name field, for that specific usage of the image only.

Indicates links multimedia file types (including GIFs) that may be missing a text transcript

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the multimedia
• For audio and video files, ensure a transcript is available
• Can be ignored for GIF files if they do not include movement

• Review all pages identified by this check and update to use the bullet list or numbered list in the WYSIWYG editor, if appropriate.

• Regularly review the headings on your pages to ensure they are being used to accurately convey hierarchical structure and not to just format the appearance of your text.
• The page's title serves as the Heading 1. Whenever you can organize your page content into topical sections, use the Heading 2 format to add meaningful section titles. Heading 3 can then be used to organize into additional sub-sections.

• Review the table captions to ensure compliance (review the Tables help page for details)

Indicates an image on the page may contain text with poor contrast (the luminosity contrast ratio between text and background color in all images must be at least 5:1).

We strongly recommend no text content be communicated in images unless it is a logo or similar brand mark that is not trying to convey content. This ensures that the text can be resized, read by screen readers, and adapted to different user needs.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the flagged image(s)
• Additional testing tools such as WAVE accessibility tool to evaluate contrast ratios will be needed to ensure that users can read text that is presented over a background

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the audio file(s)
• If words or meaning are conveyed, ensure a transcript is available

Indicates a suspected image with text in it

We strongly recommend no text content be communicated in images unless it is a logo or similar brand mark that is not trying to convey content. This ensures that the text can be resized, read by screen readers, and adapted to different user needs.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the flagged image(s)
• If words or meaning are conveyed, ensure it is also accessible on the page for screen readers, either as brief alt text for the image or in the adjacent text on the page

• Review the page to ensure text elements are not being used to present the content in a visually tabular manner.

• Regularly review the headings on your pages to ensure they clearly describe the topic or purpose of the content that immediately follows it

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the GIF image(s)
• Review any identified GIFs to see if they flicker or flash rapidly. Flickering images can trigger seizures or headaches for some users, and may be distracting or uncomfortable for others. If the image flashes more than three times per second or is visually intense, remove it.

• Select the magnifying glass icon to inspect the page with the web browser extension to locate the "pre" element
• Can be ignored if code samples are deemed appropriate