jqGrid 学习笔记整理——基础篇
jqGrid 学习笔记整理——基础篇
jqGrid 实例中文版网址：http://blog.mn886.net/jqGrid/
国外官网：http://www.trirand.com/blog/
本人在官网的示例中学习的非常困难，现通过慢慢摸索学习已实现基本功能，特总结下来留给初学者们。
jqGrid 是一个用来显示网格数据的jQuery插件，通过使用jqGrid可以轻松实现前端页面与后台数据的ajax异步通信。
一、jqGrid特性
- 基于jquery UI主题，开发者可以根据客户要求更换不同的主题。
- 兼容目前所有流行的web浏览器。
- Ajax分页，可以控制每页显示的记录数。
- 支持XML，JSON，数组形式的数据源。
- 提供丰富的选项配置及方法事件接口。
- 支持表格排序，支持拖动列、隐藏列。
- 支持滚动加载数据。
- 支持实时编辑保存数据内容。
- 支持子表格及树形表格。
- 支持多语言。
- 目前是免费的。
二、jqGrid使用方式
- 首先，您需要到jqGrid官网下载最新版本的程序包，下载地址为：http://www.trirand.com/blog/?page_id=6
- 下载jqGrid皮肤，下载地址为：http://jqueryui.com/themeroller/
- HTML编辑工具建议使用HBuilder 下载地址：http://www.dcloud.io/index.html (注：第一次使用需联网邮箱注册，成功登陆后可离线)
- 打开HBuilder :文件->新建->WEB项目，填写项目名称 （这里以jqGriddemo为例）
4.1 导入CSS文件 （注意文件路径）
4.2 导入JS文件(注：i18n 文件夹下可根据所需语言选一个就好 复制时连同文件夹一起复制)
导入完成后目录如下
5.1 打开HBuilder自动生成的index.html 引入相应的css和js 并编写以下代码：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>DEMO</title>
<link rel="stylesheet" type="text/css" href="css/jquery-ui.min.css" />
<link rel="stylesheet" type="text/css" href="css/jquery-ui.theme.min.css" />
<link rel="stylesheet" type="text/css" href="css/ui.jqgrid-bootstrap-ui.css" />
<link rel="stylesheet" type="text/css" href="css/ui.jqgrid.css" />
</head>
<body>
<div class="main" id="main">
<!--jqGrid所在-->
<table id="grid-table"></table>
<!--jqGrid 浏览导航栏所在-->
<div id="grid-pager"></div>
</div>
<script src="js/jquery-1.11.0.min.js" type="text/javascript" charset="utf-8"></script>
<script src="js/i18n/grid.locale-cn.js" type="text/javascript" charset="utf-8"></script>
<script src="js/jquery.jqGrid.min.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript"> //当 datatype 为"local" 时需填写 var grid_data = [ {id: "00001",type: "退货出库",pay: "1000",name: "abc",text: "ccc"}, {id: "00002",type: "退货出库", pay: "1000",name: "abc",text: "aaa"}, {id: "00003",type: "退货出库", pay: "1040.06",name: "abc",text: "ddd" }]; var grid_selector = "#grid-table"; var pager_selector = "#grid-pager"; $(document).ready(function () { $("#grid-table").jqGrid({ data: grid_data,//当 datatype 为"local" 时需填写 datatype: "local", //数据来源，本地数据（local，json,jsonp,xml等） height: 150,//高度，表格高度。可为数值、百分比或'auto' //mtype:"GET",//提交方式 colNames: ['出库单号', '出库类型', '总金额', '申请人（单位）', '备注'], colModel: [{ name: 'id', index: 'id',//索引。其和后台交互的参数为sidx key: true,//当从服务器端返回的数据中没有id时，将此作为唯一rowid使用只有一个列可以做这项设置。如果设置多于一个，那么只选取第一个，其他被忽略 width: 100, editable: false, editoptions: { size: "20", maxlength: "30" } }, { name: 'type', index: 'type', width: 200,//宽度 editable: false,//是否可编辑 edittype: "select",//可以编辑的类型。可选值：text, textarea, select, checkbox, password, button, image and file.s editoptions: { value: "1:采购入库;2:退用入库" } }, { name: 'pay', index: 'pay', width: 60, sorttype: "double", editable: true }, { name: 'name', index: 'name', width: 150, editable: false, editoptions: { size: "20", maxlength: "30" } }, { name: 'text', index: 'text', width: 250, sortable: false, editable: true, edittype: "textarea", editoptions: { rows: "2", cols: "10" } }, ], viewrecords: true,//是否在浏览导航栏显示记录总数 rowNum: 10,//每页显示记录数 rowList: [10, 20, 30],//用于改变显示行数的下拉列表框的元素数组。 pager: pager_selector,//分页、按钮所在的浏览导航栏 altRows: true,//设置为交替行表格,默认为false //toppager: true,//是否在上面显示浏览导航栏 multiselect: true,//是否多选 //multikey: "ctrlKey",//是否只能用Ctrl按键多选 multiboxonly: true,//是否只能点击复选框多选 // subGrid : true, //sortname:'id',//默认的排序列名 //sortorder:'asc',//默认的排序方式（asc升序，desc降序） caption: "采购退货单列表",//表名 autowidth: true//自动宽 }); }); </script>
</body>
</html>注释仅说明了主要参数的用法，具体API 中文可见：http://blog.mn886.net/jqGrid/
6. 效果如下
第一个demo到此结束 与后台数据库互动等内容请关注下篇