Javascript图表库: Dojo Charting

谁借莪１个温暖的怀抱￠ 2022-04-22 12:10 202阅读 0赞

[![image][]][image 1]

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>

[![image][image 2]][image_image 2]

#### 使用代码编程方式创建图表 ####

编程方式创建图表同样也很简单，下面的javascript代码会创建与上面一个例子中完全相同的饼图。

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函数图表就生成了。

chart1.render();

[![image][image 3]][image_image 3]

### 动画、图例和标记 ###

在基本的图表功能之外，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");

[![image][image 4]][image_image 4]

有一点需要注意的是，添加标记（tooltip）功能，需要引入dijit的theme css文件，这里使用的是tundra主题。

### 缩放（Zooming）、平移（Panning） ###

Dojo Charting还提供支持图表缩放、移动等行为的函数。相关例子可以详见 [Zooming, Scrolling, and Panning in Dojo Charting][Zooming_ Scrolling_ and Panning in Dojo Charting] 或者 [view a great example of panning, scrolling, and zooming!][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][]

[![image][image 5]][image_image 5]

### 其他图表 ###

上面的例子介绍了一个具有基本功能的图表；Dojo Charting还有非常多高级特性的图表。

*  二维图表（[例子][Link 1] ）
 *  三维图表（[例子][Link 2] ）
 *  与动态数据源绑定的图表（[简单例子][Link 3] 、[股票图表][Link 4] 、[教程][Link 5] ）

[![image][image 6]][image_image 6]

本文翻译自： [http://www.sitepen.com/blog/2010/07/13/dive-into-dojo-charting/][http_www.sitepen.com_blog_2010_07_13_dive-into-dojo-charting]

[image]: /images/20220422/67537e8761e843f3a300fa52786fc6ec.png
[image 1]: http://hi.csdn.net/attachment/201010/28/0_1288259021sdX3.gif
[image 2]: http://hi.csdn.net/attachment/201010/28/0_1288262969T983.gif
[image_image 2]: /images/20220422/7e99819560304054a9ff7942ecc409f0.png
[image 3]: http://hi.csdn.net/attachment/201010/28/0_128826297059Rl.gif
[image_image 3]: /images/20220422/c8d9b15c760440258382c8c2ef835000.png
[image 4]: http://hi.csdn.net/attachment/201011/1/0_12885901789dun.gif
[image_image 4]: /images/20220422/a57afe5d6a4e4699b70b87c2211acfd3.png
[Zooming_ Scrolling_ and Panning in Dojo Charting]: http://www.sitepen.com/blog/2008/05/15/zooming-scrolling-and-panning-in-dojo-charting/
[view a great example of panning_ scrolling_ and zooming]: http://archive.dojotoolkit.org/nightly/dojotoolkit/dojox/charting/tests/test_win2d.html
[Dojo Charting Reference Guide]: http://www.dojotoolkit.org/reference-guide/dojox/charting.html#chart-events
[Dive Into Dojo Chart Theming]: http://www.sitepen.com/blog/2010/07/26/dojo-chart-theming/
[image 5]: http://hi.csdn.net/attachment/201011/1/0_1288590180ceJ9.gif
[image_image 5]: /images/20220422/c3991c4056d34be696bf3f9a10786870.png
[Link 1]: https://user.sitepen.com/~dwalsh/dojo-charting.html
[Link 2]: http://archive.dojotoolkit.org/nightly/dojotoolkit/dojox/charting/tests/test_bars.html
[Link 3]: http://archive.dojotoolkit.org/nightly/dojotoolkit/dojox/charting/tests/test_DataChart.html
[Link 4]: http://persevere.sitepen.com/stocker.html
[Link 5]: http://www.sitepen.com/blog/2009/03/30/introducing-dojox-datachart/
[image 6]: http://hi.csdn.net/attachment/201011/1/0_1288590182U0K5.gif
[image_image 6]: /images/20220422/15fa0ebdfffe4814b56f5629f147ea54.png
[http_www.sitepen.com_blog_2010_07_13_dive-into-dojo-charting]: http://www.sitepen.com/blog/2010/07/13/dive-into-dojo-charting/