facebook / docusaurus

Easy to maintain open source documentation websites.
https://docusaurus.io
MIT License
54.22k stars 8.13k forks source link

Name for table 'Typography' in Fast Frame Design System page is not programmatically defined. #9166

Open msftedad opened 11 months ago

msftedad commented 11 months ago

Have you read the Contributing Guidelines on issues?

Prerequisites

Description

Name for table 'Typography' in Fast Frame Design System page is not programmatically defined.

Screen reader is not announcing the table name as name property is programmatically not defined.

Name property should be defined for table 'Typography' should programmatically defined for the respective table.

User with visual impairment who rely on screen reader will face difficulties if name property is not programmatically defined for the table.

Table name is not defined

Table name is not defined .webm

Reproducible demo

No response

Steps to reproduce

Pre-Requisites: Turn on Narrator.

Repro Steps:

  1. Open https://www.fast.design/ URL.
  2. Navigate to link Documentation and invoke it.
  3. Navigate to 'using the components' link and invoke it.
  4. Navigate to 'Fast Frame Design System' link and invoke it.
  5. Navigate to table 'Typography' in main landmark and listen to screen reader announcement.

Expected behavior

Name property should be defined for table 'Typography' should programmatically defined for the respective table.

Actual behavior

Name property is not programmatically defined for table 'Typography' is not defined in 'Fast Frame Design System' page.

Your environment

Self-service

msftedad commented 6 months ago

Hi @slorber, Any update on this issue?

msftedad commented 5 months ago

Hi @slorber, Any update on this issue?

slorber commented 5 months ago

@msftedad if I don't post comments it's because there are no updates. Unfortunately I can't work on all issues at once and you are not the only one waiting 😅

What do you mean by "table name"? How to achieve better accessibility here?

Are you saying we should use <table name="Typography">? Because it doesn't seem to be

Can you link to an accessibility reference page documenting how to improve accessibility for tables?


Note that we are not responsible for the fast design system documentation. Please use our own site as a reference to illustrate problems in the future (like in your video)

IMHO this is not a bug in Docusaurus and it is more likely an accessibility bug in our website content instead.

We can probably improve accessibility by adding additional table attributes, but then it would only fix our website, and the Fast Design website would have to fix their own tables too.