:warning: This package is deprecated.

Handsontable Pro for React is now available as @handsontable/react.

---

Handsontable Pro for React is the official wrapper for Handsontable Pro, a commercial data grid component with a spreadsheet look & feel. It easily integrates with any data source and comes with lots of useful features like data binding, validation, sorting or powerful context menu.

Table of contents

1. Installation
2. Getting Started
3. Documentation
4. What to use it for?
5. Features
6. Screenshot
7. Resources
8. License Key
9. Support
10. Contributing
11. License and Pricing

Installation

Use npm to download the project.

1npm install handsontable-pro @handsontable-pro/react

Getting Started

Assuming that you have installed the wrapper with npm, now you just need to include Handsontable styles into your build system and use <HotTable> just like any other React component.

Styles

1@import 'handsontable-pro/dist/handsontable.full.css';

React Component

1import React from 'react';
2import ReactDOM from 'react-dom';
3import { HotTable } from '@handsontable-pro/react';
4
5class HotApp extends React.Component {
6  constructor(props) {
7    super(props);
8    this.data = [
9      ["", "Ford", "Volvo", "Toyota", "Honda"],
10      ["2016", 10, 11, 12, 13],
11      ["2017", 20, 11, 14, 13],
12      ["2018", 30, 15, 12, 13]
13    ];
14  }
15
16  render() {
17    return (
18      <div id="hot-app">
19        <HotTable data={this.data} colHeaders={true} rowHeaders={true} width="600" height="300" stretchH="all" />
20      </div>
21    );
22  }
23}

Documentation

Visit docs.handsontable.com to get more Handsontable for React examples and guides.

What to use it for?

The list below gives a rough idea on what you can do with Handsontable Pro, but it shouldn't limit you in any way:

• Database editing
• Configuration controlling
• Data merging
• Team scheduling
• Sales reporting
• Financial analysis

Features

Some of the most popular features include:

• Filtering data (Pro)
• Nested headers (Pro)
• Export to file (Pro)
• Column summary (Pro)
• Sorting data
• Data validation
• Conditional formatting
• Context menu
• Adding comments to cells
• Dragging fill handle to populate data
• Internationalization
• Non-contiguous selection

Screenshot

Resources

• Guides
• API Reference
• Release notes
• Roadmap
• Twitter

License Key

After you buy the license for Handsontable Pro, you should receive a license key of your copy of the software. It will be available in your account at my.handsontable.com.

Paste your license key to the configuration section, just like in the example below.

1const settings = {
2  data: data,
3  rowHeaders: true,
4  colHeaders: true,
5  licenseKey: '00000-00000-00000-00000-00000'
6};

Note that the license key is passed as a string so you need to wrap it in quotes ('').

Support

If you have a valid license of Handsontable Pro then your primary contact is through support team at support@handsontable.com

You can also report your issues here on GitHub.

Contributing

If you would like to help us to develop this wrapper for React, please read the guide for contributors first.

License and Pricing

This wrapper is released under the MIT license but under the hood it uses Handsontable Pro, which is a commercial and paid software. You need to purchase a license in order to use it in production environment.

Copyrights belong to Handsoncode sp. z o.o.