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.

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

Success Criterion 1.4.11: Non-text Contrast (Level AA) #82

Closed
maryjom opened this issue Jan 25, 2023 · 42 comments
Closed

Success Criterion 1.4.11: Non-text Contrast (Level AA) #82

maryjom opened this issue Jan 25, 2023 · 42 comments

Comments

@maryjom
Copy link
Contributor

maryjom commented Jan 25, 2023

From Success Criterion 1.4.11:

The visual presentation of the following have a contrast ratio of at least 3:1 against adjacent color(s):

  • User Interface Components: Visual information required to identify user interface components and states, except for inactive components or where the appearance of the component is determined by the user agent and not modified by the author;
  • Graphical Objects: Parts of graphics required to understand the content, except when a particular presentation of graphics is essential to the information being conveyed.
Guidance When Applying Success Criterion 1.4.11 to Non-Web Documents and Software:

This applies directly as written, and as described in Intent from Understanding Success Criterion 1.4.11 (also provided below), replacing “user agent” with “user agent or platform software”.

With these substitutions, it would read:

The visual presentation of the following have a contrast ratio of at least 3:1 against adjacent color(s):

  • User Interface Components: Visual information required to identify user interface components and states, except for inactive components or where the appearance of the component is determined by the [user agent or platform software] and not modified by the author;
  • Graphical Objects: Parts of graphics required to understand the content, except when a particular presentation of graphics is essential to the information being conveyed.

NOTE
An example of appearance modification by the author is content that sets the visual style of a control, such as a color or border, to differ from the default style for the platform.

NOTE
See also the discussion on Closed Functionality.


In Appendix A. Success Criteria Problematic for Closed Functionality add the following:

  • 1.4.11 Non-text Contrast—There are cases where applying this SC to non-web software on closed functionality products is problematic:
    • Products where the appearance of non-text content is determined by the hardware and not modifiable by the author (rather than determined by a user agent or platform software); such products should meet the exception for this SC.
    • Products with no ability to perform a screen capture (either directly or by attaching to another device that can perform a screen capture) and have no ability to programmatically determine the foreground and background colors used by the software. This means that quantifiable testing cannot be performed to ensure the contrast requirement has been met.

Since the WCAG 2.2 definition of "state" needs no word substitutions or interpretation, add the following bullet to the Glossary Items that Apply to All Technologies section.

  • state
@maryjom maryjom self-assigned this Jan 25, 2023
@maryjom maryjom changed the title Success Criterion 1.4.11: Non-Text Contrast (Level AA) Success Criterion 1.4.11: Non-text Contrast (Level AA) Jan 31, 2023
@maryjom
Copy link
Contributor Author

maryjom commented Jan 31, 2023

Created survey of 1.4.11 due on 16 February.

@maryjom
Copy link
Contributor Author

maryjom commented Feb 6, 2023

Definition of "state" in WCAG 2.2 is:

state
dynamic property expressing characteristics of a user interface component that may change in response to user action or automated processes

States do not affect the nature of the component, but represent data associated with the component or user interaction possibilities. Examples include focus, hover, select, press, check, visited/unvisited, and expand/collapse.

Since this definition applies as written, it can simply be listed in the Glossary Items that Apply to All Technologies section.

@mitchellevan
Copy link
Contributor

Testers often ask: Without access to application source code, how do I determine whether "the appearance of the component is determined by the [user agent or platform software] and not modified by the author"?

To address this question, I propose adding the following note.

"Note: An example of appearance modification by the author is an application that sets the visual style of a control, such as a color or border, to differ from the default style for the platform."

@detlevhfischer
Copy link

detlevhfischer commented Feb 16, 2023

Thanks @mitchellevan for pointing out this issue in my issue #94, which now seems redundant.

I have no access to the survey linked to above, and wonder whether WCAG2ICT (and probably in turn vor an EN clause 11 update) has now firmly agreed on the position that native controls that do not meet contrast (like the iOS switches) are then to be exempt when used without modifiation in mobile apps. That is my understanding now.

@maryjom Is that an agreed position of the WCAG2ICT group?

