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

accessibility updates #2618

Merged
merged 13 commits into from
Oct 29, 2020
Merged

accessibility updates #2618

merged 13 commits into from
Oct 29, 2020

Conversation

thetif
Copy link
Contributor

@thetif thetif commented Oct 28, 2020

Fixes the first 3 issues in #2607

This pull request changes...

  • skip link should be visible and working
  • changed the way primary key personnel were added so there will not be an empty 1. header
  • change the arial labels for the previous/continue buttons so they specified Previous or Continue and then said where it was going

This pull request is ready to merge when...

  • Tests have been updated (and all tests are passing)
  • This code has been reviewed by someone other than the original author
  • The experience passes a basic manual accessibility audit (keyboard nav, screenreader, text scaling) OR an exemption is documented
    - [ ] The change has been documented
    - [ ] Associated OpenAPI documentation has been updated
  • Changelog is updated as appropriate

This feature is done when...

  • Design has approved the experience
  • Product has approved the experience

@thetif thetif requested review from radavis, beparticular, CSwartzHMA, jeromeleecms and tbolt and removed request for CSwartzHMA October 28, 2020 19:07
@cms-eapd-bot
Copy link

cms-eapd-bot commented Oct 28, 2020

This deploy was cleaned up.

Copy link
Contributor

@jeromeleecms jeromeleecms left a comment

Choose a reason for hiding this comment

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

  1. "Agree and Continue Screen" The skip link popup appears, but it doesn't take me anywhere. Shouldn't this take me to the "Agree and Continue Button?"
  2. "Login Form" The skip link popup appears, but it takes me to a nebulous area where tabbing / back tabbing takes me back to browser address window. Where should I expect for it to take me? Screen reader just reads the entire form.
  3. "Dashboard" The skip link popup appears and takes me to the main header page (screen reader starts as intended)
  4. "APD Builder Page" The skip link pop appears, and it takes me to the top of the builder.

Will put a hold on the rest of this review per Dev team.

@thetif
Copy link
Contributor Author

thetif commented Oct 28, 2020

tried to resolve these issues, can you try it again?

Copy link
Contributor

@tbolt tbolt left a comment

Choose a reason for hiding this comment

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

These updates look good. The skip nav behavior is baffling as it is inconsistent across browsers / operating systems.

For the Key Personnel, I believe the "Edit / Remove" needs to be associated with the person added. I can understand if that needs to be part of a larger design update though

);

const previousComponent = !previousLink ? null : (
<Link
aria-labelledby={previousLabelId}
aria-label={`Previous to ${previousText}`}
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this should be OK but im curious if @beparticular has any thoughts on this language.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@beparticular suggested relabeling the button to Back instead of Previous

<UpgradeBrowser />
<CardForm
id="start-main-content"
Copy link
Contributor

Choose a reason for hiding this comment

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

Another option is to have the <main> wrap the <CardForm>. I can understand why we wouldn't want to consider the upgrade browser warning as part of the main content though.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yeah that was my thinking, do you think it's better to wrap the whole page?

Copy link
Contributor

@tbolt tbolt Oct 29, 2020

Choose a reason for hiding this comment

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

From https://developer.mozilla.org/en-US/docs/Web/HTML/Element/main

The HTML <main> element represents the dominant content of the of a document. The main content area consists of content that is directly related to or expands upon the central topic of a document, or the central functionality of an application.

The content of a <main> element should be unique to the document. Content that is repeated across a set of documents or document sections such as sidebars, navigation links, copyright information, site logos, and search forms shouldn't be included unless the search form is the main function of the page.

I think wrapping the whole page (except the navigation in this case) makes sense.

height: 3rem;
line-height: 3rem;
padding: 0 0.5rem;
padding: 1rem;
width: fit-content;
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure if this would have an impact but IE doesn't support fit-content

Copy link
Contributor Author

Choose a reason for hiding this comment

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

it doesn't really work anyway

Copy link

@rohitpaul rohitpaul left a comment

Choose a reason for hiding this comment

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

Tested in Safari and Chrome.
Skip link visible.
Key Personal - Not blank to start off.
Continue Button and Previous Button - text is called out.

@thetif thetif requested review from beparticular and removed request for beparticular October 29, 2020 20:59
Copy link
Contributor

@jeromeleecms jeromeleecms left a comment

Choose a reason for hiding this comment

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

The skip link thing is still a mystery to me, I do the same thing but sometimes it behaves differently.. I'm going to say this is good to go and see what our 508 team comes up with as well.

@thetif thetif merged commit 361bc6f into master Oct 29, 2020
@thetif thetif deleted the tforkner/2607-accessibility-updates branch October 29, 2020 21:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants