Skip to content
Handsontable dev

Migrating from 9.0 to 10.0

Migrate from Handsontable 9.0 to Handsontable 10.0, released on September 29, 2021.

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

  1. Rename your Handsontable hooks

    If you use the beforeRender or afterRender Handsontable hooks, update their names in your app (#8632).

    BeforeAfter
    beforeRenderbeforeViewRender
    afterRenderafterViewRender

    There are still Handsontable hooks that are named beforeRender and afterRender, but they do completely new things now. For more details, see the Handsontable 10.0 API reference:

  2. Adapt to the HyperFormula dependency update

    In Handsontable 10.0.0, Handsontable updates the optional HyperFormula dependency from 0.6.2 to ^1.1.0 (#8669).

    For more details on the breaking changes between HyperFormula 0.6.x and HyperFormula 1.0.x, see the migration guide.

  3. Adapt to the configuration options’ new default values

    In Handsontable 10.0.0, Handsontable changes the default values of the autoWrapCol and autoWrapRow configuration options, from true to false (#8662):

    We also changed the default values for the rowsLimit and columnsLimit options of the CopyPaste plugin, from 1000 to Infinity (#8676):

  4. Adapt to the Handsontable hooks changes

    In Handsontable 10.0, Handsontable unifies the naming of an argument used by the beforeOnCellMouseDown and beforeOnCellMouseOver Handsontable hooks (#8591):

    Handsontable hookBeforeAfter
    beforeOnCellMouseDownblockCalculationscontroller
    beforeOnCellMouseOverblockCalculationscontroller

    In both cases, the renamed controller object now has a cell property, instead of a cells property:

    blockCalculations (before)controller (after)
    row
    column
    cells    		row
    column
    cell

    This change affects the following plugins:

    For more details, see this PR.

  5. Adapt to the font changes

    To make Handsontable look good right out of the box, Handsontable 10.0 adds default font-family, font size, font weight, and color properties for all elements within the .handsontable CSS class (#8681). If you do not overwrite these properties in your app, this change will affect your grid’s font.

Result

Your application now runs on Handsontable 10.0.