columnsVisibility
自:Buttons 1.0.0
一組用於設定個別欄位可見性的按鈕。
請注意 - 此屬性需要 DataTables 的 Buttons 擴展功能。
說明
此按鈕類型實際上會在按鈕實例中建立多個按鈕,針對每個已選取的欄位(如果未給定選擇器,則為所有欄位)建立一個按鈕。每個按鈕都會自動獲得與該欄位的標題文字相同的標題,並能透過按鈕的 visibility
選項來控制每個欄位的可見性。
此按鈕類型包含在基本欄位可見性按鈕集中,以求完整性,但 columnsToggle
和 columnVisibility
通常更有用。
選項
除了適用於所有按鈕的選項(例如,buttons.buttons.text
)之外,此按鈕還可以在其配置物件中設定以下選項,以自訂其動作和顯示方式。
名稱 | 類型 | 預設值 |
---|---|---|
columns | undefined | |
欄位選擇器,用於定義要包含在欄位可見性按鈕集中的欄位。預設值為 | ||
visibility | undefined | |
控制在啟動按鈕時是否應顯示或隱藏欄位。 |
範例
DataTables 初始化:用於顯示/隱藏欄位的個別按鈕集合
new DataTable('#myTable', {
layout: {
topStart: {
buttons: [
{
extend: 'collection',
text: 'Show columns',
buttons: ['columnsVisibility'],
visibility: true
},
{
extend: 'collection',
text: 'Hide columns',
buttons: ['columnsVisibility'],
visibility: false
}
]
}
}
});