rows().invalidate()

自：DataTables 1.10

使 DataTables 中所選列的資料失效。

描述

DataTables 會快取表格中每個儲存格的內容資訊，以提高表格操作的效能，例如排序和搜尋。如果您修改了儲存格的內容（對於 DOM 資料來源表格）或陣列/物件值（對於 Ajax/JS 來源表格），DataTables 不會知道發生了這種情況。此方法可用於告知 DataTables 重新讀取該列的資料來源資訊（無論是來自 DOM 還是物件/陣列 - 無論原始資料來源是什麼）。

這提供了一個替代方案，可以使用 row().data() 和 cell().data() 來變更儲存格的值。通常，data 方法優先於失效方法，因為它們使用的程式碼較少，但當表格的資料來源是可以使用該物件自身的方法更新的外部物件時，失效方法真正發揮作用。

類型

function rows().invalidate( [ source ] )

描述

使所選列中的資訊失效

參數

名稱類型可選

	名稱	類型	可選
1	`source`	`字串`	是 - 預設值：auto
	從中讀取新資料的資料來源。預設情況下，DataTables 將自動從原始讀取的相同來源（即 DOM 來源或 Javascript 來源）讀取該列的新資料，但此參數可用於覆蓋該行為，並明確告知 DataTables 應使用哪個來源讀取新資料。如果您使用 Ajax 載入資料，但使用 DOM 修改儲存格的內容，這可能會很有用。此屬性可以採用以下值 `auto` - 使用原始資料來源 `data` - 使用 Javascript 資料結構 `dom` - 使用目前 DOM 中保存的資料

source

字串

是 - 預設值：auto

從中讀取新資料的資料來源。

預設情況下，DataTables 將自動從原始讀取的相同來源（即 DOM 來源或 Javascript 來源）讀取該列的新資料，但此參數可用於覆蓋該行為，並明確告知 DataTables 應使用哪個來源讀取新資料。如果您使用 Ajax 載入資料，但使用 DOM 修改儲存格的內容，這可能會很有用。

此屬性可以採用以下值

auto - 使用原始資料來源
data - 使用 Javascript 資料結構
dom - 使用目前 DOM 中保存的資料

傳回

DataTables.Api

DataTables API 實例，結果集中包含所選列的參考

範例

使用 jQuery 修改儲存格的內容，然後使 DataTables 保存的列失效

var table = new DataTable('#myTable');
var tr = $('#example tbody tr:eq(0)');

tr.find('td:eq(0)').html('Updated');
table
	.rows(tr)
	.invalidate()
	.draw();

使用資料物件實例，並在外部資料變更後使用失效來更新表格

var pupils = [new Pupil(), new Pupil(), new Pupil(), new Pupil()];

// Create table with data set
var table = new DataTable('#myTable', {
	data: pupils
});

// Modify the data in the data set
pupils[0].name('Fred Green');
pupils[3].name('Fiona Wilder');

// Invalidate and redraw all rows
table
	.rows()
	.invalidate()
	.draw();

rows().invalidate()

描述

類型

function rows().invalidate( [ source ] )

範例

相關

DataTables