row-reordered

Since: RowReorder 1.0.0

After rows have been reordered by the end user.
Please note - this property requires the RowReorder extension for DataTables.

Description

The event data is identical to the row-reorder event. In comparison to the row-reorder event, the event will be triggered after the row is dropped and after the data is updated.
This event is only triggered if the rowReorder.update option has been enabled (which it is by default).

The data that has been changed by RowReorder is given in two different forms in the parameters for the event handler callback - one with detailed information about the individual rows, and one with data in a format suitable for Editor's multi-row editing feature.

Please note that, as with all DataTables emitted events, this event is triggered with the dt namespace. As such, to listen for this event, you must also use the dt namespace by simply appending .dt to your event name, or use the on() method to listen for the event which will automatically append this namespace.

Type

function function( e, details, edit )

Parameters:

	Name	Type	Optional
1	`e`	`object`	No
	jQuery event object
2	`details`	`array`	No
	An array of change objects for the row's how have had values effected. Each object contain the following properties: `Any` `newData` - The new data value for the row (data point defined by `rowReorder.dataSrc`) `node` `node` - The `tr` element `integer` `newPosition` - New index in the DOM `Any` `oldData` - The old data value for the row `integer` `oldPosition` - Old index in the DOM
3	`edit`	`object`	No
	This parameter provides the information required for Editor to perform a multi-row edit: `string` `dataSrc` - Data point - typically the field to be edited (defined by `rowReorder.dataSrc`) `array` `nodes` - The rows to be edited `object` `values` - The new values in a format suitable for `multiSet()`. `DataTable.Api` `triggerRow` (Since v1.1.0) - Row API instance for the row that was used to start the reorder (i.e. the result from `row()`).

Example

Add a class to all changed rows:

var table = new DataTable('#myTable', {
	rowReorder: true
});

table.on('row-reordered', function (e, diff, edit) {
	for (var i = 0, ien = diff.length; i < ien; i++) {
		$(diff[i].node).addClass('reordered');
	}
});