{hero}

繪製

起始版本:DataTables 1.10

繪製事件 - 表格完成繪製後觸發。

描述

在表格的每次繪製事件時執行動作可能很有用 - 例如,您可能想要使用新顯示的數據更新外部控制項,或者在啟用伺服器端處理時,您可能想要將事件分配給新創建的元素。此事件正是為了提供此資訊。

draw 事件會在頁面上重新繪製表格時觸發,與 drawCallback 相同的時間點(技術上回呼會在事件之前觸發,但它們是依序發生的,因此可以使用任一者來達到相同的效果)。

請注意,與所有 DataTables 發出的事件一樣,事件物件上都有可用的 DataTables API 實例(第一個參數)。此外,事件會使用 dt 命名空間觸發。因此,若要直接使用 jQuery 監聽此事件,您還必須使用 dt 命名空間,方法是簡單地將 .dt 附加到您的事件名稱。 DataTables 的 on() 方法會自動執行此操作。

此事件將會冒泡到文件,因此您可以在 body 上新增 draw.dt 的監聽器,以捕獲 DataTables 觸發的所有繪製事件。

類型

function function( e, settings )

參數

範例

在每次繪製時記錄到主控台

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

table.on('draw', function () {
	console.log('Redraw occurred at: ' + new Date().getTime());
});

相關

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