jqPlot图表插件学习之饼状图和环状图

一、准备工作

官网下载（笔者选择的是jquery.jqplot.1.0.8r1250.zip这个版本）

然后读者需要根据自己的情况新建一个项目并且按照如下的方式加载对应的js和css（因为笔者在VS2012环境下新建的，并且所需的js和css都会对应的放到js和css文件夹下，请读者根据自己的情况修正加载的路径）。

 <link href="css/jquery.jqplot.min.css" rel="stylesheet" />
 <script src="js/jquery.min.js"></script>
 <script src="js/jquery.jqplot.min.js"></script>

 <!--[if lt IE 9]>
 <script src="js/excanvas.min.js"></script>
 <![endif]-->
 <script src="js/jqplot.pieRenderer.min.js"></script>
 <script src="js/jqplot.donutRenderer.min.js"></script>

其中最后一个js文件在plugins下，今后会经常使用到这个文件夹下的文件，因为他们是很多扩展功能所需的文件。除了引用基本的文件之后我们还需要放置一个占位符用来作为图表的容器，我们需要放置一个宽度为500高度为300的DIV:

 <div id="chart" style="width:500px;height:300px;" ></div>

二、正文

这节我们将围绕饼状图展开介绍，首先是最常规的饼状图，所以我们这里就需要PieRenderer来负责渲染，所以必须要引用jqplot.pieRenderer 这个库，然后我们就通过一段代码来实现图1.1的效果：

         $(function () {

             var data = [
             ['Heavy Industry', 12], ['Retail', 9], ['Light Industry', 14],
             ['Out of home', 16], ['Commuting', 7], ['Orientation', 9]
             ];

             $.jqplot('chart', [data], {
                 seriesDefaults: {
                     renderer: $.jqplot.PieRenderer,
                     rendererOptions: {
                         showDataLabels: true
                     }
                 },
                 legend: {
                     show: true,
                     location: "e"
                 }
             });
         });

其中没有什么需要特别说明的，通过前面几节的学习，大家一定知道renderer属性的含义，也能够明白以后只要是显示非折线，就会使用到这个属性来指定图表，而rendererOptions则是对renderer设置的图表的附加属性，所以具体的参数项要根据具体使用的图表而定，比如这里使用了饼状图，所以showDataLabels则表示饼状图中是否显示所占比例数。最后一个就是legend了，用来指定不同颜色所对应的数据项。

图1.1

除了这种最普通的饼状图，我们还可以制作出其他的饼状图，比如下面的代码我们通过rendererOptions中的部分属性将可以制作出图1.2所示的饼状图：

         $(function () {

             var data = [
             ['Heavy Industry', 12], ['Retail', 9], ['Light Industry', 14],
             ['Out of home', 16], ['Commuting', 7], ['Orientation', 9]
             ];

             $.jqplot('chart', [data], {
                 seriesDefaults: {
                     renderer: $.jqplot.PieRenderer,
                     rendererOptions: {
                         showDataLabels: true,
                         fill: false,
                         lineWidth: 5,
                         sliceMargin: 4
                     }
                 },
                 legend: {
                     show: true,
                     location: "e"
                 }
             });
         });

这里的fill表示是否填充整个饼状图，另外两个属性通过字面的意思也能够得出分别是边框宽度和外边距。

图1.2

当然还有跟饼状图类似的图形，只是它不仅仅只是外面有，内部还有一个环，它的名字就是环状图，通过下面的代码我们将创建图1.3的环状图：

         $(function () {

             var s1 = [['a', 6], ['b', 8], ['c', 14], ['d', 20]];
             var s2 = [['a', 8], ['b', 12], ['c', 6], ['d', 9]];

             $.jqplot('chart', [s1,s2], {
                 seriesDefaults: {
                     renderer: $.jqplot.DonutRenderer,
                     rendererOptions: {
                         showDataLabels: true,
                         sliceMargin: 4,
                         dataLabels: 'value',
                         startAngle: -90
                     }
                 },
                 legend: {
                     show: true,
                     location: "e"
                 }
             });
         });

其中rendererOptions中又多了几个属性，分别是dataLabels和startAngle，dataLabels表示showDataLabels显示的数据是显示百分比还是直接显示数据中的数字，而startAngle则表示环状图起始的位置，比如这里的-90表示从12点钟方向开始，默认是从9点钟方向顺时针开始的。

图1.3