jqGrid中文文檔之選項設置
jqGrid提供了大量的選項設置,開發(fā)者可以通過設置選項對應值來控制jqGrid,比如表格的寬度、高度、數(shù)據類型以及列名稱等等都是通過選項設置來完成的。jqGrid的選項一般是名稱:值(name:value)的形式,也可以是對象(object)及數(shù)組(array)的形式配置。
jqGrid選項(Option)
調用jqGrid只需要執(zhí)行以下代碼:
jQuery("#grid_id").jqGrid(options);
options即jqGrid的選項設置,請參照以下表格。
屬性 | 類型 | 描述 | 默認值 |
ajaxGridOptions | object | 此項用于設置當表格設置獲得數(shù)據時,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時,對來自服務器的數(shù)據和提交數(shù)據進行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 | 描述列參數(shù)數(shù)組。這是表格最重要的部分,詳見colModel API. | null |
colNames | array[] | 列名稱數(shù)組。該名稱將在Header中顯示。名稱以逗號分隔,數(shù)量應與colModel 數(shù)組數(shù)量相等 | empty |
data | array | 以數(shù)組的形式保存本地數(shù)據。 | empty |
datastr | string | 當datatype被設置為xmlstring或jsonstring時,為數(shù)據串。 | null |
datatype | string | 定義表格希望獲得的數(shù)據的類型,有效值有: Xml —xml數(shù)據 xmlstring—xml字符串 json—JSON數(shù)據 jsonstring—JSON字符串 local—客戶端數(shù)據(數(shù)組) javascript—javascript數(shù)據 function—函數(shù)返回數(shù)據 |
xml |
deselectAfterSort | boolean | 只適用于當datatype為local時。當一個排序被應用時取消當前選定行。 | true |
direction | string | 表格中的書寫方向。“l(fā)tr”從左到右(缺省值),“rtl”從右到左 | ltr |
editurl | string | 定義行內編輯地址URL | null |
emptyrecords | string | 當返回(或當前)數(shù)量為零時顯示的信息此項只用當viewrecords 設置為true時才有效。 | |
ExpandColClick | boolean | true時,點擊展開行的文字,treeGrid展開或收攏 | true |
ExpandColumn | string | 指定用于張開treeGrid的列(名稱來自colModel),未設置即用第一列。此項只有當treeGrid為true時有效. | null |
footerrow | boolean | 如果設置為true時,將生成一個表腳行,列數(shù)等于colModel | false |
forceFit | boolean | 如果設置為true,改變列寬,相鄰列也將調整以適應整體表格,將不會出現(xiàn)水平滾動條。 | false |
gridstate | string | 表格的當前狀態(tài)。有visible或hidden | visible |
gridview | boolean | 設置為true將提高5~10倍的顯示速度。但不能再使用treeGrid, subGrid, 或afterInsertRow事件 | false |
grouping | boolean | 是否設置表格組 | false |
height | mixed | 表格高度??蔀閿?shù)值、百分比或auto | 150 |
hiddengrid | boolean | 如果設置為true,表格開始被隱藏,數(shù)據不被載入,只顯示標題。當?shù)谝淮吸c擊顯示/隱藏按鈕顯示表格,數(shù)據從服務器載入。 | false |
hidegrid | boolean | 是否允許顯示/隱藏按鈕可用。只有標題不為空時可用。 | true |
hoverrows | boolean | 表行是否有鼠標懸停效果 | true |
jsonReader | array | JSON數(shù)據結構數(shù)組 | |
lastpage | integer | 請求返回的總頁數(shù) | 0 |
lastsort | integer | 排序的列號(0開始) | 0 |
loadonce | boolean | 設置為true時,表格只一次讀取服務器數(shù)據(使用適當datatype),之后,datatype 自動變?yōu)閘ocal ,所有進一步操作都在客戶端完成,pager功能(若存在)將失效。 | false |
loadtext | string | 數(shù)據請求和排序時顯示的文本 | Loading… |
loadui | string | 此項控制ajax進程進行時的動作。Disable—取消jqGrid的進程指示,可使用自定義的指示。 enable (缺省)—表格中間顯示loading。 block – 顯示“Loading”信息,禁用頁面上的所有功能,直到數(shù)據裝入完成。 | enable |
mtype | string | 定義提交類型POST或GET | GET |
multikey | string | 此屬性只有當multiselect為true時有效,定義多選時的組合鍵,可選值有: shiftKey ,altKey,ctrlKey | empty |
multiboxonly | boolean | 此屬性只有當multiselect為true時有效,. Multiboxonly設置為true時,只有點擊checkbox時該行才被選中,點擊其他列,將清除當前行的選中。 | false |
multiselect | boolean | 此屬性設為true時啟用多行選擇,出現(xiàn)復選框 | false |
multiselectWidth | integer | 若multiselect 為true時,定義多選列的寬度。 | 20 |
page | integer | 設置請求初始頁的數(shù)量,此參數(shù)通過URL從服務器接受數(shù)據 | 1 |
pager | mixed | 定義分頁瀏覽導航條。必須是一個HTML元素,如<div id="page"></div> | empty |
pagerpos | string | 定義表格瀏覽導航條的位置,缺省情況下建立一個包括3部分的導航條:頁碼,導航按鈕和記錄信息。 | center |
pgbuttons | boolean | 定義導航激活時導航按鈕是否顯示。 | true |
pginput | boolean | 定義導航欄是否有頁碼輸入框。 | true |
pgtext | string | 當前頁信息。第一個量為當前頁,第二個量為總頁數(shù)。 | |
prmNames | array | 缺省情況下prmNames: { page:“page”,rows:“rows”, sort: “sidx”,order: “sord”, search:“_search”, nd:“nd”, npage:null} 以POST方式發(fā)送到服務器,字段為: page,rows,sidx,sord,search,nd 例如要將sidx改為mysort,可寫成: prmNames: {sort: “mysort”}. 這樣提交到服務器的字符串就變?yōu)椋?page=1&rows=10&mysort=myindex&sord=asc 若將一些參數(shù)設為null,這些參數(shù)將不再發(fā)往服務器。例如prmNames: { nd:null} 則nd參數(shù)將不被發(fā)送。 Npage參數(shù)參見scroll option. | none |
postData | array | 此數(shù)組能直接傳遞到url。這個數(shù)組可使用這種形式{name1:value1…}。 | empty |
reccount | integer | 只讀屬性。定義表格顯示的行數(shù)。切勿與records混淆。 | 0 |
recordpos | string | 定義頁中記錄信息的位置,可以是left,center,right。 | right |
recordpos | object | 交替行的類 | true |
records | integer | 只讀屬性。定義從請求中獲得的記錄數(shù) | none |
recordtext | string | 可在頁面上顯示的提示信息,此文字只在viewrecords 為true是有效,并且當記錄總數(shù)大于0時才顯示。 此文字中{}中的內容表示: {0} 該頁顯示的第一個記錄的記錄號 {1} 該頁顯示的最后一個記錄的記錄號 {2} 獲得的記錄總數(shù) |
|
resizeclass | string | 列可變大小時的類 | empty |
rowList | array[] | 用于改變顯示行數(shù)的下拉列表框的元素數(shù)組。 | empty |
rownumbers | boolean | 若此屬性為true,表格左側將添加一用于顯示行數(shù)(從1開始)的列。此時colModel自動擴展出一個名為rn的元素。所以在colModel中不要定義rn。 | false |
rowNum | integer | 表格中可見的記錄數(shù)。此參數(shù)通過url傳遞給服務器供檢索數(shù)據用。注意:若此參數(shù)設置為10,而服務器返回15條記錄,將只有10條記錄被裝入。若此參數(shù)被設置為-1,則此檢查失效 | 20 |
rownumWidth | integer | 當rownumbers為true時,定義顯示行數(shù)的列的寬度。 | 25 |
savedRow | array | 只讀屬性。用于行編輯和單元格編輯保存數(shù)據之前 | empty |
scroll | boolean or integer | 創(chuàng)建動態(tài)滾動表格。當設為啟用時,pager被禁用,可使用垂直滾動條來裝入數(shù)據。 | false |
scrollOffset | integer | 定義垂直滾動條的寬度。 | 18 |
scrollrows | boolean | 該項啟用時,用setSelection 選定一行,表格將滾動到被選行可見。 | false |
selarrrow | array-[] | 只讀屬性。當multiselect 為true時,包含當前選定的行。此為一維數(shù)組,值為表格中選定行的ID。 | empty |
selrow | string | 只讀屬性。內容是最后選定行的ID。如火應用了排序或pagging,該值為null。 | null |
shrinkToFit | boolean or integer | 該項描述計算每列相對于表格寬度的初始寬度的類型。 若為true,并且設置了列寬度,則每列的寬度根據定義寬度縮放。 若為false,并且設置了列寬度,表格寬度為設置寬度,列寬度不會重新計算,使用colModel中定義的值 |
true |
sortable | object | 啟用此項,允許使用鼠標重新排序列。 | true |
sortname | string | 從服務器讀取XML或JSON數(shù)據時初始的排序名,此名被加到URL中。 | empty |
sortorder | string | 從服務器讀取XML或JSON數(shù)據時初始的排序類型,此類型被加到URL中??蛇x值為asc或desc。 | asc |
subGrid | boolean | 設置為true,可使用子表格。啟用子表格,將在基本表的左邊將添加一列,并包含一個“+”圖像,用戶可以點擊擴展行。 | false |
subGridModel | array-[] | 該屬性用于描述子表格的模式,只有subGrid 為true時有效。它是一個用于描述子表格列的數(shù)組。 | empty |
subGridType | mixed | 用于定義子表格裝入的數(shù)據類型,若不定義,則使用與父表格同樣的數(shù)據類型。 | null |
subGridUrl | string | 該屬性用于定義子表格獲得數(shù)據的URL。行的ID將鍵入此URL中,若要添加其他參數(shù),可使用subGridModel 中的選項。 | empty |
subGridWidth | integer | 定義子表格的列寬 | 20 |
toolbar | array | 該參數(shù)定義表格的工具欄。參數(shù)是一個包含兩個值的數(shù)組,第一個值使工具欄有效,第二個值相對位置(可以是top、bottom、both)。例如:設置toolbar為 [true,”both”],將在表格的頭部和底部建立兩個工具欄,兩個工具欄位兩個DIV元素,頭部DIV元素的ID為“t_表格ID”,底部DIV元素的ID為“tb_表格ID”。若只有一個工具欄(top或bottom)時,DIV的ID為“t_表格ID”。 | [false,''] |
toppager | boolean | 是否在表格上部顯示分頁條。 | false |
totaltime | integer | 只讀參數(shù)。用于記錄裝入XML和JSON數(shù)據的時間。 | 0 |
treedatatype | mixed | 定義初始數(shù)據類型 | null |
treeGrid | boolean | 啟用(禁用)TreeGrid。 | false |
treeGridModel | string | 定義TreeGrid的方法??梢允莕ested或adjacency。 | nested |
treeIcons | array | 此數(shù)組設置TreeGrid中使用的圖標。圖標應是UI theme中的有效圖標。缺省為 {plus:'ui-icon-triangle-1-e',minus:'ui-icon-triangle-1-s',leaf:'ui-icon-radio-off'} | |
treeReader | array | 擴展表格的colModel。這里定義的字段將添加到colModel的尾部并隱藏。服務器將返回這些字段的值。 | |
tree_root_level | numeric | 確定treeGrid相對于根元素的級別。 | 0 |
url | string | 請求數(shù)據的url地址 | null |
userData | array | 此數(shù)組保存請求的自定義信息,可隨時使用 | empty |
userDataOnFooter | boolean | 到為true時, userData直接放置在頁腳。 | false |
viewrecords | boolean | 是否在瀏覽導航欄顯示記錄總數(shù) | false |
viewsortcols | array | 定義表頭中排序圖標的外觀和行為。缺省為[false,'vertical',true]。 第一個參數(shù)設定是否顯示所有定義了排序的列旁顯示圖標。缺省的false表示只有當前排序列旁的圖標顯示。設為true可使所有可排序列都顯示圖標。 第二個參數(shù)設定排序圖標如何放置。vertical為垂直放置,horizontal為水平放置。 第三個參數(shù)設定點擊功能。True表示表頭點擊排序,false表示只點擊排序圖標排序。若將此參數(shù)設為false時,請確保第一個參數(shù)為true,否則將無法排序。 |
|
width | number | 若為設置,表格的寬度為colModel 中定義的所有列寬度的總和。若設置了該項,每列的初始寬度按照shrinkToFit 設置的值 | none |
xmlReader | array | 描述預期的XML數(shù)據結構的數(shù)組。 |
ColModel API
colModel屬性以數(shù)組的形式定義各個表格列。這是jqGrid中很重要的部分。語法為:
jQuery("#gridid").jqGrid({ ... colModel: [ {name:'name1', index:'index1'...}, {...}, ... ], ... });
下面給大家介紹jqGrid提供的事件列表。
事件 | 參數(shù) | 描述 |
afterInsertRow | rowid rowdata rowelem |
此事件發(fā)生在每次插入行后 rowid 為插入的行ID rowdata 是被插入行的數(shù)據數(shù)組。格式為name:value對,name在colModel定義 rowelem 是應答元素。xml為xml行,json為所有行數(shù)據。 注意:若gridview 為true,此事件不會發(fā)生 |
beforeRequest | none | 此事件發(fā)生在任何數(shù)據請求前,但當datatype為function時不發(fā)生。 |
beforeSelectRow | rowid, e | 此事件發(fā)生在用戶點擊行,選中該行前。 rowid 為行的ID,e為事件對象 該事件將返回布爾值true(行被選中)或false(行未被選中)。 |
gridComplete | none | 此事件發(fā)生在表格所有數(shù)據裝入和進程完成后。與datatype參數(shù)及排序分頁等無關。 |
loadBeforeSend | xhr, settings |
此事件發(fā)生在XMLHttpRequest被發(fā)送前,用于修改對象屬性(如headers)。 xhr 為XMLHttpRequest對象。 |
loadComplete | data | 此事件發(fā)生在每個服務器請求后。xhr 為XMLHttpRequest對象。 |
loadError | xhr, status, error |
此事件在請求失敗時發(fā)生。事件有3個參數(shù): xhr 為XMLHttpRequest對象; Satus 為錯誤類型描述;error 為錯誤對象。 |
onCellSelect | rowid, iCol, cellcontent, e |
此事件在點擊表格特定單元格時發(fā)生。 rowid 為行ID;iCol 為列索引; cellcontent 為單元格中內容; e 點擊事件對象。 |
ondblClickRow | rowid, iRow, iCol, e |
此事件發(fā)生在行雙擊后發(fā)生。 rowid為行ID;iRow 為行索引(勿與rowid混淆); iCol為列索引; e 為事件對象。 |
onHeaderClick | gridstate | 此事件發(fā)生在點擊顯示或隱藏表格后發(fā)生(hidegrid為true) gridstate為表格狀態(tài),有visible和hidden兩個值 |
onPaging | pgButton | 此事件發(fā)生在點擊page button后,填充數(shù)據前,及用戶輸入一個與當前頁頁碼不同的新頁碼并回車時。 |
onRightClickRow | rowid, iRow, iCol, e |
此事件發(fā)生在右擊行后。(此事件在Opera瀏覽器中無效) rowid為行ID;iRow為行索引(勿與rowid混淆) iCol為列索引; e為事件對象 |
onSelectAll | aRowids, status |
此事件發(fā)生在點擊標題的復選框時發(fā)生(multiselect為true) aRowids 選定行ID的數(shù)組(哪些行的復選框與頭復選框相同) status 頭復選框的選定的布爾值,true為選中,false為 |
onSelectRow | rowid, status |
此事件發(fā)生在行點擊后 rowid 為行ID; status 為選擇狀態(tài)。當multiselect為true時使用,當行被選中時返回true;為選中時返回false。 |
onSortCol | index, iCol, sortorder |
此事件發(fā)生在列排序被點擊之后,數(shù)據排序前 index 為colModel 中定義的索引名iCol 為列的索引號 sortorder 為新的排序方式,asc或desc |
resizeStart | event, index | 此事件發(fā)生在列被重新定義寬度時。 event 為事件對象;index 為在colModel 中定義的列索引。 |
resizeStop | newwidth, index | 此事件發(fā)生在列被重新定義寬度后。 newwidth 為新的列寬度;index 為在colModel 中定義的列索引。 |
serializeGridData | postData | 通過此事件可以序列化傳遞給ajax請求的的數(shù)據。此事件將返回一個以序列化的數(shù)據。若有自定義的數(shù)據(如JSON字符串、XML字符串)要發(fā)給服務器時,可使用該事件。 |
- JQGrid的用法解析(列編輯,添加行,刪除行)
- jqgrid 編輯添加功能詳細解析
- Jqgrid設置全選(選擇)及獲取選擇行的值示例代碼
- jqGrid隨窗口大小變化自適應大小的示例代碼
- jqGrid讀取選擇的多行的某個屬性代碼
- 通過點擊jqgrid表格彈出需要的表格數(shù)據
- jqGrid表格應用之新增與刪除數(shù)據附源碼下載
- Jqgrid之強大的表格插件應用
- 基于PHP和Mysql相結合使用jqGrid讀取數(shù)據并顯示
- jqGrid 學習筆記整理——進階篇(一 )
- Java中jqGrid 學習筆記整理——進階篇(二)
- Bootstrap嵌入jqGrid,使你的table牛逼起來
- jqGrid用法匯總(全經典)
相關文章
jqPaginator結合express實現(xiàn)分頁展示內容效果
這篇文章主要為大家詳細介紹了jqPaginator結合express實現(xiàn)分頁展示內容效果,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-04-04jQuery getJSON 處理json數(shù)據的代碼
Ashx處理程序:如果需要返回json格式的對象,需要把mime類型設置為:"application/json"。2010-07-07