说明:
本文来源于http://dhtmlx.com/docs/products/dhtmlxGrid/,本人对其进行翻译整理成下文,贴出此文,紧供分享。
dhtmlxGrid是一个拥有强大的数据绑定、优秀的大数据展示性能并支持ajax的JavaScript表格控件。该组件易于使用并通过富客户端的API提供了很大的扩展性。dhtmlxGrid支持不同的数据源(XML, JSON, CSV, JavaScript 数组和HTML表格),如果需要的话,还可以从自定义的xml中加载数据。
跨浏览器
使用JavaScript API进行控制
Ajax支持
简单的JavaScript 或者XML 配置
与HTML集成
内建过滤、排序、查询、分组功能
表格 footer/header自动计算
行内编辑
准备使用大数据集解决方案:分页,动态加载,智能渲染
序列化为XML或CSV
从 XML或CSV加载
列锁定
剪贴板支持
简单的客户端到服务器端配置 (使用 dhtmlxConnector, 可用于 PHP, Java, .NET, ColdFusion)
支持子表格
列拖拽和移动
行或列拖拽
dhtmlxTree PRO Edition支持拖拽
可以创建一个编辑器或是列格式化 (使用 eXcell – 继承自 cell 对象)
组合框,日历以及更多的预定义eXcells
Cell支持数学方程式
不同的键盘映射
简单的CSS风格或是预定义的皮肤
对于rows/entire grid不可见的数据块 (用户数据)
客户端排序(string, integer, date, custom)
服务器端排序
广泛的事件处理
Step 1 – 引入文件
< link rel ="STYLESHEET" type="text/css" href="codebase/dhtmlxgrid.css" />
< script src="codebase/dhtmlxcommon.js">< /script>
< script src="codebase/dhtmlxgrid.js">< /script>
< script src="codebase/dhtmlxgridcell.js">< /script>
< script>
//we'll write script commands here
< /script>
Step 2 – 放置gird
有两种方式在一个页面放置grid,这里减少最常用的方法:创建一个div并给id熟悉设置一个惟一值。例如:
< div id="mygrid_container" style="width:600px;height:150px;">< /div>
下面初始化参数,首先定一个mygrid变量,然后定一个doInitGrid方法,方法内部进行mygrid初始化工作:
var mygrid;
function doInitGrid(){
}
doInitGrid方法会包括以下代码:
- 使用dhtmlXGridObject构造方法创建一个基于我们之前创建的DIV的grid对象;
- 设置grid图片路径。这个路径包括grid外观需要的所有图片。在大多数情况下该路径为“codebase/imgs/”. 该路径最后面的一个“/”很重要。 随便说一下,这个路径和你处理表格数据所使用的图片没有关系;
- 使用setHeader 方法定义表头;
- 使用setInitWidths (单位为像素) 或setInitWidthsP (单位为百分比)定义列宽。 使用
*
代表让列自动使用所有表格宽度; - 定义一个列的水平对其方式。 Numeric values is better to align right;
- 使用setSkin方法设置皮肤;
- 最好使用这些设置通过init方法初始化grid。更多的参数之后再讨论。
目前,doInitGrid方法如下:
mygrid = new dhtmlXGridObject('mygrid_container');
mygrid.setImagePath("codebase/imgs/"); //指定图片路径
mygrid.setHeader("Model,Qty,Price"); //设置表头显示
grid.setInitWidths("*,150,150"); //设置列的初始宽度
grid.setColAlign("left,right,right"); //设置列的水平对其方式
mygrid.setSkin("light"); //设置皮肤
grid.init(); //显示调用初始化方法,必须的
现在需要做的是运行该方法,可以将该方法加入body的onload方法里或是使用jquery的方法。下面使用body的onload方法:
< body onload="doInitGrid();">< /body>
这样在该页面初始化之后会显示如下:
说明:除了调用set方法之外,还可以如下风格定义:
mygrid = new dhtmlXGridObject({
parent:"a_grid",
image_path:"codebase/imgs",
columns:[
{ label: "Sales", width:50, type:"ed" },
{ label:["Book title",
"#text_filter"], width:150, type:"ed" },
{ label:["Author",
"#select_filter"], width:150, type:"ed" },
{ label: "Price", width:50, type:"ed" },
{ label:"In store" , width:80, type:"ch" },
{ label:"Shipping" , width:50, type:"ed" },
{ label:"Bestseller" , width:50, type:"ed" },
{ label:"Date" , width:50, type:"ed" }
],
xml:"data.xml"
});
Step 3 – 填充数据
你已经知道了dhtmlxGrid可以加载xml或cvs或json数据,这里主要演示dhtmlxGrid加载json数据。
在上面的例子中每行有三列,故我们的json数据如下:
{
rows:[
{
id: "a",
data: [Model 1, 100, 399]
},
{
id: "b",
data: [Model 2, 50, 649]
},
{
id: "c",
data: [ Model 3, 70, 499]
}
]
} 将上面存于data.json文件,然后在doInitGrid方法里调用以下方法:
mygrid.load ("data.json",,"json");
这时候页面展示如下:
Step 4 – 客户端排序
为了能够实习表格的客户端排序,必须调用grid的setColSorting(sortTypesStr)方法。sortTypesStr是一个类型列表,以逗号分隔。
该类型值有以下四种:
- str – 作为字符串排序
- int - 以Integer值排序 (通常可以是任何数字);
- date – 以日期排序
- custom sorting –自定义的更加复杂的排序方式(for example to sort days of week).
接下来我们对上面的例子进行排序。上例中每行有三列,第一列为字符串,后两列为数字,故可以调用以下方法进行排序。注意,该方法应该在init方法之前执行。
mygrid.setColSorting("str,int,int");
这时候单击最后一列表头,结果如下:
Step 5 – 单元格格式化和编辑
Grid中使用单元格的编辑器(或是eXcells – 继承自 Cells, Cell 或 Columns types)来定义值的格式和编辑方式。你可以根据你的需要创建eXcells。
设定单元格的类型非常容易,其可以用一行代码定义。这里有一些常见的编辑器,如简单的编辑器代码为“ed”,多行编辑“txt”,只读单元格“ro”,复选框“ch”,价格的格式化“price”。 默认情况下所有的列是“ro”,也可以使用以下方法类设置编辑类型:
mygrid.setColTypes("ed,ed,price");
Excells格式化有以下几种:
- link:超链接
- img:图片
- price:价格
- dyn:动态行
Excell 复杂编辑器有以下几种:
- cp:colorpicker
- calck:允许调用grid.setNumberFormat的计算器
- dhxCalendar:日历,日期格式可以通过grid.setDateFormat设置
- dhxCalendarA:日历,日期格式可以通过grid.setDateFormat设置,单元格可以编辑
- calendar:YUI Calendar
- clist:多选组件
使用其他组件作为单元格编辑器:
- grid:使用dhtmlxgrid
- stree :使用dhtmlxtree
- context:使用dhtmlxmenu
- combo:使用dhtmlxCombo
Excells特别用途 sub_row:允许单元格作为一个可展开的子单元格,就想查看明细一样。
两个扩展:
- sub_row_ajax – 单元格数据被认为是ajax请求的url
- sub_row_grid – 允许创建一个子表作为一个子行的内容
现在你可以双击或是F2进入编辑模式,你可以用tab键在单元格之间导航。
Step 6 – 行操作方法
function addRow(){
var newId = (new Date()).valueOf()
mygrid.addRow(newId,"",mygrid.getRowsNum())
mygrid.selectRow(mygrid.getRowIndex(newId),false,false,true);
}
function removeRow(){
var selId = mygrid.getSelectedId()
mygrid.deleteRow(selId);
}
代码中addRow() 方法的一些说明: * 创建一个惟一值 (number of millisecond since 1970) 来作为row的标识; * 在最后一行后面添加一新行,该行有新的id,值为空; * 选中最近创建的行 (by index), 不掉用 On-Select事件,不掉用选中行之前事件并且聚焦到选中行(如果垂直滚动条存在,则滚动对应位置)。
代码中removeRow() 的一些说明(一行行的): * 得到选中行id; * 删除指定行id的行
Step 7 – 事件
添加事件调用attachEvent 方法,如下行选中事件:
function doOnRowSelected(rowID,celInd){
alert("Selected row ID is "+rowID+"\nUser clicked cell with index "+celInd);
}
mygrid.attachEvent("onRowSelect",doOnRowSelected);
Step 8 – Code
最后的代码:
< title>dhtmlxGrid Sample Page< /title>
< link rel="STYLESHEET" type="text/css" href="codebase/dhtmlxgrid.css" />
< script src="codebase/dhtmlxcommon.js">< /script>
< script src="codebase/dhtmlxgrid.js">< /script>
< script src="codebase/dhtmlxgridcell.js">< /script>
< script>
var mygrid;
function doInitGrid(){
mygrid = new dhtmlXGridObject('mygrid_container');
mygrid.setImagePath("codebase/imgs/");
mygrid.setHeader("Model,Qty,Price");
mygrid.setInitWidths("*,150,150");
mygrid.setColAlign("left,right,right")
mygrid.setSkin("light");
mygrid.setColSorting("str,int,int");
mygrid.setColTypes("ed,ed,price");
mygrid.attachEvent("onRowSelect",doOnRowSelected);
mygrid.init();
mygrid.load ("data.json","json");
}
function addRow(){
var newId = (new Date()).valueOf()
mygrid.addRow(newId,"",mygrid.getRowsNum())
mygrid.selectRow(mygrid.getRowIndex(newId),false,false,true);
}
function removeRow(){
var selId = mygrid.getSelectedId()
mygrid.deleteRow(selId);
}
function doOnRowSelected(rowID,celInd){
alert("Selected row ID is "+rowID+"\nUser clicked cell with index "+celInd);
}
< /script>
< body onload="doInitGrid()">
< div id="mygrid_container" style="width:600px;height:150px;">< /div>
< /body>