admin 管理员组

文章数量: 887021


2024年1月10日发(作者:xpath格式)

jqgrid 参数

一、概述

jqGrid 是一款基于 jQuery 的强大、灵活且易于使用的客户端数据网格控件。它广泛应用于 Web 应用程序中,用于展示和交互数据。本文档将介绍 jqGrid

的常用参数及其用法。

二、基本参数

1. datatype:指定服务器返回数据的格式,如 "xml", "json", "jsonp",

"script", "local" 等。

2. url:指定服务器端数据接口地址。如果 datatype 为 "local",则此处为本地数据源地址。

3. idname:指定 grid 中表格数据的 id 属性名。

4. width:指定 grid 的宽度。

5. height:指定 grid 的高度。

6. toolbar:包含用于添加、编辑、删除等操作的按钮选项。

7. columns:指定 grid 中表格列的配置,包括列名、类型、显示顺序等。

8. pageable:是否支持分页,默认为 true。

9. search:是否启用搜索功能,默认为 false。

10. multipleSearch:是否允许多个搜索条件,默认为 false。

三、高级参数

1. rownumbers:是否显示行号,默认为 true。

2. autowidth:如果列数动态变化,是否自动调整宽度,默认为 false。

3. groupHeader:是否启用分组头部,默认为 false。

4. pageNav:是否启用页码导航,默认为 false。

5. sortable:是否可排序,默认为 true。

6. filters:是否启用过滤器,默认为 false。

7. jsonmap:指定 JSON 数据映射的函数,用于处理特殊的数据结构。

8. cmTemplate:定义自定义列模板,可以定制列的显示方式、排序方式等。

9. urlmap:指定从原 URL 中获取数据映射的方法。

10. onSearch:定义搜索事件处理函数,用于响应用户搜索操作。

11. rowId:定义自定义行 ID 生成规则,替代默认的 '_'。

四、示例代码

下面是一个简单的 jqGrid 配置示例:

```javascript

$("#grid").jqGrid({

datatype: "json", // 数据格式为 JSON

url: "/data/", // 数据接口地址

height: "auto", // 自动调整高度以适应内容

autowidth: true, // 自动调整宽度以适应列数变化

columns: [ // 定义列配置

{ name: 'name', index: 'name', width: 120 }, // 姓名列,宽度为 120px

{ name: 'age', index: 'age', width: 70 }, // 年龄列,宽度为

70px

{ name: 'email', index: 'email' } // 邮箱列

],

search: true, // 启用搜索功能

onSearch: function(search) { // 搜索事件处理函数

("Searching for: " + );

}

});

```

以上代码创建了一个简单的 jqGrid,展示姓名、年龄和邮箱三列数据,支持搜索功能,并在搜索时输出搜索值。可以根据实际需求调整参数配置。


本文标签: 数据 默认 搜索 是否