Ally Accessibility Issues Explained

HTML Broken Link

Issue:

These HTML content items contain links to resources that no longer exist.

Solution:

1. First, find the broken link on the page:
   1. In Omni CMS, use the Page Check feature to find the broken link. OR:
   2. In Ally, click the meter icon next to the accessibility score to open the Feedback panel (live preview). The link should be highlighted on the page.
2. Next, update or remove the link:
   1. If the resource still exists but the link URL has changed, use the Insert/Edit Link option in Omni CMS to update the URL. In many cases, you can find the resource online through a Google Search or visiting the Internet Archive's Wayback Machine.
   2. If the resource no longer exists, remove the link from the page.

HTML Caption

Issue:

Videos need captions to ensure accessibility for the deaf, hard of hearing, visual learners, and non-native speakers, among others. Captions are also beneficial in sound-sensitive environments, enabling viewers to watch without sound.

Keep in mind that automated captions can be used as a starting point since they do not require human intervention. However, their accuracy may not be reliable and may need to be edited to ensure that they are correct.

Solution:

• If the video was uploaded to a webpage or social media account that you have access to, add closed captions to the video.
• If you don't have access to the video (e.g., a video from another state's Extension YouTube channel), it's best to remove the video from the page altogether.

HTML Color Contrast

Issue:

The HTML content contains text with low contrast between the text and its background. This can cause the text to be difficult to read, especially for those with low vision, poor eyesight or colour blindness.

Solution:

