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,
// ...
});
解法有兩條路。一是在 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 內容、最後才考慮動原始碼。多數問題在前三步就能定位。