buttons.buttons.available

自：Buttons 3.0.0 起

在初始化按鈕之前，請確保已滿足任何需求。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

說明

許多按鈕類型，特別是檔案匯出按鈕，可能會依賴於網頁瀏覽器中可用的某些 API 和已載入的外部第三方函式庫。例如，pdfHtml5 按鈕類型依賴於 FileReader API 和 pdfMake 函式庫。

此方法為按鈕開發人員提供了確保在向最終使用者顯示按鈕之前，滿足其按鈕可能具有的任何依賴關係的能力。如果函式返回 false，則該按鈕將不會顯示給最終使用者。

類型

function available( dt, config )

說明

此函式可用於確定最終使用者的網頁瀏覽器是否具有按鈕正常運作所需的函式和函式庫。如果函式由於這些需求未被滿足而返回 false，則該按鈕將不會顯示給最終使用者。

參數

回傳

	名稱	類型	可選
1	`dt`	`DataTables.Api`	否
	主機 DataTable 的 DataTables API 實例
2	`config`	`object`	否
	按鈕的組態物件

boolean

函式應返回一個布林值 - true 表示按鈕需求可用，false 表示不可用。

預設值

值：

預設函式取決於按鈕類型。請參閱按鈕類型文件。

範例

確保 FileReader API 可用

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [
				{
					text: 'FileReader available',
					available: function (dt, config) {
						return window.FileReader !== undefined;
					}
				}
			]
		}
	}
});