前面介绍了怎么使用其MVC方式,很好用。不过,觉得还是只使用前段比较好。
1.1 如何安装
到http://www.trirand.com/blog/?page_id=6 下载。
需要按以下顺序,
链接jQuery UI的的CSS文件,然后jqGrid的CSS文件。
然后引用jQuery脚本文件,i18n脚本文件,jqGrid脚本文件。
2 了解他是如何工作的
理解jqGrid是如何工作的,会帮助你掌握插件的全部功能。要理解的第一件事情,是列表数据的两个方面:
- 客户端表现
- 服务端操作
JqGrid是使得web浏览器grid容易操作的列表数据组件。它使用Ajax,调用取回信息,并使用jqGrid Column Model(colModel)构建列表数据的表现。
此外,jqGrid帮助你,发送任何数据变化,或附加服务端的数据库,一个被称作服务端操作的处理,或SSM。
SSM是指服务器处理实际的变化,更新到数据库,而不是通过用户的浏览器。SSM不是web页面中可见的东西。服务端数据变更使用PHP,或其他任何公共编程语言。
一个jqGrid包含以下四个部分:
- Caption layer 包含grid的公共信息
- Header layer 包含列的信息:label,width
- Body layer 从服务器请求的数据,在column model中显示关联的设置
- Navigation layer 包含被请求数据的附加信息,和请求一小片信息的动作。Navigation layer不仅仅能显示在grid的bottom,可以在页面的任何地方。它上面也能加按钮和链接,如editing,deleting,adding,searching。
Grid最小的数据表现,是Header layer和Body layer。
为了*和灵活性,和总是更好的印象,jqGrid依赖CSS来显示。
3 第一个Grid
为了jqGrid,我们需要遵循下面三个事情
- 一个有样本数据的数据库
- 一个显示data的HTML页面
- 一个服务端组件,扮演web页面和数据库之间的接口
服务端代码:
Property | Description |
url | 告诉我们去哪取得数据。代表性的是服务端从数据库取得相应。 |
datatype | 告诉jgGrid,返回信息的类型,让jgGrid构建它。 |
mtype | 告诉我们如何做Ajax请求:Get或POST。 |
colNames | 一组列名。会显示在grid的head上。 |
colModel | 描述列模型的数组。这是gird最重要的一部分。常用的 name:列名,不必和数据库中一样。 index:传递给服务器用来分类排序的名字。我们也可以传递列数。一般地,这是数据库中的名字,用来服务端排序。 width:列的宽度,单位是像素。 align:列的对齐方式。 sortable:指定列中的数据可以被排序。如果false,点击header没有效果。 |
pager | 定义一个pager bar来导航记录。它可以放在任何地方。 |
rowNum | 设置grid中显示的行数。这个参数会传递给URL,从服务器取回数据 |
rowList | 一个数组,构建一个select box元素,可以改变可视行数。在运行期间改变这个值,会替换rowNum参数 |
sortname | 设置初始化的排序列。可以是一个名字或数字。这个参数会附加到URL上。 |
viewrecords | 定义是否我们在pager bar上显示查询的总记录数 |
caption | 设置grid的主题。如果这个参数没有设置,则不显示。 |
服务端返回的XML数据格式中:
…
<row id = 'unique_rowid'>
…
…
</rows>
Tag | Description |
rows | grid的跟标签 |
page | 被请求的页数 |
total | 查询的总页数 |
records | 查询的总条数 |
row | grid中特别的行 |
cell | 实际的数据。CDATA可以被使用。这种方式可以添加图片,链接和check boxes。 |
每行的cell tags个数,必须等于定义在colModel中的cells个数。row tags中的id属性,如果这个属性被忽略了,jgGrid会有两种方式处理这个独一无二的id:如果colModel中该属性设置了key,jqGrid会指派列的值到这行的id。不然,jqGrid会基于row的顺序设定id。
如果使用一个与内容无关的primary key来标识数据行,那么grid的可视单元格不包含这个值。