【JQGRID DOCUMENTATION】.学习笔记.1.安装jqGrid

前面介绍了怎么使用其MVC方式，很好用。不过，觉得还是只使用前段比较好。

1.1 如何安装

到http://www.trirand.com/blog/?page_id=6 下载。

</html>

需要按以下顺序，

链接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，我们需要遵循下面三个事情

1. 一个有样本数据的数据库
2. 一个显示data的HTML页面
3. 一个服务端组件，扮演web页面和数据库之间的接口

html, body { margin: 0; padding: 0; font-size: 75%; } $(function () { $("#list").jqGrid({ url: "/Grid/List", datatype: "JSON", mtype: "GET", colNames: ["OrderID", "CustomerID", "EmployeeID", "OrderDate", "RequiredDate", "ShippedDate", "ShipVia", "Freight", "ShipName", "ShipAddress", "ShipCity", "ShipCountry"], colModel: [ { name: "OrderID", width: 55 }, { name: "CustomerID", width: 55 }, { name: "EmployeeID", width: 55 }, { name: "OrderDate", width: 55 }, { name: "RequiredDate", width: 55 }, { name: "ShippedDate", width: 55 }, { name: "ShipVia", width: 55 }, { name: "Freight", width: 55 }, { name: "ShipName", width: 55 }, { name: "ShipAddress", width: 55 }, { name: "ShipCity", width: 55 }, { name: "ShipCountry", width: 55 } ], pager: "#pager", rowNum: 10, rowList: [10, 20, 30], sortname: "", sortorder: "desc", viewrecords: true, gridview: true, autoencode: true, caption: "My First Grid" }); })

服务端代码：

}

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'>
…
<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的可视单元格不包含这个值。