Salesforce Lightning组件中使用Chart.JS实现数据可视化(二)

上篇博客提到,如何在Salesforce Lightning组件下借助ChartJS来实现数据可视化,并以Line Chart完成了一个案例,接下来我们进一步优化这个案例

之前的博客中,ChartJS显示的画面如下,

在这张表当中,很显然,2014与2020对应的两个数据点并不能将数值显示完全,同时可以看到,2020的最高点被遮住了一部分,对应的数字更是没有显示出来,所以我们修复下这几个问题:

  • 最高点显示数据不完整
  • 最左边更最右边的数据显示不完整

同时需要优化的地方包括:

  • 显示的数字因为是货币,所以给加上对应的货币分隔符
  • 动态显示画布的大小

问题1:最高点显示数据不完整

数值最大的点显示不完整,其本质上是这个数值达到了Y轴的最高点,所以,解决方法就是设置Y的高度始终高于数据集中的最大值,而考虑到数据的量级可能是个位数,又或者百万甚至千万,直接设置Y轴的大小显然并不可取,那么我们可以将Y轴最大值 = 数据集最大值 * 130%,这样动态的保证数据点用于囊括在Y轴里面,从而确保了最高点不会被遮住,那么上代码:

// 取出数据集中的最大值
var MULTIPLE = 1.3; // 设置Y轴 在最大值的基础上延长多少
var maxValue = temp[0]["firstValue"];
        
for(var a=0; a< temp.length; a++){
  label.push(temp[a]["label"]);
  firstValue.push(temp[a]["firstValue"]);
  secondValue.push(temp[a]["secondValue"]); 
  if(maxValue < temp[a]["firstValue"]) maxValue = temp[a]["firstValue"];
  if(maxValue < temp[a]["secondValue"]) maxValue = temp[a]["secondValue"];
}    
// 设置Y轴参数
yAxes: [{
    gridLines: {display:false},
    display: false, // 隐藏Y轴
    ticks: { // 设置Y轴最大最小坐标点
        min: 0, 
        max: maxValue * MULTIPLE,
    },
}]

展示效果:

问题2:最左边更最右边的数据显示不完整

X轴左右两边的数据点显示不完整,根据问题一的结果,第一反应毫无疑问是延长X轴线来解决问题,但是在查阅了相关文档后,并没有合适的,可以用来操作的空间,所以常规手段,将最左边的点往右挪,最右边的点往左挪,不过这种情况就需要注意,当数据点仅有一个时该如何显示,话不多说,上代码

