內建按鈕

如果您希望定義自訂按鈕,或使用其他擴充功能(如 Editor)中包含的按鈕,按鈕框架會很有用,但其功能藉由程式庫中包含的按鈕類型而大大增強。

這些按鈕不是核心程式庫的一部分,而是個別檔案,您可以根據需要加入。例如,您可能希望提供 HTML5 檔案匯出按鈕,但不需要 Flash 匯出按鈕。這只是確保只將您需要的程式碼傳遞給終端使用者。

按鈕 (Buttons) 有三種按鈕類型

  • 檔案匯出
  • 列印
  • 欄位可見度

檔案匯出

在 DataTables 中顯示資料時,讓您的終端使用者能夠從 DataTables 取得資料,並將其匯出到檔案中以供本地使用通常會很有用。這可以使用基於 HTML5 的按鈕或 Flash 按鈕完成。

按鈕 (Buttons) 有四種內建按鈕類型,它們會自動偵測瀏覽器的能力以及可用的軟體 - 如果可以,它們會自動使用 HTML5 按鈕,並在不符合任何要求時退回到 Flash,最後完全不顯示。

  • copy - 複製到剪貼簿
  • csv - 儲存為 CSV 檔案
  • excel - 儲存為 Excel XLSX 檔案
  • pdf - 儲存為 PDF 文件

HTML5

最新的瀏覽器(IE10+ 和永久更新的瀏覽器)在功能方面取得了巨大進展,現在大多數瀏覽器都能很好地建立本地檔案。因此,有四種按鈕類型可用(建議您優先使用上面記錄的通用按鈕)

  • copyHtml5 - 顯示一個對話方塊,要求使用者使用其瀏覽器的複製命令(HTML5 沒有複製到剪貼簿的 API)
  • csvHtml5 - 建立並儲存 CSV 檔案
  • excelHtml5 - 建立並儲存 Excel XLSX 檔案 - 這需要 JSZip。注意 - 這在 Safari 中將無法運作。
  • pdfHtml5 - 建立並儲存 PDF 文件 - 這需要 PDFMake 和適當的字型檔案。

Flash

較舊的瀏覽器沒有在本地建立檔案的優勢 - 為了支援這些瀏覽器,提供了 Flash 版本的檔案匯出選項。

這些按鈕的優點是它們除了 Flash 之外沒有外部依賴項。這些按鈕的缺點是它們需要 Flash。

  • copyFlash - 立即將資料複製到剪貼簿
  • csvFlash - 建立並儲存 CSV 檔案
  • excelFlash - 建立並儲存 Excel XLSX 檔案
  • pdfFlash - 建立並儲存 PDF 文件。注意 - 這不支援 UTF8 字元。

列印

從表格中擷取資料的另一種常見方式是列印。 print 按鈕類型透過在使用者瀏覽器中開啟一個新視窗來提供此功能,並繪製一個表格,其中包含原始表格的資料副本。

然後,預設情況下,它會自動觸發瀏覽器的列印功能,允許終端使用者列印表格。列印完成或取消後,視窗將關閉。

欄位可見度

雖然上述按鈕側重於從表格中擷取資料,但欄位可見度按鈕卻控制表格的顯示。它們提供的按鈕可用於切換個別欄、欄組的可見度,或明確設定欄的可見度。

最常用的可用按鈕是 colvis 類型。這會顯示一個 collection 按鈕,其中包含表格中所有欄的清單(可以自訂),終端使用者可以透過簡單的點擊來切換欄的可見度。

此模組取代了現在已停用的 ColVis DataTables 擴充功能。