syy / reactabular

Spectacular tables for React.js (MIT)

Reactabular - Spectacular tables for React.js

Reactabular has been designed to be extensible. Rather than implementing a lot of functionality in its core, it provides extension points. You can, for instance, customize rendering on cell level. It is possible to implement functionality, such as search, pagination, sorting, and inline editing, through composition. The library includes a variety of utilities for this even though you may use third party ones as well.

By default Reactabular operates using a column and a data definition. It doesn't care where those come from. It just renders the table for you. This means Reactabular will fit right into your current data architecture. It doesn't constrain it in any manner.

The chosen approach pushes a lot of complexity out of the core. As a result it might take more code to achieve certain functionalities. This is the price of flexibility. And that's the primary design goal of Reactabular.

If you want to learn more about React, read SurviveJS - Webpack and React.

Documentation

• Table Definition
• Sorting a Table
• Searching a Table
• Styling a Table
• Paginating a Table
• Inline Editing a Table
• Customizing Cells
• Customizing Footer
• Customizing Header
• Customizing Rows

Development

npm install
npm start
open http://localhost:8080

Now edit demos/app.js.

Your changes will appear without reloading the browser like in this video.

Contributors

• Brian Chang - Fixed README formatting examples. Improved column.cell architecture. Helped to improve and design cell API.
• Antoine Verger - Allow editor text inputs to be erased correctly
• Daan Nijkamp - Fixed README search example.
• Utku Demir - Helped to ideate row API.
• Andrea de la Isla - Made search algorithm stable and allowed header to be customized.
• cameron - Helped to render nested properties through cells.
• Igor Kaplounenko - Allowed rowKey to be set.
• BJR Matos - Restored Node 0.10 support.
• Sitian Liu - Fixed header definition documentation.
• Eugene Cheung - Fixed object protocol example at documentation.
• Johnson Liang - Cleaned up cell prop/value merging and made it work correctly if only cell functions are provided. Fixed formatter logic for falsy values. Fixed cell data sharing issue related to nesting (#129).
• Jeff Sanchez - Added support for multi-column sorting.
• Frederic Heem - Relaxed lodash version range.
• Trevor Rundell - Don't attempt to merge table cell values.
• Dan Callahan - Use specific methods from lodash + upgrade to lodash 4.0.
• devaublanc - Fixed syntax at sorting documentation.
• Christopher Dieringer - Improved sorting documentation.
• szdc - Added support for multiple search filters.

Acknowledgments

Based on react-hot-boilerplate (MIT) by Dan Abramov.

License

MIT. See LICENSE for details.