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 并编写以下代码：
<html>
<head>
<meta charset="utf-8" />
<title>DEMOtitle>
<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">
<table id="grid-table">table>
<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到此结束 与后台数据库互动等内容请关注下篇