響應式顯示
自:Responsive 2.0.0
列的詳細資訊已顯示、更新或隱藏。
請注意 - 此屬性需要 DataTables 的 Responsive 擴充套件。
描述
有時,知道終端使用者何時要求 Responsive 顯示欄中隱藏列的詳細資訊(無論是在子列還是模態視窗中)、何時隱藏這些詳細資訊或何時更新這些詳細資訊會很有用。此事件提供了該功能。
請注意,與所有 DataTables 發出的事件一樣,此事件會使用 dt
命名空間觸發。因此,若要監聽此事件,您也必須使用 dt
命名空間,只需將 .dt
附加到您的事件名稱,或使用 on()
,它會自動附加此命名空間,如下面的範例所示。
類型
function function( e, datatable, row, showHide, update )
- 參數
名稱 類型 選用 1 e
否 jQuery 事件物件
2 datatable
否 相關表格的 DataTable API 實例
3 row
否 正在處理其詳細資訊的列的
row()
4 showHide
否 標示詳細資訊是否正在顯示 (
true
) 或隱藏 (false
) 的旗標。此值由responsive.details.display
所使用的函式決定。5 update
否 旗標,表示詳細資料是否因表格調整大小等事件而正在更新 (
true
),或者詳細資料是否應終端使用者的要求而顯示/隱藏 (false
)。
範例
使用 on()
監聽詳細資訊顯示事件
var table = new DataTable('#myTable', {
responsive: true
});
table.on('responsive-display', function (e, datatable, row, showHide, update) {
console.log(
'Details for row ' + row.index() + ' ' + (showHide ? 'shown' : 'hidden')
);
});