DataTables 是 jQuery 生態系裡最成熟的分頁表格外掛之一,本身就具備排序、搜尋、分頁、每頁筆數切換等能力。本文示範把它與 Bootstrap 的樣式結合,資料則由後端以 JSON 提供。
用到的技術:jQuery DataTables 外掛、Bootstrap 前端框架、JSON 資料交換。
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="https://java.sun.com/jsp/jstl/core" prefix="c"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme() + "://" + request.getServerName()
+ ":" + request.getServerPort() + path + "/";
%>
<!DOCTYPE html>
<html lang="en" class="app">
<head>
<meta charset="utf-8" />
<title>XXX 服務平台</title>
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />>
<link rel="stylesheet" href="<%=request.getContextPath()%>/www/AL_app/js/jPlayer/jplayer.flat.css" rel="external nofollow" type="text/css" />
<link rel="stylesheet" href="<%=request.getContextPath()%>/www/AL_app/css/bootstrap.css" rel="external nofollow" type="text/css" />
<link rel="stylesheet" href="<%=request.getContextPath()%>/www/AL_app/css/font.css" rel="external nofollow" type="text/css" />
<link rel="stylesheet" href="<%=request.getContextPath()%>/www/AL_app/css/app.css" rel="external nofollow" type="text/css" />
<link rel="stylesheet" href="<%=request.getContextPath()%>/www/AL_app/js/datatables/datatables.css" rel="external nofollow" type="text/css" />
</head>
<body>
<!-- 醫用藥典開始 -->
<section id="content">
<section class="vbox">
<section class="scrollable padder">
<div class="m-b-md">
<h3 class="m-b-none">中醫藥典</h3>
</div>
<section class="panel panel-default">
<header class="panel-heading">
清單
<i class="fa fa-info-sign text-muted" data-toggle="tooltip"
data-placement="bottom" data-title="ajax to load the data."></i>
</header>
<div class="table-responsive">
<table class="table table-striped m-b-none" data-ride="datatables">
<thead>
<tr>
<th style="width:15%">序號</th>
<th style="width:20%">藥名</th>
<th style="width:20%">拼音簡稱</th>
<th style="width:15%">用法</th>
<th style="width:15%">操作</th>
</tr>
</thead>
<tbody></tbody>
</table>
</div>
</section>
</section>
</section>
</section>
<!-- 醫用藥典結束 -->
<script src="<%=request.getContextPath()%>/www/AL_app/js/jquery.min.js"></script>
<script src="<%=request.getContextPath()%>/www/AL_app/js/bootstrap.js"></script>
<script src="<%=request.getContextPath()%>/www/AL_app/js/app.js"></script>
<script src="<%=request.getContextPath()%>/www/AL_app/jh_js/jq.dataTable.js"></script>
<script src="<%=request.getContextPath()%>/www/AL_app/js/datatables/jquery.csv-0.71.min.js"></script>
<script src="<%=request.getContextPath()%>/www/AL_app/drugs/demo.js"></script>
<script src="<%=request.getContextPath()%>/www/AL_app/js/app.plugin.js"></script>
</body>
</html>
{
"aaData": [
{ "序號": "1", "藥名": "白術", "拼音簡稱": "bzh", "用法": "內服", "操作": "編輯" },
{ "序號": "3", "藥名": "白術", "拼音簡稱": "bzh", "用法": "內服", "操作": "編輯" },
{ "序號": "4", "藥名": "白術", "拼音簡稱": "bzh", "用法": "內服", "操作": "編輯" },
{ "序號": "5", "藥名": "白術", "拼音簡稱": "bzh", "用法": "內服", "操作": "編輯" },
{ "序號": "6", "藥名": "白術", "拼音簡稱": "bzh", "用法": "內服", "操作": "編輯" }
]
}
/** 使用 jquery-datatable 異步請求資料建立表格 **/
+function ($) {
"use strict";
$(function () {
$('[data-ride="datatables"]').each(function () {
var oTable = $(this).dataTable({
"bProcessing": true,
"sAjaxSource": "www/AL_app/drugs/drugs.json", // 異步請求 json
"sDom": "<'row'<'col-sm-6'l><'col-sm-6'f>r>t<'row'<'col-sm-6'i><'col-sm-6'p>>",
"sPaginationType": "full",
// 指定各欄對應的資料鍵名
"aoColumns": [
{ "mData": "序號" },
{ "mData": "藥名" },
{ "mData": "拼音簡稱" },
{ "mData": "用法" },
{ "mData": "操作" }
]
});
});
});
}(window.jQuery);
中文鍵名可行但不推薦。 範例的 JSON 用「序號」「藥名」當鍵,aoColumns 的 mData 也照抄,跑起來沒問題,但中文鍵在資料處理、URL 編碼與跨語言團隊協作上都容易出狀況。建議後端統一輸出英文鍵(id、name、pinyin),中文只放在 aoColumns 的 sTitle 或表頭 HTML 裡。
靜態 JSON 只是入門,真實場景要用伺服器端處理。 這份範例一次把全部資料載回來,由 DataTables 在前端分頁排序。資料量一大就會卡。DataTables 另外提供 bServerSide(新版本為 serverSide: true)搭配 ajax 設定,把分頁、排序、搜尋的參數送到後端,由後端只回傳當前頁的片段。上線前請務必改用這個模式。
版本命名已全面更新。 DataTables 1.10 之後改用駝峰式命名(ajax、columns.data、dom、pagingType),舊的 sAjaxSource、aoColumns、sDom 這類匈牙利命名法雖仍相容,但新專案應直接採用新寫法。此外範例中 data-ride="datatables" 這種 Bootstrap 插件式的自動初始化,在 DataTables 自身的 API 裡並不存在,實際運作靠的是 demo.js 中的 dataTable() 呼叫。
以上就是這次的主題,希望對你的表格開發有所幫助。