【文章內(nèi)容簡(jiǎn)介】 ，則列寬度使用 colModel 指定的寬度 sortable boolean 是否可排序 false 否 sortname string 排序列的名稱(chēng)，此參數(shù)會(huì)被傳到后臺(tái) 空字符串 是 sortorder string 排序順序，升序或者降序（ asc or desc） asc 是 subGrid boolean 是否使用 suggrid false 否 subGridModel array[] subgrid 模型 empty array 否 subGridType mixed 如果為空則使用表格的 dataType null 是 subGridUrl string 加載 subgrid 數(shù)據(jù)的 url， jqGrid 會(huì)把每行的 id值加到 url 中 空值 是 subGridWidth integer subgrid 列的寬度 20 否 toolbar array 表格的工具欄。數(shù)組中有兩個(gè)值，第一個(gè)為是否啟用，第二個(gè)指定工具欄位置（相對(duì)于 body layer），如： [true,”both”] 。工具欄位置可選值： “top”,”bottom”, “both”. 如果工具欄在上面，則工具欄 id 為 “t_”+ 表格 id；如果在下面則為 “tb_”+ 表格 id；如果只有一個(gè)工具欄則為 “t_”+ 表格 id [false,39。39。] 否 totaltime integer 只讀屬性，計(jì)算加載數(shù)據(jù)的時(shí)間。目前支持 xml跟 json 數(shù)據(jù) 0 否 treedatatype mixed 數(shù)據(jù)類(lèi)型，通常情況下與 datatype 相同，不會(huì)變 null 否 treeGrid boolean 啟用或者禁用 treegrid 模式 false 否 treeGridModel string treeGrid 所使用的方法 nested 否 treeIcons array 樹(shù)的圖標(biāo)，默認(rèn)值：{plus:39。uiicontriangle1e39。,minus:39。uiicontriangle1s39。,leaf:39。uiiconradiooff39。} 否 treeReader array 擴(kuò)展表格的 colModel且加在 colModel定義的后面 否 tree_root_level numeric root元素的級(jí)別， 0 否 url stri url null 是 ng userData array 從 request 中取得的一些用戶(hù)信息 empty array 否 userDataOnFooter boolean 當(dāng)為 true 時(shí)把 userData 放到底部，用法：如果userData 的值與 colModel 的值相同，那么此列就顯示正確的值，如果不等那么此列就為空 false 是 viewrecords boolean 是否要顯示總記錄數(shù) false 否 viewsortcols array 定義排序 列的外觀跟行為。數(shù)據(jù)格式：[false,39。vertical39。,true].第一個(gè)參數(shù)是說(shuō)，是否都要顯示排序列的圖標(biāo)， false 就是只顯示當(dāng)前排序列的圖標(biāo)；第二個(gè)參數(shù)是指圖標(biāo)如何顯示， vertical：排序圖標(biāo)垂直放置， horizontal：排序圖標(biāo)水平放置；第三個(gè)參數(shù)指單擊功能，true：?jiǎn)螕袅锌膳判颍?false：?jiǎn)螕魣D標(biāo)排序。說(shuō)明：如果第三個(gè)參數(shù)為 false 則第一個(gè)參數(shù)必須為 ture 否則不能排序 否 width number 如果設(shè)置則按此設(shè)置為主，如果沒(méi)有設(shè)置則按colModel 中定義的寬度計(jì)算 none 否 xmlReader array 對(duì) xml 數(shù)據(jù)結(jié)構(gòu)的描述 否 四、 jqGrid 學(xué)習(xí) ColModel API ColModel 是 jqGrid 里最重要的一個(gè)屬性，設(shè)置表格列的屬性。 用法： Java 代碼 1. jQuery(gridid).jqGrid({ 2. ... 3. colModel: [ {name:39。name139。, index:39。index139。...}, {...}, ... ], 4. ... 5. })。 屬性 數(shù)據(jù)類(lèi)型 備注 默認(rèn)值 align string 定義單元格對(duì)齊方式；可選值： left, center, right. left classes string 設(shè)置列的 css。多個(gè) class 之間用空格分隔，如： 39。class1 class239。 。表格默認(rèn)的 css 屬 empty string 性是 uiellipsis datefmt string 對(duì)日期列進(jìn)行格式化。 ”/”, ” ”, and ”.” 都是有效的日期分隔符。 y,Y,yyyy 年 YY, yy 月 m,mm for monthsd,dd 日 . ISO Date (Ymd) defval string 查詢(xún)字段的默認(rèn)值 空 editable boolean 單元格是否可編輯 false editoptions array 對(duì)列進(jìn)行編輯時(shí)設(shè)置的一些屬性 empty array editrules array 對(duì)于可編輯單元格的一些額外屬性設(shè)置 empty array edittype string 可以編輯的類(lèi)型?？蛇x值： text, textarea, select, checkbox, password, button, image and file. text fixed boolean 列寬度是否要固定不可變 false formoptions array 對(duì)于 form 進(jìn)行編輯時(shí)的屬性設(shè)置 empty formatoptions array 對(duì)某些列進(jìn)行格式化的設(shè)置 none formatter mixed 對(duì)列進(jìn)行格式化時(shí)設(shè)置的函數(shù)名或者類(lèi)型 none hidedlg boolean 是否顯示或者隱藏此列 false hidden boolean 在初始化表格時(shí)是否要隱藏此列 false index string 當(dāng)排序時(shí)定義排序字段名稱(chēng)的索引，參數(shù)名為 sidx empty string jsonmap string 定義了返回的 json 數(shù)據(jù)映射 none key boolean 當(dāng)從服務(wù)器端返回的數(shù)據(jù)中沒(méi)有 id 時(shí)，將此作為唯一 rowid 使用，默認(rèn)只能有一個(gè) id屬性 false label string 如果 colNames 為空則用此值來(lái)作為列的顯示名稱(chēng)，如果都沒(méi)有設(shè)置則使用 name 值 none name string 必輸項(xiàng)，表格列的名稱(chēng)，所有關(guān)鍵字，保留字都不能作為名稱(chēng)使用包括 subgrid, cb and rn. Required resizable boolean 是否可以被 resizable true search boolean 在搜索模式下，定義此列是否可以作為搜索列 true searchoptions array 設(shè)置搜索參數(shù) empty sortable boolean 是否可排序 true sorttype string 用在當(dāng) datatype 為 local 時(shí)，定義搜索列的類(lèi)型，可選值： int/integer 對(duì) integer排序 float/number/currency 排序數(shù)字date 排序日期 text 排序文本 text stype string 定義搜索元素的類(lèi)型 text surl string 搜索數(shù)據(jù)時(shí)的 url empty string width number 默認(rèn)列的寬度，只能是象素值，不能是百分比 150 xmlmap string 定義當(dāng)前列跟返回的 xml數(shù)據(jù)之間的映射關(guān)系 none unformat function ‘unformat’ 單元格值 null 有一些參數(shù)當(dāng)表格初始化完成后是不能被修改的： * name * width * resizable * label (method avail.) 五、 jqGrid 學(xué)習(xí) 數(shù)據(jù) jqGrid 可支持的數(shù)據(jù)類(lèi)型： xml、 json、 jsonp、 local or clientSide、 xmlstring、jsonstring 、 script、 function (?) 。 Json 數(shù)據(jù) 需要定義 jsonReader 來(lái)跟服務(wù)器端返回的數(shù)據(jù)做對(duì)應(yīng)，其默認(rèn)值： Java 代碼 1. jQuery(gridid).jqGrid({ 2. ... 3. jsonReader : { 4. root: rows, 5. page: page, 6. total: total, 7. records: records, 8. repeatitems: true, 9. cell: cell, 10. id: id, 11. userdata: userdata, 12. subgrid: {root:rows, 13. repeatitems: true, 14. cell:cell 15. } 16. }, 17.... 18.})。 這樣服務(wù)器端返回的數(shù)據(jù)格式： Java 代碼 1. { 2. total: xxx, 3. page: yyy, 4. records: zzz, 5. rows : [ 6. {id:1, cell:[cell11, cell12, cell13]}, 7. {id:2, cell:[cell21, cell22, cell23]}, 8. ... 9. ] 10.} jsonReader 的屬性 total 總頁(yè)數(shù) page 當(dāng)前頁(yè) records 查詢(xún)出的記錄數(shù) rows 包含實(shí)際數(shù)據(jù)的數(shù)組 id 行 id cell 當(dāng)前行的所有單元格 * root 這個(gè)元素指明表格所需要的數(shù)據(jù)從哪里開(kāi)始。 Java 代碼 1. jQuery(gridid).jqGrid({ 2. ... 3. jsonReader : {root:invdata}, 4. ... 5. })。 從服務(wù)器端返回?cái)?shù)據(jù)格式為： Java 代碼 1. { 2. total: xxx, 3. page: yyy, 4. records: zzz, 5. invdata : [ 6. {id:1, cell:[cell11, cell12, cell13]}, 7. {id:2, cell:[cell21, cell22, cell23]}, 8. ... 9. ] 10.} * page * total * records 定義翻頁(yè)所需要的信息 Java 代碼 1. jQuery(gridid).jqGrid({ 2. ... 3. jsonReader : { 4. root:invdata, 5. page: currpage, 6. total: totalpages, 7. records: totalrecords 8. }, 9. ... 10.})。 服務(wù)器端返回?cái)?shù)據(jù)： Java 代碼 1. { 2. totalpages: xxx, 3. currpage: yyy, 4. totalrecords: zzz, 5. invdata : [ 6. {id:1, cell:[cell11, cell12, cell13]}, 7. {id:2, cell:[cell21, cell22, cell23]}, 8. .