Add Practice Page for Supporting High Contrast

[mcking65]

Part of the resolution of issue #2864.

Preview Link

Preview high contrast practice page in compare branch

---

WAI Preview Link (Last built on Thu, 12 Dec 2024 07:31:23 GMT).

[jongund]

@mcking65
This is ready for review, I think it would be great if James Nurthen could review it.

[jongund]

Can someone run the prettier code on the CSS to get rid of the CSS linting errors

[howard-e]

Can someone run the prettier code on the CSS to get rid of the CSS linting errors

Done in 5720724

[adampage]

This reference will be very helpful to many people! 🤩

[adampage]

I’m not seeing any change to the page when I toggle either the Increase Contrast or Dark Color Scheme switches. Are those meant to immediately show a simulated effect?

[jongund]

Yes, there are suppose to change.
It may be there should be a separate switch to tun on the emulation next to the example.

[jongund]

@adampage
Maybe I should take out the emulation, and people rely on seeing the cahnges when the change their contrast settings, I will do that.

[jongund]

@adampage
I have updated the examples to only use the CSS media queries to change the rendering. My original way is confusing. Please review and let me know if it makes more sense now.

[adampage]

Thanks @jongund, this is clearer. However, because the examples themselves are toggle switches, I wonder if it might still invite a bit of confusion for some readers since the concepts of dark mode and high contrast are so often expressed as interactive toggles. 😅

If the examples were just some static rich text, like a heading, a paragraph, and some sort of colored embellishment (like a blockquote or bulleted list), then I think they would be crystal clear — especially for the users who accept our invitation to enable their own device settings to observe the reaction.

[css-meeting-bot]

The ARIA Authoring Practices (APG) Task Force just discussed PR 2991 - Practice Page for Supporting High Contrast.

The full IRC log of that discussion

<jugglinmike> Topic: PR 2991 - Practice Page for Supporting High Contrast
<jugglinmike> github: https://github.com//pull/2991
<jugglinmike> Matt_King: Thank you for all the commits last Tuesday, jongund!
<jugglinmike> Matt_King: All the checks are passing
<jugglinmike> Matt_King: We requested review from three people. None of those reviews are in, yet
<jugglinmike> Adam_Page: I reviewed and requested changes just a few minutes ago
<jugglinmike> Jem: I plan to review after this meeting
<jugglinmike> Matt_King: I think this depends on the nature of the feedback. I personally haven't spent the time on this that I planned on spending
<jugglinmike> Matt_King: I'd like to commit to a specific time for making a merge decision on this pull request (to determine whether it will be included in tomorrow's release)
<jugglinmike> Jem: (I wish that our Task Force had a way to announce a new release. This patch is a good candidate to highlight publicly.)
<jugglinmike> Matt_King: I'd love to talk about that. We can add a topic to today's agenda
<jugglinmike> s/I wish/By the way, I wish/
<jugglinmike> Matt_King: If we make the decision at 1PM PT, then will that give you enough time to release, howard-e?
<jugglinmike> howard-e: Yes, I'm in eastern standard time. It will be 4PM for me, and that works
<dmontalvo> present- dmontalvo
<jugglinmike> Jem: I reviewed this a long time ago. Is there any specific aspect that I need to focus on as a reviewer?
<jugglinmike> Matt_King: This is the final review. Clarity, style, relevance of information. We want to make sure that the guidance we're giving is useful and actionable by our readers. It's got to be consistent with what we want in the APG but also something that authors can actually use in practice
<jugglinmike> Matt_King: More and more, I want to make sure we aren't stepping outside of our bounds. We shouldn't be trying to take the place of other important W3C resources. We should simply refer to those and remain focused on the APG's mission
<jugglinmike> Matt_King: If we can get this merged by 1:00 tomorrow, we would like to include it in the next release. There are a lot of unknowns, though, and that includes me (i.e. whether I can fit it in among my other deadlines)
<jugglinmike> howard-e: For what it's worth, I can wait as late as 2:30 PM PST
<jugglinmike> Matt_King: Thank you, howard-e! Given my meeting schedule, that extra time might be really helpful
<jugglinmike> Adam_Page: I have some additional thoughts about dark mode
<jugglinmike> Matt_King: I think we're looking for minimum-viable product here. We can always enhance later
<jugglinmike> Adam_Page: Yeah, that makes sense