@maryjom
Copy link
Contributor Author

maryjom commented Feb 16, 2023

@detlevhfischer The survey results should be accessible by anyone. The task force is discussing in our meeting today. These SC issues are to introduce draft content to the Task Force, which we in turn discuss after surveying. Today begins the discussion on this topic so your input is quite timely. We will discuss your comments as well during our meeting.

@detlevhfischer
Copy link

@maryjom Thanks, I can indeed see the results.

@maryjom
Copy link
Contributor Author

maryjom commented Feb 16, 2023

Cases to think about:

  • Color values cannot be set by the author (e.g. Monochrome LED or LCD screens)
  • Test issues: when color isn't programmatically available and there is no capability to screen shot to test color

@mraccess77
Copy link

Single lightness is one thing exception - but grayscale is materially not as SC 1.4.11 is focused on differences in lightness which can be done in grayscale as well. It's not specific to hues.

@mitchellevan
Copy link
Contributor

mitchellevan commented Feb 16, 2023

Option # 2 for the note (from the Task Force call today):

Note: An example of appearance modification by the author is content that sets the visual style of a control, such as a color or border, to differ from the default style for the platform.

Option # 3 for the note (plainer language):

Note: Colors, border styles, and focus ring styles that differ from platform defaults are examples of appearance modified by the author.

@maryjom
Copy link
Contributor Author

maryjom commented Feb 17, 2023

@mitchellevan I like Option 3 - nice and simple.

@mitchellevan
Copy link
Contributor

I have a concern about my phrase "platform defaults," which conveys scenarios # 1 and # 2 in the following list. The normative phrase "appearance determined by the [user agent or platform software]" actually covers three scenarios:

  1. Determined by the platform, with no platform user setting: The platform provides a control style, and the platform does not provide a mechanism for users to change the style.
  2. Platform default: The platform allows users to change a control style through platform settings, and the user hasn't done so.
  3. Platform preference: The user has changed a control style through platform settings.

Rather than re-complexifying the language, let's think about adding a second example.

Option # 4 for the note (adding an example of appearance not modified):

Note: Colors, border styles, and focus ring styles that differ from platform defaults are examples of appearance modified by the author. Honoring a user's platform settings for color and style is an example of appearance not modified by the author.

Combined with the word substitution "user agent or platform software," if agreed by the Task Force this note will confirm @detlevhfischer's assertion:

native controls that do not meet contrast (like the iOS switches) are then to be exempt when used without modifiation in mobile apps

@mraccess77
Copy link

The user agent exception was very tightly scoped to "appearance of the component is determined by the user agent and not modified by the author;" So any visual modification by the author would impact this - not just color or focus indicator.

If the user has made changes to platform settings that overwrite the styles then that is out of the control of the author. Historically WCAG has not for example, been applied in high contrast mode.

@mitchellevan
Copy link
Contributor

Hi @mraccess77, I agree with your last comment, and as far as I can tell all four proposed Note options are already consistent with your comment. Can you point out something specific that's incorrect or not clear enough in the proposal?

@mraccess77
Copy link

mraccess77 commented Feb 17, 2023

I can't find option 1 - but option 2 seems most accurate with 3 and 4 appearing to imply that other visual styles aren't covered.

@maryjom
Copy link
Contributor Author

maryjom commented Feb 24, 2023

I'm thinking some simple options might be:

Option 1:

Note: Honoring all user agent or platform settings for color and style is an example of appearance not modified by the author.

Option 2:

Note: An example of appearance modification by the author is an application that sets the visual colors to differ from the default style for the user agent or platform.

Thinking about my previous comment from a conversation with Sam Ogami regarding closed products or products with specific types of monochromatic LCD or LED screens. We had discussed the two cases:

  1. When color values cannot be set by the author (e.g. Monochrome LED or LCD screens).

I think this would be covered by the exception. @mraccess77 I'm not talking about all LCD screens, but there are classes of monochromatic LCD screens where only brightness can be adjusted, not grayscale.

  1. Test issues: when color values aren't programmatically available and there is no capability to screen shot to test color.
    Testers would have take a picture with some camera which could inadvertently skew colors. The colors may appear differently because of coatings on the glass (privacy, matte finish, etc.) or level of backlighting of the screen that could negatively affect the ability to accurately capture or determine color values and contrast. This is often the case on closed products - no accessibility layer or API to query colors, etc.
    @samogami Did I capture this right? Should there be a note, or maybe something added to the closed functionality section? Do these issues happen on non-closed products?

@samogami
Copy link

I agree with @maryjom on points 1 and 2 in her comment. There are devices where that lack control of color. For part 2, I cannot think of non-closed devices in this situation.

@GreggVan
Copy link

GreggVan commented Feb 25, 2023 via email

@mitchellevan
Copy link
Contributor

We need to separate documents from software from hardware.Our guidelines deal with documents and software — not hardware.Closed products are not covered by our guidelines in many ways — so I don’t think we should spend time / effort etc. on closed product issues.

Good point, I agree it's too much of a stretch to apply WCAG to hardware, like a physical screen.

That said, software can have closed functionality. EN 301 549 addresses closed functionality software while Section 508 does not. For example, a company develops software to run in kiosk mode on a variety of tablet hardware. Such software must be evaluated for EU procurement. If the scope of the WCAG2ICT task force allows us, I'm in favor of addressing closed functionality software — including under 1.4.11.

@mitchellevan
Copy link
Contributor

Test issues: when color values aren't programmatically available and there is no capability to screen shot to test color.
... Do these issues happen on non-closed products?

I've evaluated streaming apps on a TV set top box. Apps in this environment are arguably not closed. For example, it lets me attach my own wired USB keyboard in lieu of the TV remote D-pad. Yet the app and the platform provide no screenshot capability.

Next time I audit such apps I plan to try an HDMI capture device to evaluate colors. For purposes of WCAG2ICT though we can just say 1.4.11 applies, and leave the screen capture difficulties to techniques (out of scope).

@mraccess77
Copy link

I agree with @mitchellevan that we need to address products with closed functionality software. I'd also point out that Section 508 also defines closed functionality

Closed Functionality. Characteristics that limit functionality or prevent a user from attaching or installing assistive technology. Examples of ICT with closed functionality are self-service machines, information kiosks, set-top boxes, fax machines, calculators, and computers that are locked down so that users may not adjust settings due to a policy such as Desktop Core Configuration.


So a PC that is locked down to prevent turning on certain accessibility features could be considered a product closed functionality.

@mraccess77
Copy link

I agree with @mitchellevan on color values - even though color values may be difficult to obtain doesn't mean the criteria could not be applied. Some color values are difficult to obtain in software as well because some platforms have color profiles that change the colors.

@maryjom
Copy link
Contributor Author

maryjom commented Feb 27, 2023

@GreggVan @mitchellevan We are not talking about applying these requirements to closed product hardware. However, the problem exists today where this requirement is directly being applied to closed product software in the EN 301 549. So there does need to be something said that this type of requirement often doesn't make sense to apply to non-web software on closed functionality products - because there may be hardware limitations where this requirement does not make sense to apply. This is why the conversation is so important. Here is the quoted text from the EN:

11.1.4.11 Non-text contrast
Where ICT is non-web software that provides a user interface, it shall satisfy WCAG 2.1 Success Criterion 1.4.11 Non- text Contrast.

There are no notes, nor pointers to alternate Closed functionality requirements. It is being applied across the board to all non-web software. WCAG2ICT can, and should, point out these complications.

@GreggVan
Copy link

GreggVan commented Feb 27, 2023 via email

@maryjom
Copy link
Contributor Author

maryjom commented Feb 27, 2023

@GreggVan I'm sure you recall that we do have a section in the WCAG2ICT note that does talks about SC that are problematic for closed functionality. It is fully within the scope of this Task Force to talk about and add content to the existing section about the application of WCAG to non-web software on products with closed functionality. See the WCAG2ICT Task Force work statement Scope of work section that includes the following bullet:

