| 
Dojo Charting是在Dojox目录下的一个图表工程，提供了众多的图表类型、定制选项以及各种主题。作为Dojo最强大的功能库之一，图表库（Charting）可能并没有被广泛应用，
这不得不说是一个遗憾， 所以这篇译文重点推荐一下强大的Dojo图表库，同时介绍如何利用Dojo图表库将枯燥无味的数据集转化成美观实用的图表。
导入Charting类
与许多别的Dojo功能库不同，Charting不需要导入大量的类。这归功于Charting库的松耦合设计，用户只需要添加自己需要的图表控件库即可。在这个例子里，一共添加了三个图表控件类：二维的图表类、图例类以及外观主题类。
/* required modules for the basic chart */
//Main 2d chart class
dojo.require("dojox.charting.widget.Chart2D");
//Class to create a legend for our chart
dojo.require("dojox.charting.widget.Legend");
//A theme for our chart
dojo.require("dojox.charting.themes.Tom"); |
两种声明方式
与Dojo其余绝大多数控件类似，Charting也支持“标签声明”和“代码创建”两种方式新建图表。接下来我们来看看对应的两个例子。
下面是例子中将用到的JSON数据：
var pieData = [{ "x": "1", "y": "9420" }, { "x":"2", "y":"10126" }, { "x": "3", "y": "9803" }, { "x": "4", "y": "15965" },
{ "x": "5", "y": "17290" }, { "x": "6", "y": "15667" }, { "x": "7", "y": "17762" }]; |
使用标签声明方式创建图表
我们可以直接使用HTML标签直接创建图表，在新建的图表标签中，图表类型（柱状图，饼图，线形图等）、标尺等都可以使用HTML标签声明。下面是一个饼图的声明示例：
<!– create the chart –>
<div dojoType="dojox.charting.widget.Chart2D" id="viewsChart" theme="dojox.charting.themes.PlotKit.green"
style="width: 550px; height: 550px;">
<!– add the plot –>
<div class="plot" name="default" type="Pie" radius="200" fontColor="black" labelOffset="-20"></div>
<!– pieData is the data source –>
<div class="series" name="January" array="pieData"></div>
<!– tooltips! –>
<div class="action" type="Tooltip"></div>
<!– slice animation! –>
<div class="action" type="MoveSlice" shift="2"></div>
</div> |
使用代码编程方式创建图表
编程方式创建图表同样也很简单，下面的javascript代码会创建与上面一个例子中完全相同的饼图。
<div id="pieChart" style="height:550px;width:550px;"></div> |
dojo.addOnLoad(function(){
......
var pieData = [{ "x": "1", "y": "9420" }, { "x":"2", "y":"10126" }, { "x": "3", "y": "9803" }, { "x": "4", "y": "15965" },
{ "x": "5", "y": "17290" }, { "x": "6", "y": "15667" }, { "x": "7", "y": "17762" }];
//create the chart
var pieChart = new dojox.charting.Chart2D("pieChart");
//set the theme
pieChart.setTheme(dojox.charting.themes.Tom);
//add plot
pieChart.addPlot("default", {
type: "Pie",
radius: 200,
fontColor: "black",
labelOffset: "-20"
});
//add the data series
pieChart.addSeries("January",pieData);
//slice animation!
new dojox.charting.action2d.MoveSlice(pieChart,"default");
//tooltips!
new dojox.charting.action2d.Tooltip(pieChart,"default");
//render the chart
pieChart.render();
......
}); |
我们在回头看一下两种创建方式，可以发现两者的结构非常类似。在我们接下去的例子中，将使用编程方式来创建图表。而在在实际开发中，开发者可以自由选择创建方式。
手把手构建网站访问量统计图
现在大家对Dojo Charting已经有了一个初步的认识，下面通过创建一个简单的图表来进一步了解Charting中各个功能。这个例子里我们使用层叠块状图（StackedAreas）展示网站访问量在3个月里的对比。
首先，要有3个月的网站访问量， 用JSON数据表示，同一个月的数据用数据表示：
var json = {
January: [9420,10126,9803,15965,17290, /* … */ 13165,12390],
February: [23990,32975,23477,22513,18069, /* … */ 12956,12815],
March: [22477,24014,21116,20404,19142, /* … */ 22077,20263]
}; |
第二，创建层叠块状图：
//we have a DIV element with an ID of "chart1"; that’s the argument
var chart1 = new dojox.charting.Chart2D(‘chart1′);
//add the default plot
chart1.addPlot("default", {
//type of chart
type: "StackedAreas",
//show markers at number points?
markers: true,
//curve the lines on the plot?
tension: "S",
//show lines?
lines: true,
//fill in areas?
areas: true,
//offset position for label
labelOffset: -30,
//add shadows to lines
shadows: { dx:2, dy:2, dw:2 }
}); |
由于在具体数字对于网站的访问量异常重要，我们需要添加标尺（Axis），x轴标尺表示日期，y轴标尺代表访问量。
chart1.addAxis("x");
chart1.addAxis("y", { vertical:true }); |
现在图表的框架（类型、标尺）已经搭建起来了，下一步就是绑定每个月的数据了。另外，我们还可以通过stroke和fill变量，直接声明每个月对应的颜色。
chart1.addSeries("January Visits",json["January"], { stroke: "red", fill: "pink" });
chart1.addSeries("February Visits",json["February"], { stroke: "green", fill: "lightgreen" });
chart1.addSeries("March Visits",json["March"], { stroke: "blue", fill: "lightblue" }); |
好了，基本的要素全到齐了，最后只需要调用render函数图表就生成了。
动画、图例和标记
在基本的图表功能之外，Charting还提供了许多实用的功能。
图例
图例对于图表来说也是必不可少的，在Dojo Charting中添加一个图例也很简单。
//this legend is created within an element with a "legend1" ID.
var legend1 = new dojox.charting.widget.Legend({chart: chart1}, "legend1"); |
动画
为静态的图表添加动画交互效果（比如高亮、放大、滑出等效果），可以让用户更清楚地看到细节内容。不同的图表类型都支持自己的一套动画交互效果。下面的代码给图表添加了“放大”的动画效果，当鼠标在图表节点上时，放大节点。
//add the magnification animation to our chart for the default plot
var magnify = new dojox.charting.action2d.Magnify(chart1, "default"); |
标记
尽管有x轴和y轴上的数据标尺，我们仍然不能确认每个节点的数值，所以就需要引入标记。添加标记功能也十分简单。
| var tip = new dojox.charting.action2d.Tooltip(chart1,
"default"); |
有一点需要注意的是，添加标记（tooltip）功能，需要引入dijit的theme
css文件，这里使用的是tundra主题。
缩放（Zooming）、平移（Panning）
Dojo Charting还提供支持图表缩放、移动等行为的函数。相关例子可以详见
Zooming, Scrolling, and Panning in Dojo Charting或者 view
a great example of panning, scrolling, and zooming!
事件绑定
Dojo Charting有自己的事件绑定方法：connectToPlot
。通过这个方法，用户可以触发自己的事件。相关的connectToPlot函数介绍详见Dojo Charting
Reference Guide
chart1.connectToPlot("default",function(e) {
/* do something */
}); |
主题（Theme）
Dojo Charting库提供了超过30种不同的主题风格。可以在看到这些主题预览，之后我还将翻译一篇如何自定义Dojo
Charting主题的文章 Dive Into Dojo Chart Theming
其他图表
上面的例子介绍了一个具有基本功能的图表；Dojo Charting还有非常多高级特性的图表。
- 二维图表（例子 ）
- 三维图表（例子 ）
- 与动态数据源绑定的图表（简单例子 、股票图表 、教程 ）
|
