Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adds a defintion for essential text change #1916

Draft
wants to merge 25 commits into
base: develop
Choose a base branch
from
+25 −4
Draft

Adds a defintion for essential text change #1916

Changes from 6 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
6e74948
Merge pull request #1 from act-rules/develop
tbostic32 Aug 11, 2020
88cae51
Added required aria-checked attribute for menuitemradio and menuitemc…
tbostic32 Aug 11, 2020
f6e8dad
Merge branch 'develop' into develop
WilcoFiers Aug 24, 2020
8d02d2f
Merge branch 'act-rules:develop' into develop
tbostic32 Jun 29, 2021
098953c
Merge branch 'act-rules:develop' into develop
tbostic32 Jul 14, 2021
1d267c1
Adding essential text change definition.
tbostic32 Sep 7, 2022
6ec4c27
Update pages/glossary/essential-text-change.md
tbostic32 Sep 8, 2022
3518ba1
Clarifying definition and starting rule change.
tbostic32 Sep 28, 2022
269e0a3
Merge branch 'tbostic_essential_def' of https://github.com/tbostic32/…
tbostic32 Sep 28, 2022
93e6dab
Changing glossar link to make CI happy hopefully.
tbostic32 Sep 28, 2022
017ca8c
Apply suggestions from code review
tbostic32 Sep 29, 2022
ae85e2e
Apply suggestions from code review
tbostic32 Sep 29, 2022
a21c0be
Fixing definitions. Adding additional examples.
tbostic32 Sep 29, 2022
d21a3b7
Resolving merge conflict.
tbostic32 Sep 29, 2022
4cfa666
Merge branch 'develop' into tbostic_essential_def
Jym77 Oct 20, 2022
cb3f8e5
Merge branch 'develop' into tbostic_essential_def
tbostic32 Oct 24, 2022
2869186
Adding more examples to the definition.
tbostic32 Nov 29, 2022
888d096
Fixing typo
tbostic32 Nov 29, 2022
580edeb
Merge branch 'develop' into tbostic_essential_def
Jym77 Dec 1, 2022
8a7aed3
Update pages/glossary/essential-text-change.md
tbostic32 Feb 16, 2023
0213bb4
Reversing to using non-essential text change.
tbostic32 May 4, 2023
15e8c96
fixing definitions.
tbostic32 May 4, 2023
8b7d2c4
Merge branch 'develop' into tbostic_essential_def
tbostic32 May 4, 2023
a3076c5
Apply suggestions from code review
tbostic32 Jul 6, 2023
9544d6e
Merge branch 'develop' into tbostic_essential_def
tbostic32 Jul 6, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions pages/glossary/essential-text-change.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: Essential Text Change
key: essential-text-change
unambiguous: true
objective: true
input_aspects:
- Accessibility tree
- CSS styling
- DOM tree
---

An _essential text change_ occurs when the text content of an HTML element is required to convey accurate information to the user. An _essential text change_ may appear in any of the following forms:
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I find this to be awkward, but I also couldn't figure out a good way to say it without doing something like:

An essential text change occurs when the changing of text on a page is essential.


1. Providing context - Text is changed to provide users with additional information required to understand the current state of the page. For example, while searching for results, text may change to convey the page is *loading* to provide context to the user.
2. Live updates of important information - The content automatically updates to show the most recent information available from a data source and should not be ignored by the user.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This feels very awkward, namely specifying that the information must be important in order for this to qualify. I felt the need to do this since I wouldn't qualify the examples given in Understand 2.2.2 like weather or stock ticker information as important enough to be exempt from having controls. However, there could be information such as safety alerts/updates that I would consider to be exempt.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, this one's difficult. Who decides what should and what should not be ignored? I think we should maybe just try to give a list of the types of things that shouldn't be ignored? Maybe, financial data, information on the status of a user session, that kind of thing.