Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  1. Components
  2. Table
  3. Accessibility
  4. Alignment Accessibility

Table

Alignment Accessibility

Alignment Accessibility

Cell alignment doesn't affect accessibility.

  • Alignment affects visual presentation only
  • Screen readers announce content regardless of alignment
  • Accessibility is maintained across alignments

Empty State Accessibility

Empty states are communicated clearly.

  • Empty state message is announced
  • Screen readers inform users table is empty
  • Message provides context

Responsive Accessibility

Tables remain accessible on different screen sizes.

Horizontal Scrolling

Horizontal scrolling is accessible.

  • Keyboard users can scroll horizontally
  • Focus indicators remain visible
  • Table structure is maintained when scrolling

Mobile Considerations

Ensure tables work on mobile devices.

  • Tables scroll horizontally on small screens
  • Touch targets meet minimum size requirements
  • Content remains accessible

Testing with Screen Readers

Test tables with screen readers for proper announcements.

Expected Announcements

Expected sequence:

  1. Table encountered: "Table with 2 columns and 1 row"
  2. Navigate to first header: "Name, column header"
  3. Navigate to second header: "Status, column header"
  4. Navigate to first data cell: "Item 1, row header, Name column"
  5. Navigate to second data cell: "Active, Status column"

Complex Table

Expected announcements handle colspan correctly, associating merged header with both data columns.

Best Practices Summary

Ensure table accessibility by:

  • Using proper cell types (ColumnHeader, RowHeader)
  • Providing descriptive column headers
  • Using row headers when appropriate
  • Maintaining consistent table structure
  • Ensuring sufficient color contrast
  • Supporting keyboard navigation
  • Testing with screen readers
  • Handling empty states clearly
  • Making tables responsive
  • Keeping tables simple and understandable

Previous

Accessibility / Complex Cell Content

Next

Tabs / Usage

On this page

Alignment Accessibility
Empty State Accessibility
Responsive Accessibility
Horizontal Scrolling
Mobile Considerations
Testing with Screen Readers
Expected Announcements
Complex Table
Best Practices Summary