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