自動填滿

自動填滿動作已完成。
請注意 - 此屬性需要 DataTables 的 自動填滿擴充功能。

說明

當終端使用者完成填滿動作時，會觸發此事件。此事件會在表格更新並由填滿重新繪製後發生。這對於將變更提交到伺服器/資料庫以永久儲存變更非常有用。

已填滿的儲存格資訊會以陣列（下方的 cells 參數）形式提供 - 這是一個陣列的陣列，每個最上層的陣列代表一個列，內部元素則代表欄 - 例如：

[
    [ cell_0-0, cell_0-1, cell_0-2, ... ],
    [ cell_1-0, cell_1-1, cell_1-2, ... ],
    [ cell_2-0, cell_2-1, cell_2-2, ... ],
    ...
]

保證永遠會有多個儲存格 - 因此存取 [0][0] 作為第一個儲存格是安全的。第一個儲存格是填滿動作的開始位置。第一列和第一欄與該儲存格在同一軸上，無論填滿的方向是向上、向下、向左或向右。

每個內部陣列項目都是一個表示儲存格的物件，並包含以下屬性

• cell - 相關儲存格的 DataTables Api 實例 - 請參閱 cell()
• index - 儲存格的索引 - 請參閱 cell().index() - 請注意這是DataTables 內部索引，而不是可見的索引！
• data - 填滿前的儲存格資料
• set - 填滿後的儲存格資料

類型

範例

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

table.on('autoFill', function (e, datatable, cells) {
	alert(cells.length * cells[0].length + ' cells were updated');
});