JavaScript Data GridRow Dragging

Row dragging is used to rearrange rows by dragging the row with the mouse. To enable row dragging, set the column property rowDrag on one (typically the first) column.

The example above shows Managed Row Dragging, enabled by setting rowDrag on the column and rowDragManaged on the grid options.

Enabling Row Dragging Copy Link

To enable row dragging on all columns, set the column property rowDrag = true on one (typically the first) column and configure managed or unmanaged row dragging.

const gridOptions = {
    columnDefs: [
        // make all rows draggable
        { field: 'athlete', rowDrag: true },
    ],

    // other grid options ...
}

It is also possible to dynamically control which rows are draggable by providing a callback function as shown below:

const gridOptions = {
    columnDefs: [
        // only allow non-group rows to be dragged
        { field: 'athlete', rowDrag: params => !params.node.group },
    ],

    // other grid options ...
}

There are two ways in which row dragging works in the grid, managed and unmanaged:

• Managed Row Dragging: This is the simplest, where the grid will rearrange rows as you drag them.
• Unmanaged Row Dragging: This is more complex and more powerful. The grid will not rearrange rows as you drag. Instead the application is responsible for responding to events fired by the grid and rows are rearranged by the application.

See also:

• Row Dragging with Tree Data, both for managed and unmanaged row dragging with Tree Data.
• Row Dragging Between Grids to drag rows between two grids.
• Row Dragging to an External DropZone to drag rows from the grid to an external drop zone.

Next Up Copy Link

Continue to the next section to learn about Managed Row Dragging.