DIV CSS 佈局教程網

Bootstrap Table 分頁常見問題整理與解法
編輯:關於JavaScript     

Bootstrap Table 功能強大,但第一次用在後端分頁時,很容易卡在幾個固定關卡:後端收不到參數、每頁筆數抓不到、重新搜尋後頁碼沒歸零。以下把這些高頻問題與對應解法整理成清單,方便逐項對照。

問題一:伺服器端取不到表單值

狀況是 query string 裡明明有參數,但 request.form 就是拿不到值。

解法:這是因為套件預設使用原生 AJAX 送出請求。若希望後端能用 request.form 接收,把 contentType 改為表單編碼即可(另一條路是改讀串流)。

$('#tableList').bootstrapTable({
    method: 'post',
    url: "",
    height: $(window).height() - 200,
    striped: true,
    dataType: "json",
    pagination: true,
    queryParamsType: "limit",
    singleSelect: false,
    contentType: "application/x-www-form-urlencoded",
    // ...
});

問題二:如何自訂傳送給伺服器的參數

透過 queryParams 鉤子,可以在送 request 前加工參數:

function queryParams(params) {
    return {
        pageSize: params.limit,
        pageNumber: params.pageNumber,
        UserName: 4
    };
}

$('#tableList').bootstrapTable({
    method: 'post',
    url: "",
    height: $(window).height() - 200,
    striped: true,
    dataType: "json",
    pagination: true,
    queryParams: queryParams,
    // ...
});

問題三:後台拿不到 pageSize

解法有兩條路。一是在 queryParams 裡自行對應;二是直接改原始碼,讓 queryParamsType 為 limit 時一併送出 limit 與 offset:

if (this.options.queryParamsType === 'limit') {
    params = {
        search: params.searchText,
        sort: params.sortName,
        order: params.sortOrder
    };
    if (this.options.pagination) {
        params.limit = this.options.pageSize;
        params.pageNumber = this.options.pageNumber;
        params.offset = this.options.pageSize * (this.options.pageNumber - 1);
    }
}

壓縮版檔案 bootstrap-table.min.js 中對應的那段也能改,同時別忘了在初始化設定中加上 "queryParamsType": "limit"。完整設定如下:

<script type="text/javascript">
$(document).ready(function () {
    $('#tableList').bootstrapTable({
        method: 'post',
        url: "getcompapylist",
        height: $(window).height() - 200,
        striped: true,
        dataType: "json",
        pagination: true,
        queryParamsType: "limit",
        singleSelect: false,
        contentType: "application/x-www-form-urlencoded",
        pageSize: 10,
        pageNumber: 1,
        search: false,            // 不顯示搜尋框
        showColumns: false,       // 不顯示欄位選擇下拉
        sidePagination: "server", // 伺服器端分頁
        queryParams: queryParams,
        responseHandler: responseHandler,
        columns: [
            { field: 'CompanyId', checkbox: true },
            { field: 'qq', title: 'qq', width: 100, align: 'center', valign: 'middle', sortable: false },
            { field: 'companyName', title: '姓名', width: 100, align: 'center', valign: 'middle', sortable: false }
        ]
    });
});

function responseHandler(res) {
    if (res.IsOk) {
        var resultStr = $.parseJSON(b64.decode(res.ResultValue));
        return { "rows": resultStr.Items, "total": resultStr.TotalItems };
    }
    return { "rows": [], "total": 0 };
}

function queryParams(params) {
    return {
        pageSize: params.limit,
        pageNumber: params.pageNumber,
        UserName: 4
    };
}
</script>

問題四:翻頁後重新搜尋,頁碼沒有歸零

這個問題的前提是「自訂搜尋 + 分頁」。舉例來說,搜尋「充氣娃娃」得到 100 筆,翻到第 5 頁;接著改搜「按摩筆」共 200 筆,理論上應該回到第 1 頁,畫面卻仍停在第 5 頁——因為 pageNumber 沒有被重設。

解法:搜尋時重新設定一次 options 即可。

function search() {
    $('#tableList').bootstrapTable({
        pageNumber: 1,
        pageSize: 10
    });
}

排查順序建議

遇到分頁異常時,我通常照這個順序檢查:確認 sidePagination 是 server 還是 client、確認 queryParamsType 與後端參數名稱一致、用開發者工具看實際送出的 request 內容、最後才考慮動原始碼。多數問題在前三步就能定位。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved