Expand All

  Getting Started

  Reference

  Features

  Row Models

  Themes

  Components

  Examples

Misc

Github stars make projects look great. Please help, donate a star, it's free.
Read about ag-Grid's Partnership with webpack.
Get informed on releases and other ag-Grid news only - never spam.
Follow on Twitter

Animation

The grid will animate the rows and columns in the following scenarios:

  • Column Animations:
    • Moving Columns
  • Row Animations
    • Filtering Rows
    • Sorting Rows
    • Expanding / Collapsing Row Groups

Column Animations

Column animations happen when you move a column. The default is for animations to be turned on. It is recommended that you leave the column move animations on unless your target platform (browser and hardware) is to slow to manage the animations. To turn OFF column animations, set the grid property suppressColumnMoveAnimation=true.

The move column animation transitions the columns position only. So when you move a column, it animates to the new position. No other attribute apart from position is animated.

Row Animations

Row animations occur after filtering, sorting, resizing height and expanding / collapsing a row group. Each on these animations is turned OFF be default. They are all turned on using using the property animateRows=true.

Column animations are on by default, row animations are off by default. This is to keep with what is expected to be the most common configuration as default.

You do not need to know how the animations work, you just need to turn them on. However if you are creating a theme or otherwise want to adjust the animations, it will be useful for you to understand the sequence of rules which are as follows:

  • New Rows: Rows that are new to the grid are placed in the new position and faded in.
  • Old Rows: Rows that are no longer in the grid are left in the same position and faded out.
  • Moved Rows: Rows that are in a new position get their position transitioned to the new position.
  • Resized Height Rows: Rows that get their height change will have the height transitioned to the new height.
In addition to the transition animations, old rows are placed behind new rows such that moving rows are on top of old rows when moved (hence old rows are not fading out on top of new rows, but behind new rows).

Depending on your data set and users, sometimes row animation looks good, sometimes it doesn't. A large dataset will not look as nice as a small dataset when sorting and filtering as there will be large changes in the rows displayed, sometimes always replacing all the rows. A small dataset will look much nicer, especially on that fits all the data on the screen in one go, as then all rows will animate to new positions. Users will also have their preference, with users in high pressure situations (eg finance traders or air traffic control) may prefer no animation and focus on the data.

Example Animation

The example below shows the animations by the JavaScript calling the grid's api. So no touching, just looking!!!