內建按鈕
如果您希望定義自訂按鈕,或使用其他擴充功能(如 Editor)中包含的按鈕,按鈕框架會很有用,但其功能藉由程式庫中包含的按鈕類型而大大增強。
這些按鈕不是核心程式庫的一部分,而是個別檔案,您可以根據需要加入。例如,您可能希望提供 HTML5 檔案匯出按鈕,但不需要 Flash 匯出按鈕。這只是確保只將您需要的程式碼傳遞給終端使用者。
按鈕 (Buttons) 有三種按鈕類型
- 檔案匯出
- 列印
- 欄位可見度
檔案匯出
在 DataTables 中顯示資料時,讓您的終端使用者能夠從 DataTables 取得資料,並將其匯出到檔案中以供本地使用通常會很有用。這可以使用基於 HTML5 的按鈕或 Flash 按鈕完成。
按鈕 (Buttons) 有四種內建按鈕類型,它們會自動偵測瀏覽器的能力以及可用的軟體 - 如果可以,它們會自動使用 HTML5 按鈕,並在不符合任何要求時退回到 Flash,最後完全不顯示。
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 擴充功能。