TanStack Table

Headless UI for building powerful tables & datagrids for TS/JS - React-Tab...

README

TanStack Table Header

TanStack Table v8


Headless UI for building powerful tables & datagrids for React, Solid, Vue, Svelte and TS/JS.

#TanStack semantic-release Join the discussion on Github

[Looking for version 7 of react-table? Click here!](https://github.com/tanstack/table/tree/v7)


Enjoy this library?



Visit tanstack.com/table for docs, guides, API and more!


You may know TanStack Table by our adapter names, too!


Summary


TanStack Table is a headless table library, which means it does not ship with components, markup or styles. This means that you have full control over markup and styles (CSS, CSS-in-JS, UI Component Libraries, etc) and this is also what gives it its portable nature. You can even use it in React Native!

If you want a lightweight table with full control over markup and implementation, then you should consider using TanStack Table, a headless table library.

If you want a ready-to-use component-based table with more power but more constraints around markup/styles/implementation, you should consider using AG Grid, a component-based table library from our OSS partner AG Grid.

TanStack Table and AG Grid are respectfully the
best table/datagrid libraries around. Instead
of competing, we're working together to ensure the highest
quality table/datagrid options are available for the entire
JS/TS ecosystem and every use-case.

Quick Features


- Agnostic core (JS/TS)
- 1st-class framework bindings for React, Vue, Solid
- ~14kb or less (with tree-shaking)
- 100% TypeScript (but not required)
- Headless (100% customizable, Bring-your-own-UI)
- Auto out of the box, opt-in controllable state
- Filters (column and global)
- Sorting (multi-column, multi-directional)
- Grouping & Aggregation
- Pivoting (coming soon!)
- Row Selection
- Row Expansion
- Column Visibility/Ordering/Pinning/Resizing
- Table Splitting
- Animatable
- Virtualizable
- Server-side/external data model support

Migrating from React Table v7


Notable Changes


- Full rewrite to TypeScript
- Removal of plugin system to favor more inversion of control
- Vastly larger and improved API
- Better controlled state management
- Better support for server-side operations
- Complete (but optional) data pipeline control
- Agnostic Core
- Framework Adapters

Migration


There are a fair amount of breaking changes (they're worth it, trust us!):

- Turns out that TypeScript makes your code a lot better/safer, but also usually requires breaking changes to architecture.
- Plugin system has been removed so plugins must be rewritten to wrap/compose the new functional API. Contact us if you need help!
- Column configuration options have changed, but only slightly.
- Table options are mostly the same, with some larger changes around optional state management/control and data pipeline control
- The tableInstance while similar in spirit to v7 has been reconfigured to be much faster.

Todo (in order of priority)


- [x] Rewrite Core
  - [x] Core
  - [x] Columns
  - [x] Headers
  - [x] Visibility
  - [x] Pinning
  - [x] Filters
  - [x] Sorting
  - [x] Grouping
  - [x] Expanding
  - [x] Column Sizing
  - [x] Pagination
  - [x] Row Selection
- [ ] Migrate Examples
  - [x] column-visibility
  - [x] column-ordering
  - [x] column-pinning
  - [x] basic
  - [x] filters
  - [x] sorting
  - [x] pagination
  - [x] pagination-controlled
  - [x] column-sizing
  - [x] row-selection
  - [x] expanding
  - [x] grouping-and-aggregation
  - [x] editable-data
  - [ ] kitchen-sink
  - [x] row-dnd
  - [ ] streaming-rows
  - [x] sub-components
  - [x] virtualized-rows
  - [ ] absolute-layout
  - [ ] block-layout
  - [ ] animated-framer-motion
  - [x] bootstrap
  - [ ] bootstrap-ui-components
  - [ ] data-driven-classes-and-styles
  - [x] full-width-resizable-table
  - [x] full-width-table
  - [ ] material-ui-components
  - [ ] material-UI-enhanced-table

Installation


  1. ``` sh
  2. # Npm
  3. npm install @tanstack/react-table
  4. npm install @tanstack/solid-table
  5. npm install @tanstack/vue-table
  6. npm install @tanstack/svelte-table

  7. #pnpm
  8. pnpm install @tanstack/react-table
  9. pnpm install @tanstack/solid-table
  10. pnpm install @tanstack/vue-table
  11. pnpm install @tanstack/svelte-table

  12. #Yarn
  13. yarn add @tanstack/react-table
  14. yarn add @tanstack/solid-table
  15. yarn add @tanstack/vue-table
  16. yarn add @tanstack/svelte-table
  17. ```

How to help?


- Try out the already-migrated examples
- Try it out in your own projects.
- Introspect the types! Even without the docs finished, the library ships with 100% typescript to help you explore its capabilities.
- Write some docs! Start with the API docs and try adding some information about one or more of the features. The types do a decent job of showing what's supported and the capabilities of the library.
- Try your hand at migrating an example to v8! The todo list for the examples is above!
- Using a plugin? Try rewriting your plugin (v8 doesn't have a plugin system any more) as a functional wrapper that uses TanStack Table internally. The new API is much more powerful and easier to compose. If you find something you can't figure out, let us know and we'll add it to the API.