jqGrid 屬性(二)

該屬性不能修改

　　savedRow

　　array

　　唯讀屬性。本屬性用在Inline Editing和Cell Editing模式下，用來在編輯行或者儲存格之前儲存資料。

　　預設值:empty array

　　該屬性不能修改 scroll

　　boolean or integer

　　建立一個動態滾動的grid。如果本屬性可用，pager元素被禁用，改用垂直捲軸來動態載入資料。當設定為true時，grid會在第一次載入的時候，把所有的資料取出到用戶端，當scroll被設定為一個數字，grid將只顯示可見的幾行資料。

　　請注意，這裡有一個可選的擴充參數npage傳遞到伺服器端。如果在prmNames數組中設定了npage的值，那麼grid將一次請求多頁資料。所以這裡伺服器端的按頁擷取資料的方法需要特別注意處理。

　　預設值:false

　　該屬性不能修改

　　scrollOffset

　　integer

　　設定垂直捲軸寬度。

　　預設值:18

　　該屬性不能修改.Method avail.

　　scrollrows

　　boolean

　　設定為true，當我們用setSelection選中記錄時，grid會自動滾動到選中的行記錄，讓該行記錄可見。假設grid有垂直捲軸，當我們在 Form Editing編輯模式下修改記錄，用編輯頁的前後導覽按鈕定位記錄的時候，當導航到一個隱藏的行記錄的時候，grid會自動滾動以使讓選中的行記錄變成可見。

　　預設值:false

　　該屬性可以修改

　　selarrrow

　　array-[]

　　唯讀屬性。在multiselect=true的情況下，確定當前選中的所有行。數組中包含的值只是選中列的id，用逗號隔開。比如[1,3,4,5]表示選中了id為1、3、4、5的行。

　　預設值:empty array []

　　該屬性不能修改

　　selrow

　　string

　　唯讀屬性。最後選中行的id。如果重新排序或者進行了導航，這個值為null。（也就是沒有選中任何行的意思！）

　　這個屬性很重要，很多時候，假設我們要對選中的行的資料進行一些處理，那麼就必須要用到這個屬性。大家可以看看jqGrid的Demo中有很多例子都用到這個屬性。

　　預設值:null

　　該屬性不能修改

　　shrinkToFit

　　boolean

　　確定初始化時候每列的寬度的演算法。如果設定為true，表示每列的寬度按照所有列設定的寬度值的和與grid設定的寬度按比例進行縮放。如果設定為false，則列寬按照colModel中設定的寬度顯示。

　　預設值:true

　　該屬性不能修改

　　sortable

　　boolean

　　設定grid是否可以按照列進行排序。這個屬性用到了jQuery UI的sortable外掛程式。要確保載入了相應的檔案，同時要確保下載jqGrid的時候，包含了grid.jqueryui.js包。

　　預設值:false

　　該屬性不能修改

　　sortname

　　string

　　當使用xml或者json資料類型時，設定預設的排序欄位名稱。這個參數會被增加到url上傳遞到伺服器端。

　　預設值:empty string

　　該屬性可以修改

　　sortorder

　　string

　　當使用xml或者json資料類型時，設定預設的排序方式。可選值asc或desc.

　　預設值:asc

　　該屬性可以修改

　　subGrid

　　boolean

　　設定是否能使用subgrid。

　　預設值:false

　　該屬性不能修改

　　subGridModel

　　array-[]

　　設定subGrid的描述資訊。只在subGrid設定為true才有效。具體可設定的屬性需要參考subGrid的文檔。

　　預設值:empty array

　　該屬性不能修改

　　subGridType

　　mixed

　　允許通過一個service來載入subgrid。如果沒有設定，則採用父grid的datatype。

　　預設值:null

　　該屬性可以修改

　　subGridUrl

　　string

　　載入subgrid資料的url，jqGrid會把每行的id值當作參數加到url中。只有在subGrid=true是才有效。如果需要傳遞額外的參數，請使用subGridModel中的params選項。

　　預設值:empty string

　　該屬性可以修改

　　subGridWidth

　　integer

　　設定subGrid列的寬度。

　　預設值:20

　　該屬性不能修改

　　toolbar

　　array

