Create accessible complex tables in HTML5 forms create-accessible-complex-tables-in-html-forms

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

The default implementation of tables in HTML5 Forms uses HTML DIV elements to render a table. Rendering involves using ARIA roles to satisfy the accessibility requirements.

To avoid accessibility issues with screen-readers which do not fully support the ARIA-roles used with data-tables, HTML5 Forms provides an alternate rendition for the tables. These tables are based on the new table format introduced in Designer which also supports:

  • Row Headers
  • Row-span

To use the new format in HTML5 Forms, mark the table as complex. To mark the table as complex, add extras tag in the XML source of table subform as follows:

</extras>
 <text name="complexTable">1</text>
 </extras>

The tables which are marked as complexTable follow the native HTML rendition, and provide better accessibility support for certain screen readers. To create a row span, select consecutive cells of a table in the same column, right-click on the selection, and then click Merge Cells.

Note: Creating a row-span works for leftmost cells only.

To mark a row as row header, select all cells in the row, right-click on the selection, and then click Mark Header.

To mark a cell as column header, select any cell in the column, right-click on the selection, and then click Mark Header.

Limitations in new AccessibleTable format:

  • Lack of support for grow-able fields if rowspan is used in the table
  • No support for nested tables (tables within table cells)
  • Support for rowspan is limited to the header rows and header cells
  • Support is limited to regular tables
  • No support for data prefills in tables with rowspan > 1
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da