jqGrid 是 jQuery 時代相當流行的一套表格(grid)插件,具備排序、分頁、多選、列編輯、子表格等能力,並與 jQuery UI 主題系統整合。這篇以「純本地資料」為例,帶你看最基礎的用法。
官方 Demo:https://www.trirand.com/blog/jqgrid/jqgrid.html

頁面程式碼
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>本地資料</title>
<link href="css/redmond/jquery-ui-1.8.14.custom.css" rel="Stylesheet" />
<link href="css/ui.jqgrid.css" rel="Stylesheet" />
<script type="text/javascript" src="js/jquery-1.6.2.min.js"></script>
<script type="text/javascript" src="js/jquery-ui-1.8.14.custom.min.js"></script>
<script type="text/javascript" src="js/jquery.jqGrid.min.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("#list1").jqGrid({
datatype:"local",
height:250,
colNames:['自動編號','地區編號','地區名稱','所屬城市編號'],
colModel:[
{name:'id',index:'id',width:60,sorttype:"int"},
{name:'areaID',index:'areaID',width:80,sortable:false},
{name:'area',index:'area',width:180},
{name:'father',index:'father',width:100,sortable:false}
],
multiselect:true,
caption:"中國各城市的主要地區"
});
var mydata=[
{id:"1",areaID:'110101',area:'東城區',father:'110100'},
{id:"2",areaID:'110102',area:'西城區',father:'110100'},
{id:"3",areaID:'110103',area:'崇文區',father:'110100'},
{id:"4",areaID:'110104',area:'宣武區',father:'110100'},
{id:"5",areaID:'110105',area:'朝陽區',father:'110100'},
{id:"6",areaID:'110106',area:'豐台區',father:'110100'},
{id:"7",areaID:'110107',area:'石景山區',father:'110100'},
{id:"8",areaID:'110108',area:'海澱區',father:'110100'},
{id:"9",areaID:'110109',area:'門頭溝區',father:'110100'},
{id:"10",areaID:'110111',area:'房山區',father:'110100'}
];
for(var i=0; i<mydata.length; i++)
{
$("#list1").jqGrid('addRowData',i+1,mydata[i]);
}
});
</script>
</head>
<body>
<table id="list1"></table>
<div id="pager1"></div>
</body>
</html>
兩個必懂的設定
colNames 與 colModel 成對出現
colNames 是表頭顯示文字,colModel 是每一欄的行為定義,兩者順序必須一一對應、數量相同,否則欄位會錯位。
colModel 裡 name 與 index 的差別
這是新手最容易混淆的地方:name 是前端使用的欄位鍵名,同時也是資料物件對應的屬性名稱;index 則是「送給後端排序時要用的欄位名」。當你只處理本地資料時兩者可以一樣,但一旦改成遠端分頁(datatype: "json"),jqGrid 會把 index 當作 sidx 參數送出,這時若沒設定,後端就無從排序。
其他常用屬性:sortable: false 關閉該欄排序、sorttype: "int" 指定以整數而非字串比較(避免 10 排在 9 前面)、width 控制欄寬、hidden: true 隱藏欄位但仍保留資料。
datatype 決定資料來源
"local" 表示資料就在頁面裡,用 addRowData 一筆筆塞入。若改成 "json" 或 "xml",還要再設定 url、postData、jsonReader 等,並搭配 pager 完成伺服器端分頁。
實務提醒
jqGrid 的商業使用需要注意授權(GPL 與商用 dual license),上專案前請先確認條款。此外這個範例綁的是 jQuery 1.6.2 與 jQuery UI 1.8.14,屬相當早期的版本;若要維護新專案,可考慮仍在活躍維護的分支(如 free-jqgrid / Guriddo)或改用整合度更好的方案。表格類元件特別容易忽略無障礙,記得確認表頭有正確的 scope 或 aria-sort,讓螢幕閱讀器能朗讀排序狀態。