DIV CSS 佈局教程網

jQuery 表格插件 DataTables 用法整理大全
編輯:關於JavaScript     

DataTables 是一款功能強大的 jQuery 表格插件。本文整理了它的基礎用法,從初始化到常用設定,適合剛入門的開發者參考。

一、初始化

先在頁面中引入 CSS 與 JS:

 <!DOCTYPE html> <html> <head> <link rel="stylesheet" type="text/css" href="//cdn.datatables.net/1.10.11/css/jquery.dataTables.css"> <script type="text/javascript" charset="utf8" src="//cdn.datatables.net/1.10.11/js/jquery.dataTables.js"></script> </head> <body> <table id="table_id" class="display"> <thead> <tr> <th>Column 1</th> <th>Column 2</th> </tr> </thead> <tbody> <tr> <td>Row 1 Data 1</td> <td>Row 1 Data 2</td> </tr> <tr> <td>Row 2 Data 1</td> <td>Row 2 Data 2</td> </tr> </tbody> </table> </body> </html> 

接著在 js 中初始化:

 $(document).ready( function () { $('#table_id').DataTable(); } ); 

二、常用設定

初始化時可以透過一堆設定項來調整表格行為,以下是我在實際專案裡用到的:

 $("#vivo_table_list").dataTable({ pageLength: 10, //更改初始頁面長度 (每頁的行數) processing: true, //顯示正在處理字符串 serverSide: false, // 服務器模式,這一點非常奇怪* ordering: true, // 是否啟用Datatables排序 searching: false, // 開啟搜索 autoWidth: false, zeroRecords: "沒有查詢數據", destroy: true, // 從當前上下文銷毀掉Datatables對象 (妹搞懂) pagingType: "input", // 分頁按鈕種類顯示選項 language: { url: "cn.txt" // 本地化 }, dom: "tr<'row-fluid'<'span6'i><'span6'p>>", // 按什麼順序定義表的控制元素在頁面上出現(妹搞懂) ajax: { url: "/url", type: "post", // ajax請求的類型 ** data: function () { return that.getQueryParams(); // ajax的參數 } }, columns: [ {title: "id", data: "id", orderable: true}, {title: "uid", data: "uid", orderable: false}, {title: "昵稱", data: "nick", orderable: false}, {title: "姓名", data: "name", orderable: false}, {title: "電話", data: "tel", orderable: false}, {title: "申請時間", data: "stimeshow", orderable: true}, {title: "狀態", data: "statshow", orderable: false}, { title: "操作", orderable: false, render: function (data,type,full) { return '<button id="msgsndButton" class="msgsnd glyphicon glyphicon-comment"></button>' + ' <button id="forbidButton" class="forbid glyphicon glyphicon-thumbs-down"></button>'+ '<input type="hidden" value="'+full.id+'"/>'; } } ] }); 

後端回傳的資料必須是一個 map,key 為 "data"、value 為實際資料(若資料是 List 記得 toArray())。data 本身就是 DataTables 的參數之一,代表表格要顯示的內容,所以你也能在這個 map 裡塞入其他表格參數,只要把 key 設成參數名即可。

*:開啟 serverSide 伺服器模式後,表格資料透過 ajax 從後端取得,看似理所當然,但卻會讓某一列的排序功能失效;後來我把它關掉,反而可以正常排序,而且資料一樣是從伺服器抓的……所以這個模式的細節還值得再研究。

**:專案裡後端 controller 接收的是陣列參數,因此當 ajax 帶有較複雜的參數時,請求類型務必設為 post。

三、進階功能

1、隱藏列。可以用 "columns.visible" 決定某列是否顯示,但這樣就拿不到該列的值。若想隱藏 id 列卻又要靠 id 觸發事件就行不通了。後來查了 API,想到一個笨辦法:借用 columns.render,用法如下:

 { title: "操作", orderable: false, render: function (data,type,full) { return '<input type="hidden" value="'+full.id+'"/>'; } } 

注意 render 後的函式有三個參數 data/type/full,其中 full 是該「列」的所有資料(官網特別註明:是列中的資料,而非 data 屬性的值,所以就算 data 裡有你想要的欄位,但沒給它一列的話也拿不到)。你可以在 render 中直接使用想隱藏的值;若表格外部要引用,就在 render 裡組裝一個隱藏的 <input>,外部就能讀取——雖然這方法挺笨,但如果你有更漂亮的解法,歡迎分享。

2、輸入頁碼跳轉頁面。我們能用 pagingType 設定分頁按鈕樣式,但 DataTables 預設的幾種樣式都沒有「輸入頁碼跳轉」這種。官網的 plug-in 頁面提供了幾款分頁插件,其中的 input 分頁插件正好能滿足需求:只要引入該插件 js,再把 pagingType 設為 "input" 即可。CDN 位址為:

//cdn.datatables.net/plug-ins/1.10.11/pagination/input.js

以上就是本文整理的全部內容,希望對你的學習有所幫助。想深入了解可參考 DataTables 官網。

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