按鈕

當使用複雜的 DataTable 時,很常見會希望呈現一些選項,讓終端使用者可以啟用這些選項來影響表格,或以某種方式影響表格內包含的資料。顯示可以點擊、輕觸或從鍵盤觸發的按鈕是一種方法,而 Buttons 擴充功能 正好提供了這種能力。

各種 DataTables 擴充功能 提供了可以用來存取該擴充功能的功能的按鈕;例如 Editor 為表格提供了新增、編輯和刪除按鈕。這裡記錄了可用的按鈕。此外,還可以建立自訂按鈕來執行特定於您的使用案例的操作。

可以使用 buttons 組態物件,並使用 dom 指定按鈕的放置位置來使用按鈕。

$('#myTable').DataTable( {
    dom: 'Bfrtip',
    buttons: [
        'colvis',
        'excel',
        'print'
    ]
} );

有關按鈕自訂事件的更多資訊,請參考 Buttons 擴充功能文件。請注意,DataTables 核心本身不提供任何按鈕,必須載入 Buttons 擴充功能才能夠使用擴充功能的按鈕。

函式庫 名稱 摘要
按鈕

collection

一個按鈕,會觸發一個下拉選單,其中包含另一組按鈕

按鈕

columnToggle

一個單一按鈕,將切換一或多個欄的顯示與否

按鈕

columnVisibility

一個單一按鈕,控制一或多個欄的顯示與否

按鈕

columnsToggle

一組按鈕,用於切換各欄的顯示與否

按鈕

columnsVisibility

一組按鈕,用於設定各欄的顯示與否

按鈕

colvis

一個按鈕集合,提供欄顯示控制

按鈕

colvisGroup

顯示和隱藏多個欄

按鈕

colvisRestore

將欄的顯示還原到其原始狀態

按鈕

copy

將表格資料複製到剪貼簿的按鈕

按鈕

copyHtml5

將表格資料複製到剪貼簿的按鈕 (HTML)

按鈕

csv

建立並儲存包含表格資料的 CSV 檔案

按鈕

csvHtml5

建立並儲存包含表格資料的 CSV 檔案 (HTML5)

按鈕

excel

建立並儲存包含表格資料的 Excel CSV 檔案

按鈕

excelHtml5

建立並儲存包含表格資料的 Excel XLSX 檔案 (HTML5)

按鈕

pageLength

將控制 DataTables 分頁長度的按鈕集合

按鈕

pdf

建立並儲存包含表格資料的 PDF 檔案

按鈕

pdfHtml5

建立並儲存包含表格資料的 PDF 檔案 (HTML5)

按鈕

print

按鈕顯示表格資料的可列印檢視

按鈕

spacer

一個特殊的「按鈕」,在按鈕之間提供視覺分組。

Editor

create

一個按鈕,將使用 Editor 建立新列

Editor

createInline

一個按鈕,將插入新列以用於內嵌列建立

Editor

edit

一個按鈕,將使用 Editor 編輯一或多個現有列

Editor

editSingle

一個按鈕,將使用 Editor 編輯現有列

Editor

remove

一個按鈕,將使用 Editor 刪除一或多個列

Editor

removeSingle

一個按鈕,將使用 Editor 刪除單一列

FixedColumns

fixedColumns

一個單一按鈕,可初始化並允許切換 FixedColumns。

SearchBuilder

searchBuilder

一個單一按鈕,在彈出視窗中顯示 SearchBuilder 容器。

SearchPanes

searchPanes

一個單一按鈕,在彈出視窗中顯示 SearchPanes 容器。

SearchPanes

searchPanesClear

一個單一按鈕,清除 SearchPanes 選項。

Select

selectAll

根據目前項目選擇模式,選取表格中的所有項目

Select

selectCells

將項目選擇模式變更為 cell

Select

selectColumns

將項目選擇模式變更為 column

Select

selectNone

取消選取表格中所有選取的項目。

Select

selectRows

將項目選擇模式變更為 row

Select

selected

當表格中選取一或多個項目時,會啟用此按鈕

Select

selectedSingle

當表格中選取單一項目時,會啟用此按鈕

Select

showSelected

切換篩選器,將顯示的列減少到僅限選取的列。

StateRestore

createState

根據表格的目前狀態建立新狀態。

StateRestore

removeAllStates

移除所有已儲存的狀態。

StateRestore

removeState

從儲存空間中移除狀態。

StateRestore

renameState

重新命名狀態。

StateRestore

savedStates

用於提供與已儲存狀態互動的集合

StateRestore

savedStatesCreate

擴充 savedStates,將建立功能新增至通常顯示的集合

StateRestore

stateRestore

代表並提供已儲存狀態功能的分割按鈕。

StateRestore

updateState

使用目前的表格狀態更新選取的狀態。