　　Grid的工具列。數組中有兩個值，第一值指示toolbar是否可用，第二個值定義了toolbar相對於body Layer的位置，可能的值包括“top”,”bottom”, “both”

　　當我們設定值為[true,”both”]，會建立兩個工具列，一個在table的頂部，一個在table的底部。

　　頂部的工具列的div的id等於”t_”+grid的Id。底部的工具列的div的id等於”tb_” +grid的Id。 注意：當只建立一個工具列的時候，不管位置是在頂部還是底部，工具列的div的id都等於”t_”+grid的Id。

　　預設值:[false,'']

　　該屬性不能修改

　　totaltime

　　integer

　　唯讀屬性。計算載入資料的時間。目前只支援載入xml以及json格式資料。從請求完成開始計算時間，到載入完最後一行記錄截至。

　　預設值:0

　　該屬性不能修改

　　treedatatype

　　mixed

　　樹形grid情況下，datatype。通常與grid自身定義的datatype保持一致。很少會改變。

　　預設值:null

　　該屬性不能修改

　　treeGrid

　　boolean

　　開啟或者禁用樹形grid的模式。

　　預設值:false
該屬性不能修改

　　treeGridModel

　　string

　　確定treeGrid的方法。可能是nested或 adjacency

　　預設值:nested

　　該屬性不能修改

　　treeIcons

　　array

　　樹形grid使用的表徵圖。預設值是{plus:'ui-icon-triangle-1-e',minus:'ui-icon-triang le-1-s',leaf:'ui-icon-radio-off'}

　　預設值：無

　　該屬性不能修改

　　treeReader

　　array

　　擴充grid的colModel且加在colModel定義的後面這意味著從伺服器返回的資料必須包含這些欄位值。

　　預設值：無

　　該屬性不能修改

　　tree_root_level

　　numeric

　　treeGrid root元素的層級

　　預設值:0

　　該屬性不能修改

　　url

　　string

　　請求的URL地址。

　　預設值:null

　　該屬性可以修改

　　userData

　　array

　　本屬性包含一些從request中擷取的自訂的資訊。比如不想直接顯示在grid中的一些資料。

　　預設值:empty array

　　該屬性不能修改

　　userDataOnFooter

　　boolean

　　如果設定為true，則直接把userData中的資料顯示在grid的頁尾。規則是：如果userData資料包含和colModel中name一樣的名字，那麼userData的值就顯示在該列。否則，什麼都不顯示。

　　The rules are as follow: If the userData array contain name which is equal to those of colModel then the value is placed in that column.If there are 該屬性不能修改 such values 該屬性不能修改thing is palced.

　　預設值:false

　　該屬性可以修改

　　viewrecords

　　boolean

　　確定是否顯示總的記錄條數。

　　預設值:false

　　該屬性不能修改

　　viewsortcols

　　array

　　本參數主要用來定義出現在標題附近的排序表徵圖的不同的外觀和行為。

　　參數數組的組成如下： [false,'vertical',true]. 第一個參數確定，如果所有的列排序屬性都是true，是否所有的表徵圖都能同時看到。預設值false表示只有最後排序列的表徵圖可見。

　　第二個參數確定表徵圖的位置。可能的值是vertical 表示排序表徵圖一個在另一個的上面。'horizontal' 表示水平放置兩個表徵圖。

　　第三個參數確定滑鼠點擊事件功能。設定為true，表示，表示點擊欄位標題可排序；設定為false表示只能點擊表徵圖才能排序。

　　重要提示：如果設定第三個參數為false，那麼必須要設定第一個參數為true，否則，排序功能可能丟失。

　　預設值：無

　　該屬性不能修改

　　width

　　number

　　設定grid的寬度。如果本屬性沒有設定，則按照各個列定義在colModel中的寬度總和作為grid的寬度。如果設定了本值，則grid中每一個列的初始寬度按照shrinkToFit參數定義來確定。

　　預設值:none

　　該屬性不能修改. Method avail.

　　xmlReader

　　array

　　對xml的資料格式的說明。參考jsonReader的描述。

　　預設值：無

　　該屬性不能修改

　　原文來自：雨楓技術教程網 http://www.fengfly.com

　　原文網址：http://www.fengfly.com/plus/view-175780-1.html