• If you are able to change the text or background colors, adjust the colors so they have sufficient contrast. You can measure contrast with a color contrast checker. In most cases, text should have a minimum contrast ratio of 4.5:1.
• If you cannot adjust the text and background colors (e.g., colors that are set in the website's theme), contact the accessibility manager for support at accessibility@uada.edu.

HTML Definition List

Issue:

The definition list (<dl>) elements in the HTML content contain inappropriate child elements. This can cause screen readers to read out the definition lists incorrectly.

Solution:

Description

HTML Empty Heading

Issue:

The HTML content contain headings with no content. This can cause potentially confusing contentless alerts to screen reader users.

Solution:

Description

HTML Empty Table Header

Issue:

Table header elements should have visible text that describes the purpose of the row or column.

Solution:

Description

HTML Has Lang

Issue:

The HTML content does not specify the language in which they have been created. Certain technologies, such as screen readers, rely on the specified language to determine how to process the content or pronounce the text inside of the page.

Solution:

Description

HTML Heading Order

Issue:

The HTML content contains headings that don't follow a logical order. All headings should follow a sequential and descending order. Headings are important as they provide structure to a page, especially longer ones. Well-structured and logical headings will make the page much easier to understand and navigate for all users.

Solution:

Description

HTML Headings Presence

Issue:

The HTML content doesn't contain any marked-up headings. Headings are important as they provide structure to a page. When headings are properly and consistently used, the page becomes much easier to understand and navigate for all users, and provides additional benefits such as the ability to automatically generate a Table of Contents.

Solution:

Description

HTML Headings Start

Issue:

The headings in the HTML content don't begin with the main heading and therefore don't follow a logical order. Having the main heading at the beginning of the document will provide a more logical structure and will make the document much easier to understand and navigate for all users.

Solution:

Description

HTML Image Alt

Issue:

The HTML content contains images that don't have a description or alternative text. People with screen readers or other assistive devices rely on these descriptions to understand the image content and purpose. Having a clear description for an image can help everyone better understand the content of the image and how it relates to the context.

Solution:

Description

HTML Image Redundant Alt

Issue:

The HTML content contains buttons or links with text that is repeated in the containing image's description. Screenreaders and other assistive devices would therefore read this text twice, which is redundant and potentially confusing.

Solution:

Description

HTML Label

Issue:

The HTML content contains form elements such as input boxes, checkboxes, dropdowns, etc. that are not labelled. People with assistive technologies often require the form elements to be explicitly labeled to understand the purpose of each field and to use the form effectively.

Solution:

Description

HTML Link Name

Issue:

The HTML content contains links with text that is not discernible by a screen reader or is not focusable. People with assistive technologies would be unable to understand the link or navigate to it.

Solution:

Description

HTML List

Issue:

The list (<ul> or <ol>) elements in the HTML content contain inappropriate child elements. This can cause screen readers to read out the definition lists incorrectly.

Solution:

Description

HTML Object Alt

Issue:

The HTML content contains embedded objects that don't have a description or alternative text. People with screen readers or other assistive devices rely on these descriptions to understand the purpose and content of embedded objects.

Solution:

Description

HTML TD Has Header

Issue:

The HTML content contains tables that don't have or properly specify a header structure. People with screen readers or other assistive devices rely on a semantically meaningful and correct heading structure to help them navigate the table and understand the meaning of every cell, but it can be beneficial to everyone to have a clear structure in the table.

Solution:

Description

HTML Title

Issue:

The HTML content is missing a title. HTML page titles are used as the title for a browser window or tab, making it easier to navigate to the tab and understand the purpose of the tab.

Solution:

Description

Alternative Text

Issue:

These documents contain images that don't have a description or alternative text. People with screen readers or other assistive devices rely on these descriptions to understand the image content and purpose. Having a clear description for an image can help everyone better understand the content of the image and how it relates to the context.

Solution:

Description

Contrast

Issue:

These documents contain text with low contrast between the text and its background. This can cause the text to be difficult to read, especially for those with low vision, poor eyesight or colour blindness.

Solution:

Description

Headings Higher Level

Issue:

The headings in these documents go beyond six levels. Most technologies, including screen readers and other assistive technology, are limited to six levels of headings. Going above this can cause these headings to not be represented or read appropriately.

Solution:

Description

Headings Presence

Issue:

These documents don't contain any marked-up headings. Headings are important as they provide structure to a document, especially those that consist of many pages. When headings are properly and consistently used, the document becomes much easier to understand and navigate for all users, and provides additional benefits such as the ability to automatically generate a Table of Contents.

Solution:

Description

Headings Sequential

Issue:

These documents contain headings that don't follow a logical order. All headings should follow a sequential and descending order. Headings are important as they provide structure to a document, especially those that consist of many pages. Well-structured and logical headings will make the document much easier to understand and navigate for all users.

Solution:

Description

Headings Start At One

Issue:

The headings in these documents don't begin with the main heading and therefore don't follow a logical order. Having the main heading at the beginning of the document will provide a more logical structure and will make the document much easier to understand and navigate for all users.

Solution:

Description

Language Correct

Issue:

These documents do not specify the correct language in which they have been created. Certain technologies, such as screen readers, rely on the correct language being specified to determine how to process the content or pronounce the text inside of the document.

Solution:

Description

Language Presence

Issue:

These documents do not specify the language in which they have been created. Certain technologies, such as screen readers, rely on the specified language to determine how to process the content or pronounce the text inside of the document.

Solution:

Description

OCRed

Issue:

These scanned documents have been OCRed (Optical Character Recognition). Digitizing printed text through OCR allows users and assistive technologies to extract and search text inside the document. OCRed documents, especially those of poor quality, can still be difficult to read for everyone.

Solution:

Description

Parsable

Issue:

These documents are malformed and therefore cannot be opened and viewed by many or even most people. While some technologies might be able to deal with some malformed documents, there's no guarantee that everyone will be able to view the document or that the formatting and content will be as intended.

Solution:

Description

Scanned

Issue:

These documents are either entirely scanned or contain pages that are scanned. Screen readers are unable to convert an image into words, even if the image only consists of text, so people with screen readers or other assistive devices will not be able to read those pages. Scanned documents, especially those of poor quality or those containing handwriting, can be difficult to read for everyone. They also have other usability issues such as not being able to search inside the document.

Solution:

Description

Security

Issue:

These documents are either password-protected or have security settings that can prevent access to the document, causing many or even most people to not be able to open and view the document. These protections could also prevent screen readers or other assistive technology from accessing the document.

Solution:

Description

Table Headers

Issue:

These documents contain tables that don't have or properly specify a header structure. People with screen readers or other assistive devices rely on a semantically meaningful and correct heading structure to help them navigate the table and understand the meaning of every cell, but it can be beneficial to everyone to have a clear structure in the table.

Solution:

Description

Tagged

Issue:

These PDF documents are not tagged. PDF tags are hidden labels that clarify the structure of the document and define what's a heading, paragraph, table, list, etc. Without these tags, PDF documents are essentially just a bag of difficult to distinguish words that can be really hard to navigate and understand for people with screen readers or other assistive devices.

Solution:

Description

Title

Issue:

These PDF documents are missing a title. PDF titles are used as the document title for a PDF window or tab, making it easier to navigate to the PDF and understand the purpose of the PDF.

Solution:

Description

Image Contrast

Issue:

These images contain text with low contrast between the text and its background. This can cause the text to be difficult to read, especially for those with low vision, poor eyesight or colour blindness.

Solution:

Description

Image Decorative

Issue:

No description provided.

Solution:

Description

Image Description

Issue:

These animated images contain flashing or contrasting lights or patterns that can lead to seizures for people that suffer from photosensitive epilepsy, which is a very serious and potentially life-threatening condition. Animated images with these characteristics can be generally unpleasant to look at, even for those not prone to seizures.

Solution:

Description

Image OCR

Issue:

These images contain text that is not represented in the description or alternative text of the image. People with screen readers or other assistive devices rely on these descriptions to understand the image content and purpose and will not be able to read any text in the image that's not part of the description.

Solution:

Description

Image Seizure

Issue:

These animated images contain flashing or contrasting lights or patterns that can lead to seizures for people that suffer from photosensitive epilepsy, which is a very serious and potentially life-threatening condition. Animated images with these characteristics can be generally unpleasant to look at, even for those not prone to seizures.

Solution:

Description