DhtmlxGrid Quick Start Guide

说明:

本文来源于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 

 //well write script commands here

 /script 

Step 2 – 放置gird

有两种方式在一个页面放置grid，这里减少最常用的方法：创建一个div并给id熟悉设置一个惟一值。例如：

 div id="mygrid_container" /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" /div 

 /body 

阿里云灵积模型服务Quick Start DashScope灵积模型服务以模型为中心，致力于面向AI应用开发者提供品类丰富、数量众多的模型选择，并为其提供开箱即用、能力卓越、成本经济的模型服务API。DashScope灵积模型服务依托达摩院等机构的优质模型，在阿里云基础设施之上构建。灵积服务4.11号刚刚开通公测，目前提供Paraformer语音识别API能力，后续通义千问也将通过该服务对外提供API能力。本文演示如何快速通过Python SDK接入服务。
ModelScope使用Quick Start ModelScope是阿里巴巴打造下一代开源的模型即服务共享平台，为泛AI开发者提供灵活、易用、低成本的一站式模型服务产品，让模型应用更简单！本文通过Docker Image的方式演示服务的快速使用。
雨客 微博@JavaChen，这里的所有博客文章来自http://blog.javachen.com/。
Large-scale near-real-time (NRT) data analytics platform empowered by Apache Flink - Ying Xu & Kailash Hassan Dayanand 立即下载