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

上一篇:Hbase设计实战


下一篇:locale的设定及其LANG、LC_ALL、LANGUAGE环境变量的区别