DIV CSS 佈局教程網

DataTables + Bootstrap:用 Ajax 動態載入表格資料
編輯:JQuery入門技巧     

DataTables 是一款 jQuery 表格外掛,它把任何 HTML table 都能升級成具備進階互動能力的元件,而且高度靈活。

主要功能

  • 分頁、即時搜尋與排序
  • 幾乎支援任何資料來源:DOM、JavaScript、Ajax 與伺服器端處理
  • 支援多種主題:DataTables、jQuery UI、Bootstrap、Foundation
  • 各式各樣的擴充:Editor、TableTools、FixedColumns……
  • 豐富的 option 與強大的 API
  • 支援國際化
  • 超過 2900 個單元測試
  • 免費開源(MIT license),並提供商業支援

這裡要談的是它用 Ajax 取資料並動態產生 DOM 的做法。這樣做有兩個好處:資料管理集中乾淨,HTML 頁面也不必塞一大堆 <tr> 顯得凌亂。

顯示效果

DataTables 搭配 Bootstrap 的表格效果

引入檔案

CSS:https://cdn.datatables.net/1.10.12/css/jquery.dataTables.min.css
JS:https://cdn.datatables.net/1.10.12/js/jquery.dataTables.min.js

若要用 Bootstrap 主題,還需另外引入 dataTables.bootstrap.css 與对应的 JS。

HTML

只需要定義一個 table,給它一個唯一標記(id 或唯一的 class):

<table class="table table-bordered table-striped" id="dailyTable"></table>

注意這裡刻意把 <thead> 與內容都留空,全部交給 JavaScript 產生。

JavaScript

在頁面元素渲染完成後取得 table,交給 DataTables 處理:

$(document).ready(function ($) {
  $('#dailyTable').DataTable({
    ajax: "../json/tableData.json",
    columns: [
      { title: "Rendering engine" },
      { title: "Browser" },
      { title: "Platform(s)" },
      { title: "Engine version" },
      { title: "CSS grade" }
    ]
  });
});

ajax 是資料的網址,這裡用本地相對路徑,當然也可以指向 HTTP 端點。columns 是一個陣列,定義表格的標題欄位,陣列有幾項就會顯示幾欄,格式必須是 {title: "xxx"}。

JSON 格式

資料格式為二維陣列,且必須包在 data 欄位之下。每個子陣列的項目順序要和 columns 中 title 的順序一致:

{
  "data": [
    ["Tiger Nixon", "System Architect", "Edinburgh", "5421", "2011/04/25", "$320,800"],
    ["Garrett Winters", "Accountant", "Tokyo", "8422", "2011/07/25", "$170,750"]
  ]
}

幾點實務提醒

欄位順序是隱含契約:二維陣列靠位置對應欄位,後端欄位順序一改前端就錯位。資料欄位多或會變動時,改用「物件陣列」格式([{"name":"Tiger", "position":"..."}] 搭配 columns: [{data: "name"}])會安全得多。

分頁有兩種模式:預設的 client-side 是把全部資料一次載入再在前端分頁,適合千筆以內;資料量大時應改用 server-side processing,由 DataTables 把分頁、排序、搜尋條件當參數送回伺服器,只取當前頁。切換方式是在初始化時加上 serverSide: true,並在後端依傳入的 start、length、order、search 參數回傳對應結果。

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