jqGrid提供了大量的選項設置,開發者可以通過設置選項對應值來控制jqGrid,比如表格的寬度、高度、數據類型以及列名稱等等都是通過選項設置來完成的。jqGrid的選項一般是名稱:值(name:value)的形式,也可以是對象(object)及數組(array)的形式配置。
jqGrid選項(Option)
調用jqGrid只需要執行以下代碼:
jQuery("#grid_id").jqGrid(options);options即jqGrid的選項設置,請參照以下表格。
| 屬性 | 類型 | 描述 | 默認值 |
| ajaxGridOptions | object | 此項用于設置當表格設置獲得數據時,ajax的全局屬性,注意此項可能覆蓋所有當前的ajax設置(包括error, complete和beforeSend 事件)。 | empty |
| ajaxSelectOptions | object | 此項用于設置在editoptions或searchoptions對象中通過dataUrl選擇元素時, ajax的全局屬性。 | empty |
| altclass | string | 交替行的類。 此項僅當altRows設置為true時有效。 | ui-priority-secondary |
| altRows | boolean | 設置為交替行表格 | false |
| autoencode | boolean | 當設置為true時,對來自服務器的數據和提交數據進行encodes編碼。如< 將被轉換為< | false |
| autowidth | boolean | 當設置為true時,表格寬度將自動匹配到父元素的寬度。這個匹配只在表格建立時進行,為了使表格在父元素寬度變化時也隨之變化,可以使用setGridWidth方法 | false |
| caption | string | 表格的標題。顯示在Header上。若為空時將不會顯示。 | empty |
| cellLayout | integer | 該屬性確定單元格的padding + border 寬度。通常不修改該屬性,但若表格的CSS中改變了td元素,該屬性需要修改。 缺省值5表示paddingLef(2) + paddingRight(2) + borderLeft(1)=5 | 5 |
| cellEdit | boolean | 是否允許單元格編輯。 | false |
| cellsubmit | string | 確定單元格內容保存方式是remote還是clientArray 。 | 'remote' |
| cellurl | string | 單元格保存的url。 | null |
| colModel | array | 描述列參數數組。這是表格最重要的部分,詳見colModel API. | null |
| colNames | array[] | 列名稱數組。該名稱將在Header中顯示。名稱以逗號分隔,數量應與colModel 數組數量相等 | empty |
| data | array | 以數組的形式保存本地數據。 | empty |
| datastr | string | 當datatype被設置為xmlstring或jsonstring時,為數據串。 | null |
| datatype | string | 定義表格希望獲得的數據的類型,有效值有: Xml ―xml數據 xmlstring―xml字符串 json―JSON數據 jsonstring―JSON字符串 local―客戶端數據(數組) javascript―javascript數據 function―函數返回數據 | xml |
| deselectAfterSort | boolean | 只適用于當datatype為local時。當一個排序被應用時取消當前選定行。 | true |
| direction | string | 表格中的書寫方向?!發tr”從左到右(缺省值),“rtl”從右到左 | ltr |
| editurl | string | 定義行內編輯地址URL | null |
| emptyrecords | string | 當返回(或當前)數量為零時顯示的信息此項只用當viewrecords 設置為true時才有效。 | |
| ExpandColClick | boolean | true時,點擊展開行的文字,treeGrid展開或收攏 | true |
| ExpandColumn | string | 指定用于張開treeGrid的列(名稱來自colModel),未設置即用第一列。此項只有當treeGrid為true時有效. | null |
| footerrow | boolean | 如果設置為true時,將生成一個表腳行,列數等于colModel | false |
| forceFit | boolean | 如果設置為true,改變列寬,相鄰列也將調整以適應整體表格,將不會出現水平滾動條。 | false |
| gridstate | string | 表格的當前狀態。有visible或hidden | visible |
| gridview | boolean | 設置為true將提高5~10倍的顯示速度。但不能再使用treeGrid, subGrid, 或afterInsertRow事件 | false |
| grouping | boolean | 是否設置表格組 | false |
| height | mixed | 表格高度??蔀閿抵?、百分比或auto | 150 |
| hiddengrid | boolean | 如果設置為true,表格開始被隱藏,數據不被載入,只顯示標題。當第一次點擊顯示/隱藏按鈕顯示表格,數據從服務器載入。 | false |
| hidegrid | boolean | 是否允許顯示/隱藏按鈕可用。只有標題不為空時可用。 | true |
| hoverrows | boolean | 表行是否有鼠標懸停效果 | true |
| jsonReader | array | JSON數據結構數組 | |
| lastpage | integer | 請求返回的總頁數 | 0 |
| lastsort | integer | 排序的列號(0開始) | 0 |
| loadonce | boolean | 設置為true時,表格只一次讀取服務器數據(使用適當datatype),之后,datatype 自動變為local ,所有進一步操作都在客戶端完成,pager功能(若存在)將失效。 | false |
| loadtext | string | 數據請求和排序時顯示的文本 | Loading… |
| loadui | string | 此項控制ajax進程進行時的動作。Disable―取消jqGrid的進程指示,可使用自定義的指示。 enable (缺省)―表格中間顯示loading。 block 主站蜘蛛池模板: 会宁县| 珲春市| 犍为县| 额尔古纳市| 蒲城县| 海伦市| 皋兰县| 大洼县| 康马县| 绥棱县| 泰宁县| 佛冈县| 张掖市| 贵阳市| 江北区| 西华县| 宁德市| 出国| 江安县| 永丰县| 合作市| 浦城县| 晋城| 莱州市| 永安市| 丰顺县| 南郑县| 高雄县| 清丰县| 英山县| 江北区| 五常市| 彭阳县| 宜州市| 田林县| 都兰县| 稷山县| 肇东市| 黄浦区| 溧水县| 新营市| |