salesforce 零基础学习（二十六）自定义图表chart简单介绍（使用apex和VF实现）

chart在报表中经常使用到，他可以使报表结果更加直观的展现给用户。salesforce支持VF和apex代码来更好的展示chart。

chart分类：常用的图表样式有饼状图，柱状图，折线图，条形图，表盘图，雷达图，及线性系列图表等。

图表根据样式不同显示的内容不同，大概包含以下部分：

1. X,Y坐标;

2. 标题;

3. 内容及所含数量（data）;

4.移入上面显示的相关提示信息(tip);

5.说明(legend)。

注：这里只是总结大概的部分，显示的部分因图表样式而有相应的差距,chart是可以高度自定义的，可以通过vf标签的属性对内容进行显示或者隐藏。

这里主要对饼状图进行描述，其他图形可以参看Page Developer的描述以及相关标签的属性介绍来自行练习。我们要实现的大概效果如下图所示。

还是以Goods__c表为例，其中一个字段为GoodsBrand__c，类型为PickList，主要有四种可选择产品类型，华为，小米，魅族以及联想。我们要做的chart为展示数据表中各个品牌所占的比例。

对此饼状图大概分析：制作此饼状图需要有数据，说明（legend），提示信息（tip）。

其中，我们使用<apex:chart>标签来封装数据，使用<apex:pieSeries>来显示数据。<apex:pieSeries>有这样两个属性，labelField展示图表上面显示的内容信息，此信息与legend的标题信息相同且legend不可以自己定义，dataField用来展示比例，即这个值占据总量的多少。默认情况下tip信息由key，value队组成，显示的key为labelField值，显示的value为dataField的值。

制作步骤：

1.Apex用于制作数据

 public class PieChartController {
     public Map<String,Integer> goodsBrandNumberMap = new Map<String,Integer>();
     public Set<String> goodsBrand{get;set;}
     public PieChartController() {
         Map<String, object> goodsBrandValuesMap = PickListValuesUtil.getPicklistValues('Goods__c','GoodsBrand__c');
         goodsBrand = goodsBrandValuesMap.keySet();
         List<Goods__c> goodsList = [select Id,GoodsBrand__c from Goods__c where GoodsBrand__c <> null];
         for(Goods__c currentGoods : goodsList) {
             if(goodsBrand.contains(currentGoods.GoodsBrand__c)) {
                 if(goodsBrandNumberMap.keySet().contains(currentGoods.GoodsBrand__c)) {
                     goodsBrandNumberMap.put(currentGoods.GoodsBrand__c,goodsBrandNumberMap.get(currentGoods.GoodsBrand__c) + 1);
                 } else {
                     goodsBrandNumberMap.put(currentGoods.GoodsBrand__c,1);
                 }
             }
         }
     }

     public List<Data> getGoodsBrandPieData() {
         List<Data> pieWdegeData = new List<Data>();
         for(String goodsBrandName : goodsBrandNumberMap.keySet()) {
             Data data = new Data(goodsBrandName + '\n' + goodsBrandNumberMap.get(goodsBrandName),goodsBrandNumberMap.get(goodsBrandName),goodsBrandName);
             pieWdegeData.add(data);
         }

         return pieWdegeData;
     }

     // Wrapper class
     public class Data {
         //label
         public String chartLabel { get; set; }
         //the value of chart label
         public Decimal valueOfChartLabel { get; set; }
         //tip customize
         public String tipOfChartLabel {get;set;}
         //tip customize
         public Decimal tipOfLabelValue{get;set;}

         public Data(String chartLabel,Decimal valueOfChartLabel) {
             this.chartLabel = chartLabel;
             this.valueOfChartLabel = valueOfChartLabel;
         }

         //if the label of tip need to customize,choose this
         public Data(String chartLabel,Decimal valueOfChartLabel,String tipOfChartLabel) {
             this(chartLabel,valueOfChartLabel);
             this.tipOfChartLabel = tipOfChartLabel;
         }

         //if both the label of tip and the value of tip need to customize ,choose this
         public Data(String chartLabel,Decimal valueOfChartLabel,String tipOfChartLabel,Decimal tipOfLabelValue) {
             this(chartLabel,valueOfChartLabel,tipOfChartLabel);
             this.tipOfLabelValue = tipOfLabelValue;
         }
     }
 }

由于展现的legend需要自己定义，所以我们在构造Data时要考虑图表的label以及对应的value和label提示信息以及相对应的value。Data相当于一个Property,前台通过数据绑定后在使用<apex:pieSeries>便相当于迭代器，将列表中每个Data元素取出。

2.Page页面显示数据

 <apex:page controller="PieChartController" title="Pie Chart"> 

     <apex:chart data="{!goodsBrandPieData}" height="400" width="500" colorSet="#0A224E,#BF381A,#A0D8F1,#E9AF32,#E07628">
         <apex:legend position="bottom"/>
         <apex:pieSeries labelField="chartLabel" dataField="valueOfChartLabel" donut="50">
             <apex:chartLabel display="none" orientation="vertical" font="bold 18px Helvetica"/>
             <apex:chartTips labelField="tipOfChartLabel"/>

         </apex:pieSeries>
     </apex:chart>

 </apex:page>

通过上述代码便可以实现上图所示的chart。

我们把Page页面做些调整，页面代码如下所示：

 <apex:page controller="PieChartController" title="Pie Chart"> 

     <apex:chart data="{!goodsBrandPieData}" height="400" width="500">
         <apex:legend position="bottom"/>
         <apex:pieSeries labelField="tipOfChartLabel" dataField="valueOfChartLabel" donut="50">
         </apex:pieSeries>
     </apex:chart>

 </apex:page>

显示效果如下图所示

可以看出legend和label显示样式相同，如果需要进行相关的定制化，详见PDF中所使用标签的属性。

总结：自定义图表简单的说便是先提供数据进行绑定，然后通过需要的图表样式进行解析即可，如果需要定制一些特殊需要，详见使用的标签属性，legend标签无value等自定义的值，其值与label绑定，所以如果需要legend显示特殊的值，需要在设置Data时考虑相关的信息，在label绑定时，绑定legend需要显示的值，在对label进行自定义操作。如果篇中有错误地方欢迎指出，如果有问题欢迎留言。