What’s broken?
This issue was identified during the Docs accessibility audit on a page containing table-related content.
Audited page:
https://docs.numerique.gouv.fr/docs/0d998bef-1b69-47ce-bd18-83d4d849c734/
In BlockNote tables, merged cells do not expose clear relationships with their related row and column headers.
When a table contains merged cells, the structure becomes more complex. However, the generated markup does not clearly indicate which headers apply to each merged cell.
There is no reliable id / headers relationship to help assistive technologies understand the table structure.
Because of this, screen readers may not be able to announce the correct header context for merged cells.
What did you expect to happen?
Merged cells should preserve clear relationships with their related table headers.
For complex tables, especially when cells are merged, BlockNote should expose relationships using id and headers.
Example:
<th id="q1">Q1</th>
<th id="north">North</th>
<td headers="north q1">120</td>
Steps to reproduce
- Insert a table using BlockNote.
- Create or use a table with merged cells and row/column headers.
- Inspect the generated table in the DOM.
- Notice that merged cells are not explicitly associated with their related headers:
- no reliable id / headers relationship;
- no clear semantic relationship allowing assistive technologies to identify which headers apply to the merged cell.
BlockNote version
0.51.4
What’s broken?
This issue was identified during the Docs accessibility audit on a page containing table-related content.
Audited page:
https://docs.numerique.gouv.fr/docs/0d998bef-1b69-47ce-bd18-83d4d849c734/
In BlockNote tables, merged cells do not expose clear relationships with their related row and column headers.
When a table contains merged cells, the structure becomes more complex. However, the generated markup does not clearly indicate which headers apply to each merged cell.
There is no reliable
id/headersrelationship to help assistive technologies understand the table structure.Because of this, screen readers may not be able to announce the correct header context for merged cells.
What did you expect to happen?
Merged cells should preserve clear relationships with their related table headers.
For complex tables, especially when cells are merged, BlockNote should expose relationships using
idandheaders.Example:
Steps to reproduce
BlockNote version
0.51.4