preDraw

預繪製事件 - 在表格即將重新繪製時觸發。

說明

當 DataTables 開始其繪製動作（最終導致 draw 事件）時，會觸發此事件，可用於通知您此狀態。

此事件也可以透過從事件處理程式返回 false 來取消繪製。請注意，如果您這樣做，可能會使表格處於不可預測的狀態，因為任何設定都不會重置為繪製動作之前的值 - 例如，使用 order() 來更改表格的排序，但如果取消繪製動作，資料仍然會在 DataTables 內部進行排序，但不會顯示。

請注意，與所有 DataTables 發出的事件一樣，事件物件上都有一個可用的 DataTables API 實例（第一個參數）。此外，事件會使用 dt 命名空間觸發。因此，要監聽此事件，您還必須使用 dt 命名空間，只需在您的事件名稱後附加 .dt 即可，如下面的範例所示。監聽器也應該在表格初始化之前設定，否則當嘗試載入狀態時，將不會設定監聽器，並且程式碼將不會為子列的初始顯示執行。

類型

範例

var table = new DataTable('#myTable');
var startTime;

table
	.on('preDraw', function () {
		startTime = new Date().getTime();
	})
	.on('draw.dt', function () {
		console.log('Redraw took at: ' + (new Date().getTime() - startTime) + 'mS');
	});

相關

以下選項直接相關，也可能在您的應用程式開發中很有用。