{hero}

row().child().show()

自 DataTables 1.10 起

使新定義的子資料列可見。

說明

此方法可用於隨時顯示父資料列的子資料列。子資料列可以使用 row().child() 附加,但不一定要立即顯示。此方法提供顯示已附加的子資料列的選項。

請注意,此方法僅在呼叫 row().child() 時設定參數時才可用。這是因為如果呼叫 row().child() 時未設定任何參數,則會傳回子資料列,其為 jQuery 物件或 undefined。當使用參數呼叫時,row().child() 會傳回 DataTables.Api 實例。如果需要在未設定任何參數的情況下顯示子資料列,請使用 row().child.show()

與許多其他操作 DataTable 的方法不同,此方法不需要呼叫 draw() 即可顯示結果的變更。子資料列會在不需要 DataTables 重新繪製的情況下插入到表格中。

類型

函式 row().child().show()

說明

顯示父資料列的子資料列

傳回

DataTables API 實例。

範例

根據資料列的目前狀態顯示/隱藏資料列,並在需要時加入資料列內容。

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

$('#example tbody').on('click', 'td.details-control', function () {
	var tr = $(this).parents('tr');
	var row = table.row(tr);

	if (row.child.isShown()) {
		// This row is already open - close it
		row.child.hide();
		tr.removeClass('shown');
	}
	else {
		// Open this row (the format() function would return the data to be shown)
		row.child(format(row.data())).show();
		tr.addClass('shown');
	}
});