terra-list UX Audit

[ryanthemanuel]

terra-list

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
  • We should update to more realistic examples
  • Add a guide for what to do if there are multiple selectable areas inside of a list item
• Missing UX recommended Usage.
• Deprecation guide

Accessibility Guides

• Missing Accessibility Guides

Behaviours

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

Accessibility

• Meets wcag 2.0/section 508 standards
  • Need to add item x of y helpers to identify which number in the list the item is.
  • The lack of nested lists may create a problem. We should revisit it.
  • Arrow navigation inside of the list instead of tabbing
• Meets wcag 2.1/en 301 549 standards

Deprecation

• Component is a bad pattern and should be deprecated.

Related Issues

Other Considerations

Look at combining the headers into their corresponding components.