destroy() 从当前上下文中销毁DataTables实例文档(Options & API) DataTables中文网

描述(Description)

DataTables 添加了许多HTML元素，事件监听和其他修改，来增强原始HTMl表格。该方法可用来删除这些增强功能，并将表格恢复原始未增强状态。

因为这些增强不能通过API进行动态更改，如果你需要基于不同初始化设置或者不同列数来销毁和创建新表，该方法将非常有用。如果你不需要更改表的功能，只需要改变表中的数据，那么请考虑使用 clear()API , ajax.url()API 和 rows.add()API 这些方法。

注意如果你希望将一个表替换成另一个表，则一定要销毁这个实例，以防止内存泄露。

类型(Type)

这个选项能够接受以下类型的参数：

function destroy( [ remove ] )

描述(Description):

通过删除所有DataTables增强功能，改变表和事件监听的DOM结构，将当前上下文中的表恢复到DOM的原始状态。

参数(Parameters):

名称（Name）类型（Type）是否可选（Optional）

1 remove booleanType Yes-default:false

	名称（Name）	类型（Type）	是否可选（Optional）
1	`remove`	`booleanType`	Yes-default:false
	true - 完全从DOM中删除表 false - 保留DOM，恢复到原始的未增强的HTML状态(默认false) 在v1.10.8版本中，如果使用 `true` ，DataTables 将会使用 jQuery .remove()方法从页面中删除表，这导致绑定到表元素的任何事件被jQuery自动移除。如果设置 `false` 自定义事件不会从表中删除，DataTables本身附加的事件会自动移除。

true - 完全从DOM中删除表
false - 保留DOM，恢复到原始的未增强的HTML状态(默认false)

在v1.10.8版本中，如果使用 true ，DataTables 将会使用 jQuery .remove()方法从页面中删除表，这导致绑定到表元素的任何事件被jQuery自动移除。如果设置 false 自定义事件不会从表中删除，DataTables本身附加的事件会自动移除。

返回(Returns):

DataTables.ApiType

DataTables API 实例

例子(Example)

点击按钮销毁一个已经存在的实例

1
2
3
4
5
var table = $('#myTable').DataTable();
 
$('#tableDestroy').on( 'click', function () {
    table.destroy();
} );

从服务器重新读取一个表格结构（以防列发生变化，保险操作，把表格清空调用empty方法）

1
2
3
4
5
6
7
8
9
10
11
12
var table = $('#myTable').DataTable();
 
$('#submit').on( 'click', function () {
    $.getJSON( 'newTable', null, function ( json ) {
        table.destroy();
        $('#myTable').empty();
        table = $('#myTable').DataTable( {
            columns: json.columns,
            data:    json.rows
        } );
    } );
} );