Skip to content

Conversation

@Ovgodd
Copy link
Collaborator

@Ovgodd Ovgodd commented Nov 18, 2025

Purpose

Improve accessibility in the DocShare modal by enhancing screen reader support.

this fix this issue too

Proposal

  • Add ariaLabel prop to DocRoleDropdown for contextual role change labels
  • Inject ariaLabel in DocShareAccessRequest, Invitation, and Member items
  • Implement live screen reader announcements in DocShareModal for:
    • Adding a user to the invite list
    • Removing a user from the invite list

@Ovgodd Ovgodd self-assigned this Nov 18, 2025
@Ovgodd Ovgodd requested a review from AntoLC November 18, 2025 15:33
@Ovgodd Ovgodd force-pushed the fix/a11y-improve-doc-share-sr branch from f0a76cc to b3e403d Compare November 18, 2025 15:33
@Ovgodd Ovgodd linked an issue Nov 18, 2025 that may be closed by this pull request
@Ovgodd Ovgodd force-pushed the fix/a11y-improve-doc-share-sr branch 3 times, most recently from a82b0a3 to 5d6ade1 Compare November 18, 2025 15:40
@Ovgodd Ovgodd marked this pull request as ready for review November 18, 2025 15:41
@github-actions
Copy link

github-actions bot commented Nov 18, 2025

Size Change: +231 B (+0.01%)

Total Size: 4.07 MB

Filename Size Change
apps/impress/out/_next/static/16110de7/_buildManifest.js 0 B -885 B (removed) 🏆
apps/impress/out/_next/static/63d769b2/_buildManifest.js 882 B +882 B (new file) 🆕

compressed-size-action

@Ovgodd Ovgodd force-pushed the fix/a11y-improve-doc-share-sr branch 2 times, most recently from 9f5ed00 to 1a5281b Compare November 18, 2025 16:26
Comment on lines 215 to 222
style={{
position: 'absolute',
left: '-10000px',
width: '1px',
height: '1px',
overflow: 'hidden',
}}
>
Copy link
Collaborator

Choose a reason for hiding this comment

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

The style attach with sr-only is not enough ?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

oh yes, why I did that.

Comment on lines +93 to 105
// Announce to screen readers
const userName = user.full_name || user.email;
setLiveAnnouncement(
t(
'{{name}} added to invite list. Add more members or press Tab to select role and invite.',
{
name: userName,
},
),
);
// Clear announcement after it's been read
setTimeout(() => setLiveAnnouncement(''), 100);
};
Copy link
Collaborator

Choose a reason for hiding this comment

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

I find a bit strange to do the announcement, we have a notification system, but I think we decided to not display a notification for that, because the invitation list will display the user that you just add, it is already like a announcement.

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 a bit strange to do the announcement, we have a notification system, but I think we decided to not display a notification for that, because the invitation list will display the user that you just add, it is already like a announcement.

Hey ! the SR announcement is necessary for RGAA compliance. Users with visual "issues"cannot see the visual feedback when a user is added to the invite list. The aria-live region provides audio feedback only (no visual toast, this is a standard accessibility requirement

CHANGELOG.md Outdated
- ♿(frontend) improve ARIA in doc grid and editor for a11y #1519
- ♿(frontend) improve accessibility and styling of summary table #1528
- ♿(frontend) add focus trap and enter key support to remove doc modal #1531
- ♿(frontend) improve screen reader support in DocShare modal #1628
Copy link
Collaborator

Choose a reason for hiding this comment

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

During rebase, this part will have to go under Unrelease

@Ovgodd Ovgodd force-pushed the fix/a11y-improve-doc-share-sr branch from 68c85bf to 0577a34 Compare November 24, 2025 09:00
@Ovgodd Ovgodd requested a review from AntoLC November 24, 2025 09:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

A11y: Localize aria-label in DocRoleDropdown

3 participants