clarification of challenges of applying particular WCAG 2.x success criteria to non-web ICT, including closed product software;

For non-web software on products with closed functionality, those writing the software will often know exactly what hardware it is run on. They may not know the specific default contrast of the hardware, but will know whether or not they can modify colors/contrast. At the very least, I think we do need to say something about this being a problematic requirement for non-web software on products with closed functionality. If only to note there are instances where the closed functionality software has no ability to control the contrast of non-text content in the UI.

Perhaps the following note would suffice:

There are instances in products with closed functionality where the appearance of the non-text content is determined by the hardware and not modifiable by the author (rather than determined by a user agent or platform software); these instances should fit into the exception for this SC.

@patrickhlauke
Copy link
Member

those writing the software will often know exactly what hardware it is run on. They may not know the specific default contrast of the hardware

incidentally, this holds true just the same way (or even more so, actually) for web development ... authors are not in control of an end user's actual experience as they don't know what device, OS, system settings, user settings are in effect ... which is why the SC (and the text contrast SC) only care about the colours as defined in the underlying markup/stylesheets, rather than the "as measured on the actual screen" colours/contrasts. so i'm not quite sure why this is seen as contentious in the context of non-web ICT

@maryjom
Copy link
Contributor Author

maryjom commented Feb 27, 2023

@patrickhlauke I am contending that this SC should not be applied to all non-web software, as there are hardware implications for certain closed functionality products where there is no "platform software" nor "user agent" to be able to utilize the existing exception in the SC. It seems there should be an allowable exception because the non-text content's contrast is not controllable by the non-web software author as a more general exception.

Web content always has some "user agent" and sometimes also a platform software, so it is easy to see where the exception would apply.

@samogami
Copy link

samogami commented Mar 2, 2023

I agree with @maryjom. wcag2ict is about non-web software and documents.

To the comment above:

"If someone is writing software— they have no knowledge of the hardware it will run on."

I disagree with this statement and other discussions about SC where some dismiss the mention of devices as examples. Some web developers, printers, cameras, TVs, IoT devices, and others, developers must know the hardware that their software is running on. Putting web centric norms and values without considering the diversity of software and ICT creates SC that are impossible to implement, provide no greater accessibility, and discourage innovation.

I am not advocating the removal of contrast requirements or other SC that are determined to be appropriate for other ICT, including closed systems.

When applying WCAG to ITC, hardware, closed systems, and other ITC examples need to be open to discussion and should not be dismissed. Examples that include hardware can provide contextual use of devices/situations that need to be exempt or provide a different way to meet SC.

For this particular SC, I agree with the direction of @maryjom note:

NOTE: There are instances in products with closed functionality where the appearance of the non-text content is determined by the hardware and not modifiable by the author (rather than determined by a user agent or platform software); these instances should fit into the exception for this SC.

@patrickhlauke
Copy link
Member

unless i'm misreading @samogami's message, I'm a bit puzzled by the assertion that requiring non-text contrast for non-web contexts would stifle innovation. there are certainly cases where an author/developer has no direct control over, say, the exact colours used (as it may be given by the underlying system itself and outside of their influence), but there are just as many scenarios where developers of non-web ICT do have complete control over colour combinations used (think native Windows/macOS/Linux applications or similar). so the discussion is not about "stifling innovation", but more generally about making sure authors aren't on the hook for things they can't directly control in the environment that they're operating in.

@maryjom
Copy link
Contributor Author

maryjom commented Mar 2, 2023

So could this possibly be a good note?

NOTE: There are instances in products with closed functionality where the appearance of the non-text content is determined by the hardware and not modifiable by the author (rather than determined by a user agent or platform software); these instances should fit into the exception for this SC.

@mraccess77
Copy link

I agree with Patrick - for me non-text contrast issues are just as important on closed systems like printers as they are on websites and mobile apps. My printer has a full color screen and icons with low contrast and that makes a big impact on me. Point of sale devices, transaction screens often have icons with low vision but most have the capability to create better contrast icons. Many closed systems use platforms like Android to deliver the content on LED screens and where they do have control of the colors used it would seem this requirement should be applicable.

@maryjom
Copy link
Contributor Author

maryjom commented Mar 2, 2023

@mraccess77 I don't disagree that there are some closed systems where the author CAN control the colors used - because that closed system's display has the full color choice capabilities. However, there are also some closed systems where there are no colors or limited colors to choose (like only foreground colors, some with limited numbers of colors (like 8) and the background is not a settable color) and the software author has no, or highly limited, control of the colors that appear on the screen. These are the cases we'd like to cover. Software authors can't make a program overcome limitations of the hardware/firmware that is part of the display. That is what my proposed note is trying to address.

@mraccess77
Copy link

@maryjom I don't disagree that some software can't control those aspects - I was not responding to you.r comment. I agree with your note. I was responding to another person's comment on the notion that non-text contrast was a web-centric thing because the hardware is known. To me non-text contrast is web-centric and websites don't know the hardware either - the website could be displayed on a VR headset or a TV.

One other aspect I would like to bring up is when the hardware and software are both controllable for the same organization and the choice is then made to use insufficient contrast when contrasting combinations would be available.

@maryjom
Copy link
Contributor Author

maryjom commented Mar 2, 2023

@mraccess77 Thanks for the clarification. I agree that when hardware and software are both controllable by the same organization that choices should be made to ensure good contrast. That is outside of the scope of what the WCAG2ICT can really comment on. As Gregg had correctly mentioned, we don't tackle hardware issues - outside of our scope. We stick a little more tightly to thinking only about the application of WCAG requirements to the wide variety of software and where doing so may not work so well. I will update my proposal to include the note I drafted and send it to the TF for review.

@samogami
Copy link

samogami commented Mar 7, 2023

I apologies for the confusion that my comment above might of caused. I have modified it in hopes of making it more understandable.

@maryjom
Copy link
Contributor Author

maryjom commented Mar 20, 2023

Update made to the note on the closed functionality bullet to address survey comments from Sam, Mitchell and Fernanda.

From Success Criterion 1.4.11:

The visual presentation of the following have a contrast ratio of at least 3:1 against adjacent color(s):

  • User Interface Components: Visual information required to identify user interface components and states, except for inactive components or where the appearance of the component is determined by the user agent and not modified by the author;
  • Graphical Objects: Parts of graphics required to understand the content, except when a particular presentation of graphics is essential to the information being conveyed.
Guidance When Applying Success Criterion 1.4.11 to Non-Web Documents and Software:

This applies directly as written, and as described in Intent from Understanding Success Criterion 1.4.11 (also provided below), replacing “user agent” with “user agent or platform software”.

With these substitutions, it would read:

The visual presentation of the following have a contrast ratio of at least 3:1 against adjacent color(s):

  • User Interface Components: Visual information required to identify user interface components and states, except for inactive components or where the appearance of the component is determined by the [user agent or platform software] and not modified by the author;
  • Graphical Objects: Parts of graphics required to understand the content, except when a particular presentation of graphics is essential to the information being conveyed.

NOTE
An example of appearance modification by the author is content that sets the visual style of a control, such as a color or border, to differ from the default style for the user agent or platform.

NOTE
See also the discussion on Closed Functionality.


In Appendix A. Success Criteria Problematic for Closed Functionality add the following:

  • 1.4.11 Non-text Contrast—There are cases where applying this SC to non-web software on closed functionality products is problematic:
    • Products where the appearance of non-text content is determined by the hardware and not modifiable by the author (rather than determined by a user agent or platform software); such products should meet the exception for this SC.
    • Products with no ability to programmatically determine the foreground and background colors used by the software. This means that precise quantifiable testing cannot be performed to ensure the contrast requirement has been met.

Since the WCAG 2.2 definition of "state" needs no word substitutions or interpretation, add the following bullet to the Glossary Items that Apply to All Technologies section.

  • state

@mraccess77
Copy link

Should "user agent or" be added before platform here "An example of appearance modification by the author is content that sets the visual style of a control, such as a color or border, to differ from the default style for the platform."

@maryjom
Copy link
Contributor Author

maryjom commented Mar 20, 2023

@mraccess77 Good point...modified the comment above to add "user agent" to the note.

@maryjom
Copy link
Contributor Author

maryjom commented Mar 30, 2023

Incorporating survey results (which showed a high level of preference for Option 1), comments in the survey, and discussion from the 30 March meeting. The SC guidance itself is stable (from the previous proposal comment, so we are now focusing on the guidance and notes for Appendix A: Success Criteria Problematic for Closed Functionality.


In Appendix A. Success Criteria Problematic for Closed Functionality add the following:

  • 1.4.11 Non-text Contrast—There are cases where applying this Success Criterion to non-web software on closed functionality products is problematic:

    • When the appearance of the content is determined by the hardware and not modifiable by the software author, the non-web software would meet the exception for this Success Criterion.
      NOTE: Hardware requirements for contrast are out of scope for WCAG2ICT (and this Success Criterion), but do exist in other standards' requirements for closed functionality products (e.g. EN 301 549 and Revised 508 Standards).
    • When the color contrast ratio cannot be programmatically measured due to system limitations (e.g. lockdown), precise quantifiable testing of color contrast cannot be performed by a third party. In such cases, the software author would need to confirm that the color combinations used meet the contrast requirement.
      NOTE: Photographs are not sufficient for testing that content meets this Success Criteria. This is because the quality of the lighting, camera, and physical aspects of the hardware display can dramatically affect the ability to capture the content for testing purposes.

@bruce-usab
Copy link
Contributor

bruce-usab commented Apr 5, 2023

As @mitchellevan notes on the list, the 508 approach to contrast for closed hardware is modest. See: 402.4 Characters on Display Screens

… Characters shall contrast with their background with either light characters on a dark background or dark characters on a light background.

Note that 508 does not (at present) have a contrast requirement for non-text content.

I will also note that this contrast requirements is an analog to the requirement under ADA (and ABA) for signage. The Access Board had a "Guide to the Standards" which includes the question, Why isn’t a minimum level of color contrast between characters and the background specified in the Standards?

Color contrast is based on a color’s light reflectance value (LFV), which measures the amount of a light a color reflects or absorbs. It is typically measured using a spectrophotometer. Measuring LFV accurately in the field can be difficult and is impacted by a variety of factors, including sign materials and lighting conditions.

@maryjom
Copy link
Contributor Author

maryjom commented Apr 5, 2023

Adding in Mitchell's comment sent via email to this issue so we can track everything back to this issue.

The draft says 508 and the EN are relevant to hardware but I'm not sure they are relevant to non-text contrast on screens. For example, 508 clause 402.4 only mentions contrast of text.

Also the draft draws too strong a distinction between "programmatic" color and photos. There are other techniques that fall between and are probably precise enough. Example: a game console doesn't provide access to the programmatic color but does support screen shotting. Another example: a TV set top box runs apps, doesn't allow programmatic color measurements or direct screen shotting, but does allow HDMI capture.


@mitchellevan @bruce-usab Yes, it is modest in the hardware requirements at best but I don't think there's any argument that you can't hold the software responsible for the lack of hardware capabilities. And there are testing difficulties for this SC regardless. Maybe you can do a direct screen capture, but if you can't and the color information is not programmatically available, this is a much less testable requirement by a 3rd party. The software author would have to confirm they used whatever methods were available to them to make color choices that provide sufficient contrast.

@maryjom
Copy link
Contributor Author

maryjom commented Apr 6, 2023

In the 6 April meeting the group decided to keep language as-is and merge into editor's draft. The comment about other potential sufficient testing was added to a wiki page where we can keep such things. The group wanted to try to keep away from developing sufficient test techniques as it is considered out of scope. We'll see what the AG WG and public review prove out in this space.

@maryjom
Copy link
Contributor Author

maryjom commented Aug 22, 2023

The TF reached consensus on the guidance for SC 1.4.11 on 6 April. The AG WG reviewed 1.4.11 in the 3rd content review and approved the content on 25 July.

@maryjom maryjom closed this as completed Aug 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

8 participants