files()

起始版本：Editor 1.5

取得多個上傳檔案的相關資訊。
請注意 - 此屬性需要 DataTables 的 Editor 擴充功能。

說明

此方法是 files() 方法的別名，它接受完全相同的參數並返回相同的結果。在更容易使用 DataTables API 方法而不是 Editor 的情況下，DataTables API 上提供了此別名，以提供便利性。

關於此方法的完整詳細資訊，請參閱 files() 文件。

類型

function files( [ table ] )

說明

取得先前透過 Editor 表單上傳的檔案清單 (upload 或 uploadMany)。每個檔案可用的資訊取決於如何在伺服器端為 Upload 類別配置 db() 方法（如果已使用）。請參閱 PHP 和 .NET 以取得有關此方法的詳細資訊。

參數

返回

	名稱	類型	可選
1	`table`	`字串`	是
	保存所需檔案相關資訊的資料庫表名稱。如果 `undefined`，將會返回包含所有資料表的物件。

物件

如果提供 table 參數，返回的物件將會包含透過 Editor 上傳欄位上傳的每個檔案的條目。物件的鍵值是檔案資料庫條目的主鍵值。

如果未提供 table 參數，則返回一個物件，其中鍵值是在伺服器端定義的資料表名稱，值則如上述針對個別資料表所述的物件。

範例

使用 files() 記錄從資料庫資料表 documents 中取得的所有可用檔案 (在此處的 initComplete 中完成)

$(document).ready(function () {
	var table = new DataTable('#myTable', {
		ajax: '../php/upload.php',
		columns: [
			{ data: 'users.first_name' },
			{ data: 'users.last_name' },
			{ data: 'users.phone' },
			{ data: 'sites.name' },
			{
				data: 'users_files.fileId',
				render: function (fileId) {
					return fileId
						? '<img src="' + table.file('files', fileId).web_path + '"/>'
						: 'No image';
				}
			}
		],
		layout: {
			topStart: {
				buttons: [
					{ extend: 'create', editor: editor },
					{ extend: 'edit', editor: editor },
					{ extend: 'remove', editor: editor }
				]
			}
		},
		select: true,
		initComplete: function () {
			console.log(table.files('documents'));
		}
	});
});