Skip to content

merged table cells do not expose clear header relationships #2826

@Ovgodd

Description

@Ovgodd

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-triageIssue has not yet been reviewed or classified by maintainers.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions