Tables and lists

Ensure tables and lists are accessible.

Follow these recommendations to improve the accessibility of tabular and list data:

  1. <dl>’s contain only properly-ordered <dt> and <dd> groups, <script>,

  2. Definition list items are wrapped in <dl> elements: Definition list items (<dt> and <dd>) must be wrapped in a parent <dl> element to ensure that screen readers can properly announce them.

  3. Lists contain only <li> elements and script supporting elements (<script> and <template>): Screen readers have a specific way of announcing lists. Ensuring proper list structure aids screen reader output.

  4. List items (<li>) are contained within <ul>, <ol> or <menu> parent elements: Screen readers require list items (<li>) to be contained within a parent <ul>, <ol> or <menu> to be announced properly.

  5. Tables have different content in the summary attribute and <caption>: The summary attribute should describe the table structure, while <caption> should have the onscreen title. Accurate table mark-up helps users of screen readers.

  6. Cells in a <table> element that use the [headers] attribute refer to table cells within the same table: Screen readers have features to make navigating tables easier. Ensuring <td> cells using the [headers] attribute only refer to other cells in the same table may improve the experience for screen reader users.

  7. <th> elements and elements with [role="columnheader"/"rowheader"] have data cells they describe: Screen readers have features to make navigating tables easier. Ensuring table headers always refer to some set of cells may improve the experience for screen reader users.

Related

Topics

On this page

Supporters

Thank you to these organizations for supporting Project ScanGov:

ScanGov

Government. Digital. Experience.

Get ScanGov