terra-html-table UX Audit

[ryanthemanuel]

terra-html-table

Known Aliases

Document any known aliases of the component, decide if another name makes more sense.

• Has known aliases
• Requires name change

Design Standard Doc

Any documentation needed to be added to terra-ui describing the make up and usage of the component
Any doc examples that need to be updated?

• Missing design standard documentation linkage.

Guides

Any guides needed to be added to terra-ui describing the usage of this component when used with other components.

• Missing Guides
  • Examples could be more realistic
• Missing UX recommended Usage.
• Deprecation guide

Accessibility Guides

• Missing Accessibility Guides
  • Missing a guide for table summary and table caption
  • Missing guides for things like row headers (https://www.w3.org/WAI/tutorials/tables/two-headers/) and other concepts here (https://www.w3.org/WAI/tutorials/tables/)

Behaviours

• Missing behaviours
• Contains bad practice behaviours that should be removed

Accessibility

• Meets wcag 2.0/section 508 standards
  • Missing table summary (needs to be required) and table caption. You can pass it through as a custom attribute but it should be face up to encourage teams to use it properly
• Meets wcag 2.1/en 301 549 standards

Deprecation

• Component is a bad pattern and should be deprecated.

Related Issues

Other Considerations

We should try and group this with Table somehow and provide a top level About document that describes when you would use either Table or HTML Table.