打印

自：按鈕 1.0.0

按鈕會顯示表格資料的可列印檢視結果。
請注意 - 此特性需要按鈕的 DataTables 擴充套件。

描述

列印檢視按鈕會將表格中顯示的資料副本 (根據 exportOptions 參數中提供的選取器選項) 建立一個新的暫時表格，並在新的視窗中顯示。接著會自動呼叫瀏覽器的 列印 命令 (不過這個步驟也可以停用 - 請參閱下列的 autoPrint 選項)，最後在列印動作完成或被終端使用者取消時關閉視窗。

建置的表格不會保留所有原本表格的資訊 (例如不會複製表格列和單元格類別)，不過原本文件中的樣式表會複製到列印文件，以保留表格的基本樣式。

列印檢視的客製化可透過 title 和 message 選項 (用於提供簡單的描述字串) 來使用，並且可透過 customize 選項完全控制產生的文件 (例如新增圖片等)。

請注意，列印按鈕會將 buttons.exportData() 的 decodeEntities 選項設定為 false，以防止 XSS 攻擊。

選項

除了針對所有按鈕提供的選項 (例如 buttons.buttons.text) 之外，此按鈕可以在其設定物件中設定以下選項，以客製化其動作和顯示結果

名稱	類型	預設
`動作`
顯示列印檢視
`自動列印`		true
在列印檢視頁面顯示時，指出是否應呼叫瀏覽器的 `window.print()` 方法 `true` - 將呼叫 `window.print()`，然後立即在完成後關閉 `window.close()` 函式，以隱藏列印檢視文件。 `false` - 在建立列印檢視文件之後，不會執行任何動作。系統不會自動關閉視窗。
`類別名稱`		按鈕列印
按鈕的類別名稱。針對詳細資料，請參閱 `buttons.buttons.className`。
`自訂指令碼`		null
指向應包含在列印檢視文件中的指令碼的 URL 陣列。這對於包含正確顯示文件所需的額外函式庫很有用。當包含列印檢視文件的視窗顯示時，執行的函式。
`自訂化`		null
當包含列印檢視文件的視窗顯示時，執行的函式。對於按鈕 1.5.2 開始，此函式會傳遞三項參數 `物件` `視窗` - 新視窗的視窗物件。因此，可以使用 `window.document.body` 存取文件主體，並且可以使用 jQuery / DOM 方法操作，就像任何元素一樣。 `物件` - 按鈕組態物件 `DataTable.Api` - 按钮所属表格的 DataTables API 实例。不会期望或执行返回值。
`exportOptions`		{}
选择要从 DataTable 收集的数据以供导出，其中包括列、行、排序和搜索选项。有关完整详细信息，请参阅 `buttons.exportData()` 方法 - 此参数传递的对象直接传递到该操作中以收集所需的数据。
`footer`		true
指示是否将表格页脚包含在打印视图中。请注意，此参数的默认值已在 Buttons 3.0.1 中更新为 `true`。在早期版本中，它为 `false`。
`header`		true
指示是否将表格标题包含在打印视图中。
`message`
描述信息，可显示在打印视图文档中，其中可以包含 HTML。除了字符串值之外，还可以将函数分配给 `message` 属性。当按钮需要显示消息时，将执行此函数，并将使用函数返回的值。该函数以三个参数传递 `DataTables.Api` - DataTable API 实例 `jQuery` - 按钮节点的 jQuery 对象 `object` - 按钮的配置对象。
`messageBottom` 自版本：1.4.0		*
显示在表格底部或 `caption` 标签中的消息（如果表格底部显示）。
`messageTop` 自版本：1.4.0		*
显示在表格顶部或 `caption` 标签中的消息（如果表格顶部显示）。
`text`		打印
按钮的显示文本。可以使用此选项配置文本（参见 `buttons.buttons.text`），也可以使用 DataTables `language` 对象的 `buttons.print` 选项。
`title`		*
将包含在导出数据中的表格标题。有关此参数的所有选项，请参阅 `buttons.exportInfo()`。

範例

DataTables 初始化：显示打印按钮

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: ['print']
		}
	}
});

DataTables 初始化：禁用打印对话框的自动显示

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'print',
					text: 'Print current page',
					autoPrint: false
				}
			]
		}
	}
});

DataTables 初始化：使用 exportOptions 仅打印当前 DataTable 页面

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'print',
					text: 'Print current page',
					exportOptions: {
						modifier: {
							page: 'current'
						}
					}
				}
			]
		}
	}
});