Skip to content
Handsontable dev

Migrating from 12.4 to 13.0

Migrate from Handsontable 12.4 to Handsontable 13.0, released on June 22, 2023.

More information about this release can be found in the 13.0.0 release blog post.
For a detailed list of changes in this release, see the Changelog.

Stop using the beforeAutofillInsidePopulate hook

Handsontable 13.0 removes the beforeAutofillInsidePopulate hook, which has been marked as deprecated since Handsontable 9.0.0.

Make sure you’re not using this hook.

Remove direction and deltas from your populateFromArray() calls

The populateFromArray() method no longer accepts direction and deltas arguments, as they were used only by the deprecated beforeAutofillInsidePopulate hook. Make sure that you don’t pass these arguments to populateFromArray().

Change from getFirstNotHiddenIndex() to getNearestNotHiddenIndex()

Handsontable 13.0 removes the getFirstNotHiddenIndex() method, which has been marked as deprecated since Handsontable 12.1.0. Instead , use the new getNearestNotHiddenIndex() method.

For more details, see the API reference:

Before

handsontableInstance.getFirstNotHiddenIndex(0, 1, true, 1);

After

handsontableInstance.getNearestNotHiddenIndex(0, 1, true);

Replace 'insert_row' and 'insert_col' in your alter() calls

The alter() method no longer accepts 'insert_row' and 'insert_col' arguments, which have been marked as deprecated since Handsontable 12.2.0.

You can read more about this change on our blog.

Before

// insert a row above row number 10
handsontableInstance.alter('insert_row', 10);


// insert a column before column number 10
handsontableInstance.alter('insert_col', 10);

After

// insert a row below the last row
handsontableInstance.alter('insert_row_below');


// insert a row above row number 10
handsontableInstance.alter('insert_row_above', 10);


// insert a column after the last column
handsontableInstance.alter('insert_col_end');


// insert a column before column number 10
handsontableInstance.alter('insert_col_start', 10);

The beforeChange hook is now fired before the afterSetDataAtCell and afterSetDataAtRowProp hooks

Handsontable 13.0 changes the order of execution for the following hooks:

For more details on this change, see this pull request: #10231.

Before

Up to Handsontable 12.4, the hooks were fired in the following order:

  1. afterSetDataAtCell or afterSetDataAtRowProp
  2. beforeChange

After

Since Handsontable 13.0, the hooks are fired in the following order:

  1. beforeChange
  2. afterSetDataAtCell or afterSetDataAtRowProp