animation:{
    "duration":1,
    "onComplete": function() {
        var chartInstance = this.chart,
        ctx = chartInstance.ctx;
        ctx.fillStyle = 'black';
        ctx.textAlign = 'center';
        ctx.textBaseline = 'bottom';
        this.data.datasets.forEach(function(dataset, i) {
            var meta = chartInstance.controller.getDatasetMeta(i);
            var len = meta.data.length;
            meta.data.forEach(function(bar, index) {
                var data = '$' + dataset.data[index];
                var Offset = data.length * 2; // 偏移量
          // 注意,Y轴上 - 5是向上移动 if(len >= 2){ if(index == 0){// 第一个数据点的偏移 ctx.fillText(data, bar._model.x + Offset, bar._model.y - 5); }else if(index == len -1){ // 最后一个点的偏移 ctx.fillText(data, bar._model.x - Offset, bar._model.y) - 5; }else{ ctx.fillText(data, bar._model.x, bar._model.y - 5); } }else{// 当只有一个数据点的时候 ctx.fillText(data, bar._model.x + Offset, bar._model.y - 5); } }); }); } }

这里面我引入了一个偏移量的概念,原理同问题一,数据量级的问题,个位数和百位千位十万位需要挪动的像素大小是完全不一样的,所以我根据当前数据本身的长度,分别向左右各偏移两倍的长度,这样显示的效果在各种量级下自然没有差别,当然你喜欢也可以自己设定合适的大小

展示效果:

 做到这里,为了测试数据展示的效果,我尝试只传入一个点的时候发现一个问题,

 可以看到,当只有一条数据时,Line类型的图表会将数据点显示在Y轴上,虽然数据显示没问题,但是在展示的时候,会显得非常奇怪,相对来说,将这个点移动到图表的中间效果更合适,但是在我翻遍文档后,发现这一点并不能通过配置来实现,所以只能另想办法,最后我将只有一个点的时候,传入两个空值,在前端显示时,隐藏空值的点,这样根据三个点的显示效果,这唯一一个数据点就会出现在正中间了,那么怎么做呢?

首先,ChartJS中,坐标点传入 null值是不会显示的,所以利用这一点,我们在第一个点的位置前后各传递一个null,因为 LineChartVar下的fisrtValue和secondValue都是Integer的数据,所以假设传入值为-1,在Aura组件的JS文件中将-1替换成null即可

Controller & Helper 核心代码:

//  此处仅作为展示,假设数据不包括 -1 ,实际项目中应改成其他值,因为LineChartVar的中firstValue都是整数类型,而Integer类型不支持传null进去,
// 所以我设置值为-1,在JS中将-1替换掉
List<LineChartVar> myLineChartVarList = new List<LineChartVar>(); myLineChartVarList.add(new LineChartVar('ISNULL', -1, -1)); myLineChartVarList.add(new LineChartVar('2014', 100,120)); myLineChartVarList.add(new LineChartVar('ISNULL', -1, -1)); return JSON.Serialize(myLineChartVarList);
var MULTIPLE = 1.3; // 设置Y轴 在最大值的基础上延长多少
// 注意 -1 是假设的的值,所以最大值不能取
var maxValue = temp[0]["firstValue"] == -1 ? 0 : temp[0]["firstValue"]; 

for(var a=0; a < temp.length; a++){
    //  label为ISNULL说明是我们传入的占位点,所以将Label设置为''
    var tempLabel = temp[a]["label"] == 'ISNULL' ? '' : temp[a]["label"];
    if(tempLabel == '') MULTIPLE = 2;
    label.push(tempLabel);
    
    //  value为-1时,说明是传入的占位符,所以将其设定为null
    var tempValue = temp[a]["firstValue"] == -1 ? null : temp[a]["firstValue"];
    firstValue.push(tempValue);

    var tempValue2 = temp[a]["secondValue"] == -1 ? null : temp[a]["secondValue"];
    secondValue.push(tempValue2);

    // setting the yAxes ticks 
    var FValue = temp[a]["firstValue"] == -1 ? 0 : temp[a]["firstValue"];
    var SValue = temp[a]["secondValue"] == -1 ? 0 : temp[a]["secondValue"];
    if(FValue > maxValue) maxValue = FValue; // get MaxValue
    if(SValue > maxValue) maxValue = MValue; // get MaxValue
}

为了方便查看演示效果,我将X轴的网格线重新打开,可以看到,现在的唯一的数据点就被放在了中间位置,效果比起默认的情况就好很多了

 然后我们继续最开始的优化,想要让数据点显示货币分隔符号,其实只需要在HelpJS中对数据进行简单的处理就好

meta.data.forEach(function(bar, index) {
    var tempdata = dataset.data[index];
    // 数据点的值有可能为null,所以先加上判断
    if(tempdata != null){
        // 考虑传入的数据不一定全是整数,当传入一个浮点数时,我们以 "." 进行分隔
        var arry = tempdata.toString().split(".");
        // split分隔出来的数组,第一个数字一定是整数部分,直接通过正则表达式对其添加货币分隔符号
        tempdata = arry[0].toString().replace(/(d)(?=(?:d{3})+$)/g, '$1,');
        // 如果是浮点数,那么 split分隔的数组就有两个值,第二个值就是小数部门,直接拼接即可
        if(arry.length > 1) tempdata = tempdata + '.' + arry[1];
    }
    // 这里添加 “$” 是为了避免 null 值时,data.length 这个报错,毕竟空指针问题
    var data = '$' + tempdata;
    
    // var data = '$' + dataset.data[index];
    var Offset = data.length * 2;
    .......
}

查看显示效果:

看上去还不错,分隔符的显示很完美,那么接下来最后一个优化,让画布的大小自适应,这个其实比较简单,上一篇提到,改变画布的大小有两种方式:

// 方式一:在Helper中直接渲染
var el = cmp.find('lineChart').getElement();
var ctx = el.getContext('2d');
ctx.canvas.width = '700';
ctx.canvas.height = '300';

// 方式二:在cmp中,直接设定宽高
<canvas aura:id="lineChart" id="lineChart" width="600" height="300"/>

要使画布大小自适应,那么显然在Helper中直接渲染是可行的,所以我们获取画布外的div大小,然后将div的宽高赋值给画布,就能保证在画布渲染出来时,是符合div大小的,所以,代码如下:

// 获取容器div的大小
var divChart = document.getElementById('chartContainer');

var el = cmp.find('lineChart').getElement();
var ctx = el.getContext('2d');
// 将容器div的大小赋值给画布
ctx.canvas.width = divChart.offsetWidth;
ctx.canvas.height = divChart.offsetHeight;

将div的宽度设置为100%,高度设置为50%

<aura:application >
    <div id="chartContainer" style="100%;height:50%;">
        <c:ChartDemo/>
    </div>
</aura:application>

演示效果如下:

到这里为止,针对ChartJS数据展过程中的优化点做了更细致的整理和解决,希望对看到这里的你有所帮助

最后,友情提示,ChartJS的版本是在不断迭代的,如果你看到有的代码你没法运行,或者运行的展示结果并不一样,那么我推荐你换一个版本过来进行尝试,比如在ChartJS中对tooltip的样式属性:displayColors,borderColor,borderWidth这些,都有提供自定义选项,但是如果版本不够新,这些属性并不能正常工作,所以在使用ChartJS时,你使用的版本也很重要

参考内容:

ChartJS中文文档

ChartJS演示案例

ChartJS官方文档

附上完整的Helper Controller代码

({
    createLineGraph : function(cmp, temp) {
        var label = [];
        var firstValue = [];
        var secondValue = [];
        
        var MULTIPLE = 1.3; // 设置Y轴 在最大值的基础上延长多少
        // 注意 -1 是假设的的值,所以最大值不能取
        var maxValue = temp[0]["firstValue"] == -1 ? 0 : temp[0]["firstValue"]; 

        for(var a=0; a < temp.length; a++){
            //  label为ISNULL说明是我们传入的占位点,所以将Label设置为''
            var tempLabel = temp[a]["label"] == 'ISNULL' ? '' : temp[a]["label"];
            if(tempLabel == '') MULTIPLE = 2;
            label.push(tempLabel);
            
            //  value为-1时,说明是传入的占位符,所以将其设定为null
            var tempValue = temp[a]["firstValue"] == -1 ? null : temp[a]["firstValue"];
            firstValue.push(tempValue);
        
            var tempValue2 = temp[a]["secondValue"] == -1 ? null : temp[a]["secondValue"];
            secondValue.push(tempValue2);
        
            // setting the yAxes ticks 
            var FValue = temp[a]["firstValue"] == -1 ? 0 : temp[a]["firstValue"];
            var SValue = temp[a]["secondValue"] == -1 ? 0 : temp[a]["secondValue"];
            if(FValue > maxValue) maxValue = FValue; // get MaxValue
            if(SValue > maxValue) maxValue = SValue; // get MaxValue
        }
        
        var divChart = document.getElementById('chartContainer');
        
        var el = cmp.find('lineChart').getElement();
        var ctx = el.getContext('2d');
        ctx.canvas.width = divChart.offsetWidth;
        ctx.canvas.height = divChart.offsetHeight;
        
        var data = {
            labels: label,
            datasets: [{
                label: 'USD Sent',
                data: firstValue,
                backgroundColor: "rgba(153,255,51,0.4)",// 填充的颜色
                pointRadius:5,
                pointStyle:'circle',
                borderColor:'#bbd9b7',// 折线的颜色设置
                pointBorderColor:'#00ff00', // 顶点圈圈的颜色
                pointBackgroundColor:'#00ff00' // 顶点的颜色
            }, {
                label: 'USD Recieved',
                data: secondValue,
                backgroundColor: "rgba(255,153,0,0.4)",// 填充的颜色
                pointRadius:5,
                pointStyle:'circle',
                borderColor:'#bbd9b7',// 折线的颜色设置
                pointBorderColor:'#ff0000', // 顶点圈圈的颜色
                pointBackgroundColor:'#ff0000' // 顶点的颜色
            }]
        };
        
        var options = {
            elements: {
                line: {tension: 0} // 设置折线图
            },
            legend: {display: false}, // 设置不显示图例
            responsive: false, // responsive和maintainAspectRatio设置为false才可以调整图标的宽高
            maintainAspectRatio: false,
            scales: {
                xAxes: [{
                    gridLines: {display:false} // 隐藏网格线
                }],
                yAxes: [{
                    gridLines: {display:false},
                    display: false, // 隐藏Y轴
                    ticks: { // 设置Y轴最大最小坐标点
                        min: 0, 
                        max: maxValue * MULTIPLE,
                    },
                }]
            },
            // 设置显示数据的顶点
            hover:{animationDuration:0},//防止鼠标移动到顶点时的闪烁效果
            animation:{
                "duration":1,
                "onComplete": function() {
                    var chartInstance = this.chart,
                        ctx = chartInstance.ctx;
                    ctx.fillStyle = 'black';
                    ctx.textAlign = 'center';
                    ctx.textBaseline = 'bottom';
                    this.data.datasets.forEach(function(dataset, i) {
                        var meta = chartInstance.controller.getDatasetMeta(i);
                        var len = meta.data.length;
                        meta.data.forEach(function(bar, index) {
                            var tempdata = dataset.data[index];
                            if(tempdata != null){
                                var arry = tempdata.toString().split(".");
                                tempdata = arry[0].toString().replace(/(d)(?=(?:d{3})+$)/g, '$1,');                                
                                if(arry.length > 1) tempdata = tempdata + '.' + arry[1];
                            }
                            var data = '$' + tempdata;
                            
                            // var data = '$' + dataset.data[index];
                            var Offset = data.length * 2;
                            var Offset = data.length * 2; // 偏移量
                            if(len >= 2){
                                if(index == 0){//first point style 
                                    ctx.fillText(data, bar._model.x + Offset, bar._model.y - 5);    
                                }else if(index == len -1){ // last point style
                                    ctx.fillText(data, bar._model.x - Offset, bar._model.y - 5);    
                                }else{
                                    ctx.fillText(data, bar._model.x, bar._model.y - 5);    
                                }
                            }else{// only one point style
                                ctx.fillText(data, bar._model.x + Offset, bar._model.y - 5);    
                            }
                        });
                    });
                }
            }
        };
        
        new Chart(ctx, {
            type: 'line',
            data: data,
            options: options
        });
        
    }
})
原文地址:https://www.cnblogs.com/luqinghua/p/12707502.html