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

Improve UX with better wording #298

Merged
merged 2 commits into from
Aug 8, 2024
Merged

Improve UX with better wording #298

merged 2 commits into from
Aug 8, 2024

Conversation

daproclaima
Copy link
Collaborator

@daproclaima daproclaima commented Jul 18, 2024

Purpose

Improve UX wording and screen reader navigation

Proposal

  • using more meaningful texts for the mailbox list when no mailbox was created for a mail domain, CTA buttons for groups, and mail domains features
  • removing the pencil icon from text inputs
  • remove icon aria-label from decorative icons
  • add an alt="" and aria-hidden="true" to decorative images and icons

motivation

Screen readers should ignore decorative images. However, if no alt is provided, the image source URL will be read out loud. To have an image ignored by screen readers, it takes setting an alt="" to it.

For the SVG icons to be ignored by screen readers, they need to take an aria-hidden="true". However, even browser testing tools like Playwright will ignore them, even though they possess an aria-label="description". aria-label attributes can hence be removed. To assert their visibility, it takes using visual testing tools such as chromatic.

Closes #276, closes #295, closes #296, closes #303, closes #304

@daproclaima daproclaima added frontend Relative to the frontend noChangeLog labels Jul 18, 2024
@daproclaima daproclaima self-assigned this Jul 18, 2024
@daproclaima daproclaima changed the title Feature/clearer ux Improve UX with better wording Jul 18, 2024
@daproclaima daproclaima changed the base branch from main to feature/a11y-keyboard-navigation July 18, 2024 13:54
@daproclaima daproclaima requested review from lebaudantoine and removed request for lebaudantoine July 18, 2024 13:58
@daproclaima daproclaima linked an issue Jul 18, 2024 that may be closed by this pull request
@daproclaima daproclaima force-pushed the feature/a11y-keyboard-navigation branch from 137f006 to ef4223f Compare July 18, 2024 15:23
Copy link
Collaborator

@lebaudantoine lebaudantoine left a comment

Choose a reason for hiding this comment

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

I might not be the best reviewer for changes related to Styles. However, I did notice a small detail that could be simplified in your props.

@daproclaima daproclaima force-pushed the feature/a11y-keyboard-navigation branch 13 times, most recently from abdfc75 to f1d46b9 Compare July 31, 2024 09:43
@daproclaima daproclaima linked an issue Jul 31, 2024 that may be closed by this pull request
@daproclaima daproclaima force-pushed the feature/clearer-ux branch 5 times, most recently from ef4ec6e to 2f79590 Compare August 6, 2024 12:31
@daproclaima daproclaima requested a review from AntoLC August 6, 2024 13:12
@daproclaima daproclaima force-pushed the feature/clearer-ux branch 5 times, most recently from 3c5d4d3 to c83c85a Compare August 6, 2024 21:52
@daproclaima daproclaima force-pushed the feature/clearer-ux branch 7 times, most recently from a4d7e03 to 04569a8 Compare August 7, 2024 19:44
@daproclaima daproclaima requested review from AntoLC and removed request for manuhabitela August 7, 2024 19:44
@@ -107,7 +107,7 @@ export const MemberGrid = ({ team, currentRole }: MemberGridProps) => {
{currentRole !== Role.MEMBER && (
<Box $margin={{ all: 'big', bottom: 'small' }} $align="flex-end">
<Button
aria-label={t('Add members to the team')}
aria-label={t('Add a member to the team')}
Copy link
Collaborator

Choose a reason for hiding this comment

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

The select to add member is a multi select, you can add more than one members.

- change message showed in mailbox list when none exist
- change CTA button text for group management modals
- fix 404 page title
- update translations
- update related e2e tests
- add aria-hidden and empty alt attributes for screen readers
to ignore decorative svg and images.
- remove icon from input field used to name a group
- update translations
- update related e2e and components tests
@daproclaima daproclaima merged commit 14deca1 into main Aug 8, 2024
15 checks passed
@daproclaima daproclaima deleted the feature/clearer-ux branch August 8, 2024 10:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment