Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/handsontable/react-handsontable
React Data Grid with Spreadsheet Look & Feel. Official React wrapper for Handsontable.
https://github.com/handsontable/react-handsontable
data-grid data-table dynamic-table excel grid grid-editor handsontable react reactjs spreadsheet table
Last synced: 3 months ago
JSON representation
React Data Grid with Spreadsheet Look & Feel. Official React wrapper for Handsontable.
- Host: GitHub
- URL: https://github.com/handsontable/react-handsontable
- Owner: handsontable
- License: mit
- Archived: true
- Created: 2016-11-30T14:14:11.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-03-16T11:32:19.000Z (over 3 years ago)
- Last Synced: 2024-04-14T11:53:48.045Z (8 months ago)
- Topics: data-grid, data-table, dynamic-table, excel, grid, grid-editor, handsontable, react, reactjs, spreadsheet, table
- Language: TypeScript
- Homepage: https://handsontable.com/docs/react
- Size: 2.04 MB
- Stars: 516
- Watchers: 23
- Forks: 84
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Important information
## We permanently moved this project to the main Handsontable repository at [https://github.com/handsontable/handsontable/tree/master/wrappers/react](https://github.com/handsontable/handsontable/tree/master/wrappers/react)
## It is still available under the same name in npm: [`@handsontable/react`](https://www.npmjs.com/package/@handsontable/react), so you don't have to update your dependency configuration.
---------
This is the official wrapper of [**Handsontable**](//github.com/handsontable/handsontable) data grid for React.
It provides data binding, data validation, filtering, sorting and more.
[](//npmjs.com/package/@handsontable/react)
[](//npmjs.com/package/@handsontable/react)
[](//travis-ci.org/handsontable/react-handsontable)
## Installation
Use npm to install this wrapper together with Handsontable.
```
npm install handsontable @handsontable/react
```
You can load it directly from [jsDelivr](//jsdelivr.com/package/npm/@handsontable/react) as well.
```html
```
The component will be available as `Handsontable.react.HotTable`.
## Usage
Use this data grid as you would any other component in your application. [Options](//handsontable.com/docs/Options.html) can be set as `HotTable` props.
**Styles**
```css
@import '~handsontable/dist/handsontable.full.css';
```
**React Component**
```js
import React from 'react';
import ReactDOM from 'react-dom';
import { HotTable } from '@handsontable/react';
class HotApp extends React.Component {
constructor(props) {
super(props);
this.data = [
['', 'Tesla', 'Mercedes', 'Toyota', 'Volvo'],
['2019', 10, 11, 12, 13],
['2020', 20, 11, 14, 13],
['2021', 30, 15, 12, 13]
];
}
render() {
return ();
}
}
```
##### [See the live demo](//handsontable.com/docs/frameworks-wrapper-for-react-simple-examples.html)
## Features
A list of some of the most popular features:
- Multiple column sorting
- Non-contiguous selection
- Filtering data
- Export to file
- Validating data
- Conditional formatting
- Merging cells
- Custom cell types
- Freezing rows/columns
- Moving rows/columns
- Resizing rows/columns
- Hiding rows/columns
- Context menu
- Comments
- Auto-fill option
## Documentation
- [Developer guides](//handsontable.com/docs/react)
- [API Reference](//handsontable.com/docs/Core.html)
- [Release notes](//handsontable.com/docs/tutorial-release-notes.html)
- [Twitter](//twitter.com/handsontable) (News and updates)
## Support and contribution
We provide support for all users through [GitHub issues](//github.com/handsontable/react-handsontable/issues). If you have a commercial license then you can add a new ticket through the [contact form](//handsontable.com/contact?category=technical_support).
If you would like to contribute to this project, make sure you first read the [guide for contributors](//github.com/handsontable/react-handsontable/blob/master/CONTRIBUTING.md).
## Browser compatibility
Handsontable is compatible with modern browsers such as Chrome, Firefox, Safari, Opera, and Edge. It also supports Internet Explorer 9 to 11 but with limited performance.
## License
This wrapper is released under [the MIT license](//github.com/handsontable/react-handsontable/blob/master/LICENSE) but under the hood it uses [Handsontable](//github.com/handsontable/handsontable), which is dual-licensed. You can either use it for free in all your non-commercial projects or purchase a commercial license.
Free license
Paid license
For non-commercial purposes such as teaching, academic research, personal experimentation, and evaluating on development and testing servers.
For all commercial purposes
All features are available
All features are available
Community support
Dedicated support
Read the license
See plans
## License key
**The license key is obligatory since [Handsontable 7.0.0](//github.com/handsontable/handsontable/releases/tag/7.0.0) (released in March 2019).**
If you use Handsontable for purposes not intended toward monetary compensation such as, but not limited to, teaching, academic research, evaluation, testing and experimentation, pass a phrase `'non-commercial-and-evaluation'`, as presented below.
You can pass it in the `settings` object:
```js
settings: {
data: data,
rowHeaders: true,
colHeaders: true,
licenseKey: 'non-commercial-and-evaluation'
}
```
Alternatively, you can pass it to a `licenseKey` prop:
```jsx
```
If, on the other hand, you use Handsontable in a project that supports your commercial activity, then you must purchase the license key at [handsontable.com](//handsontable.com/pricing).
The license key is validated in an offline mode. No connection is made to any server. [Learn more](//handsontable.com/docs/tutorial-license-key.html) about how it works.
Created by [Handsoncode](//handsoncode.net) with ❤ and ☕ in [Tricity](//en.wikipedia.org/wiki/Tricity,_Poland).