Tables

[ianwremmel]

• Adds basic table primitives
• Provides a typesafe JSX interface for configuring how table data renders

Storybook

Design Goals

• typesafety: it should not be possible to reference a field that is not a member of the source type
• index safety: A single tag should configure both the column header and the column data so that there's never risk of misaligning columns

TODO

Features

• basic table primitives
• limited rendering config
• add an id column so we can avoid using the row index as a key; default it to 'id'
• sorting - side effect of full config?
• attempt to match react-table's config
• filtering? - side effect of full config?
• customize header rendering
• customize cell rendering
• customize row rendering
• Vertical tables?
• gracefully handle loading states
  • initial loading state where there's no data
  • page/filter/sort transitions
• loading state? - these are eventually intended for graphql, so it may make sense for them to do "the right thing" when data is either undefined or an explicit loading=true is passed. on the other hand, it may make sense for the parent element to deal with showing a loader, showing a pager, etc.

Docs

• organize storybook
• Write some freeform docs

Bugs

• There's a rogue pre tag
• Naming isn't great. There are some words that get used pretty heavily (e.g. "Column"), so I probably need to come up with some specific rules on terminology and the apply them aggressively. Further, we should move towards a preference for "Field" so that, eventually, DataTable, DescriptionList, and even Form could have a common interface.