配置項 | 類型 | 描述 | 默認值 |
---|---|---|---|
align | string | 定義單元格中內容對齊方式,可用值: left, center, right. | left |
cellattr | function | 這個方法在創建單元格內容的時候給單元格添加附加到屬性。所有可用的單元格屬性或者style屬性中可用的值都可以使用,這個方法需要返回字符串。傳遞進入這個配置方法的參數如下 rowId - 單元格所屬行id val - 顯示在單元格中的值 rawObject -原始的數據行對象。如果jqGrid配置中datatype為json,則為array對象。datatype為xml時則為xml node節點 cm - 所有colModel中配置的屬於此列的屬性 rdata - the data row which will be inserted in the row. 參數為鍵值對對象數組,name為colModel定義的name |
null |
classes | string | 給單元格添加附加樣式。如果有多個樣式需要添加,樣式用空格隔開。例如:classes:'class1 class2' 將會給此列單元格設置class1和class2樣式。在css中有一個預定義的樣式ui-ellipsis允許附加到特定的行 | empty string
|
datefmt | string | sorttype配置為date(datetype被設置為local)或者editrules 配置為{date:true} 字段時,定義日期的顯示格式。使用如php類型的時間格式。“/”,“-”,“.”可用於的時間分隔符號。可用的時間格式如下 y,Y,yyyy :對應4位數字的年份 YY, yy :對應2位數字的年份 m,mm :對應月份 d,dd :對應日期 |
ISO Date (Y-m-d) |
defval | string | 作為搜索字段的默認值。只用於自定義搜索時的初始值。 | empty |
editable | boolean | 定義字段是否可以編輯。用於單元格,行編輯,和表單編輯。 參考:jqGrid通用編輯規則 | false |
editoptions | array | 依據edittype提供允許的值列表。 參考:jqGrid通用編輯規則 | empty array |
editrules | array | 給可編輯子都設置附加的規則。 參考:jqGrid通用編輯規則 | empty array |
edittype | string | 給行,表單編輯配置字段編輯類型。可能的值: text, textarea, select, checkbox, password, button, image and file。參考:jqGrid通用編輯規則 | text |
firstsortorder | string | 設置為asc或者desc時,初始化時列將會按照這個進行排序。 隨后排序將會輪流切換。 | null |
fixed | boolean | 即使jqGrid的shrinkToFit配置為ture時,當此配置為true,也不允許重新計算列的寬度。如果shrinkToFit為true,當jqGrid容器寬度變化后調用setGridWidth 方法也不會修改此列寬度。 | false |
formoptions | array | 定義表單編輯時的配置 參考: Form options | empty |
formatoptions | array | 重寫默認配置語言文件中的配置項。 參考:jqGrid預定義格式化類型 | none |
formatter | mixed | 默認類型(string)或者客戶自定義函數控制此字段的顯示格式。 參考:jqGrid預定義格式化類型 | none |
frozen | boolean | 設置為ture,此列將為固定的,不允許拖拽改變位置。 | false |
hidedlg | boolean | 設置為true此列將不會出現在模式對話框中,用戶可以選擇此列的顯示或者隱藏。參考:jqGrid顯示和隱藏列 | false |
hidden | boolean | 定義是否隱藏此列在初始化時。 | false |
index | string | 通過sidx參數設置排序時的索引名。詳細參考:jqGrid選項配置中的prmNames和sortname配置 | empty string |
jsonmap | string | 定義此列數據鍵和json數據源中的映射關系 。參考:jqGrid JSON數據源讀取器選項配置 | none |
key | boolean | 如果從服務器獲取的數據部包含id,可以通過此配置指定唯一id列。只有一列能指定此屬性,如果多列配置了這個屬性,第一個配置的生效,后續會被忽略。 | false |
label | string | 如果jqGrid的colNames數組為空,這個將作為此列的列頭。如果colNames和這個配置為空,那name配置將作為此列的列頭。 | none |
name | string | 設置此列的唯一名稱。name是必須的。jqGrid配置的事件名稱和屬性名稱,保留字不能作為此配置項的值,包括subgrid,cb和rn。 | Required |
resizable | boolean | 定義此列是否允許調整寬度 | true |
search | boolean | 當配置了查詢模塊后,是否允許將此列作為查詢條件. Search Configuration | true |
searchoptions | array | 定義查詢選項 Search Configuration | empty |
sortable | boolean | 定義是否允許點擊列表頭進行排序 | true |
sorttype | mixed | 當datatype為local時有效。定義適當的排序類型。可用值 int/integer :按照整數排序 float/number/currency:按照數字排序 date :日期排序 text :文本排序 function :按照自定義函數來排序。自定義函數接受此列排序的值,需要返回一個值。【原文: To this function we pass the value to be sorted and it should return a value too.】應該和javascript數組排序使用函數作為參數排序差不多,return-1/0/1 |
text |
stype | string | 定義查詢對象的類型。 See Search Configuration | text |
surl | string | Custom Searching 中有效 和edittype為 'select' 時這個配置從哪個動態頁地址獲取已經生成好的select html結構。 | empty string |
template | object | 設置colModel有效屬性。當你希望覆蓋列模式默認值時配置這個比較有用。 See cmTemplate in grid options | null |
title | boolean | 如果設置為false,當鼠標移動到單元格上時不顯示title提示信息。 | true |
width | number | 設置初始化列寬,單位px。注意不能設置為百分比 | 150 |
xmlmap | string | 定義此列和xml文件中的xml節點映射。參考:jqGrid XML數據源讀取器選項配置 | none |
unformat | function | 返回單元格的原始值,詳細參考:jqGrid自定義格式化類型(在排序時也會調用unformat,在排序過程中返回值用於比較) | null |
viewable | boolean | 此配置僅在viewGridRow 方法下有效。當配置為false時此列不會出現在view Form中。 | true
|
需求:設置改grid的第一列為標題列