JavaScript Data GridUpgrading to AG Grid 31.3

What's New

See the release post for details of what's new in version 31.3.

Codemods

Follow these steps to upgrade your project's AG Grid version to 31.3.1:

  1. Locate your project's package.json and note the version of AG Grid that you are currently using.

  2. Update any AG Grid dependencies listed in your project's package.json to version 31.3.1.

  3. Open a terminal and navigate to your project's root folder.

  4. Run the migrate command of version 31.3 of the AG Grid codemod runner, where $FROM_VERSION refers to your project's existing AG Grid version:

    npx @ag-grid-devtools/cli@31.3 migrate --from=$FROM_VERSION
    

    This will update your project's source files to prepare for the new release.

    By default the Codemod runner will locate all source files within the current directory. For projects with more specific requirements, pass a list of input files to the migrate command, or specify the --help argument to see more fine-grained usage instructions.

The Codemod runner will check the state of your project to ensure that you don't lose any work. If you would rather see a diff of the changes instead of applying them, pass the --dry-run argument.

The codemod only transforms source files that make use of deprecated features, so if you aren't currently making use of any of those APIs your source code will be unaffected by the codemod.

See the Codemods documentation for more details.

Deprecations

This release includes the following deprecations:

ToolPanelColumnCompParams - deprecated, use IToolPanelColumnCompParams instead.

GridOptions

  • groupIncludeFooter - deprecated, use groupTotalRow instead.
  • groupIncludeTotalFooter - deprecated, use grandTotalRow instead.
  • footerValueGetter - deprecated, use totalValueGetter instead.

Grid API

  • tabToNextCell - null input param type deprecated, provide boolean input param type instead.
  • tabToNextHeaderCell - null input param type deprecated, provide boolean input param type instead.
  • getValue - deprecated, use getCellValue instead.
  • Returning null from tabToNextCell is deprecated. Instead, return true to stay on the current cell, or false to let the browser handle the tab behaviour.
  • Returning null from tabToNextHeader is deprecated. Instead, return true to stay on the current header, or false to let the browser handle the tab behaviour.