preXhr
自:DataTables 1.10 起
Ajax 事件 - 在發出 Ajax 請求之前觸發。
描述
此事件在 DataTables 向伺服器發出 Ajax 請求以獲取資料之前觸發,因此是 xhr
事件的對應事件,該事件在 Ajax 請求成功從伺服器返回資料之後觸發。
preXhr
事件專為外掛程式作者設計,他們可以在擴充功能中監聽此事件,並發送可能需要的任何其他資料。 它與 ajax.data
的功能非常相似,後者通常由為表格編寫初始化程式碼的人員使用,而不是外掛程式作者。
請注意,與所有 DataTables 發出的事件一樣,事件物件上都有一個 DataTables API 實例(第一個參數)。此外,這些事件會使用 dt
名稱空間觸發。 因此,要監聽此事件,您還必須使用 dt
名稱空間,只需將 .dt
附加到您的事件名稱即可,如下面的範例所示。
類型
function function( e, settings, json, xhr )
- 參數
名稱 類型 可選 1 e
否 jQuery 事件物件
2 settings
否 DataTables 設定物件
3 data
否 將以物件形式發送到伺服器的資料
4 xhr
否 自 2.0.0 起:為 jQuery 建構的 XHR 物件
範例
使用事件在 Ajax 請求上向伺服器發送額外資料
$('#example')
.on('preXhr.dt', function (e, settings, data) {
data.sessionId = $('#sessionId').val();
})
.DataTable({
ajax: 'data.json'
});
// Note that `ajax.data` could also be used to perform this action in this case
相關
以下選項直接相關,並且在您的應用程式開發中也可能很有用。