zoukankan      html  css  js  c++  java
  • highcharts框架使用总结

      Highcharts官网地址:https://www.hcharts.cn/products/highcharts
      首先需要引入jQuery框架,然后包含Highcharts框架需要使用到的js文件,最新版本5.0.7的js是在code目录下,其中highcharts.js文件是必需的,其他文件根据需要使用的图表需要引入,如果需要使用图表的打印功能的话,需要引入modules/exporting.js文件。

    基本使用方法:
      在html页面为某个容器元素(如:div)定义一个id,然后在渲染页面的js中调用highcharts框架的方法:
    Highcharts.chart(id, option);
    其中id是页面某个元素的id,即我们希望图表在页面上展示的位置,option则是图表的一个配置对象变量,下面主要针对图表的这个配置变量进行讲解。

    Highcharts.chart(id, {
      chart: {//图表配置
        type: 'line',	      	    //图表默认类型,默认:line(pie:饼图,column,柱状图;line,折线图,funnel:漏斗图...)。
        height: null,	              //图表高度,默认:null,根据容器元素高度计算。
         null,	              //图表宽度,默认:null,根据容器元素宽度计算。
        backgroundColor: '#FFFFFF',	    //图表区背景颜色,默认:#FFFFFF。
        borderColor: '#335cad',	          //图表边框颜色,默认:#335cad。
        borderWidth: 0,	               //图表边框宽度,默认:0,需要设置图表边框颜色的话需要将其设置大于0。
        borderRadius: 0,	         	     //图表边框的圆角半径,默认:0。
        margin: [0,0,0,0],	         //图表外边缘和绘图区域之间的边距,默认:[0,0,0,0](顺序:上右下左)。
        polar: false	              //默认:false。当设置为true时,直线图、曲线图、面积图、柱状图等笛卡尔图会转成极地图,
                                  //例如,蜘蛛图就需要将其设置为true。极地图需要额外的引入highcharts-more.js才能使用。
      },
      title: {//标题配置
        text: 'Chart title',	         //图表标题文字,默认:Chart title。若不想显示标题可设置为null。
        align: 'center',	                //图表标题水平对齐方式,默认:center,可选:left、center、right。
        floating: false,	                //默认:false,如果设置为true,标题将不占用图表区的位置。
        style: {                 //标题样式配置
            color: '#000000',
            fontWeight: 'bold',
            fontSize: '20px'
        }
      },
      exporting: {//导出配置
        enabled:true	                //是否启用导出模块,默认:true。若想去除图表右上角导出按钮则设置为false。
      },
      credits: {//版权配置
        enabled:true	                //是否显示版权信息,默认:true。若想去除图表右下角highcharts官网链接则设置为false。
        text:'Highcharts.com',	    	     //版权信息显示内容,默认:Highcharts.com。
        href: ''	             	     //版权信息链接地址,默认:http://www.highcharts.com。
      },
      tooltip: {//数据提示框配置
        enabled: true,	         	     //是否启用数据提示框,默认:true。
        shared: true,               //数据提示框共享(一个x轴值对应有多个y轴值时,多个y轴值共享提示框)
        backgroundColor: '',	          //数据提示框背景色,默认:rgba(247,247,247,0.85)。
        borderColor: null,	        //数据提示框边框颜色,默认:null,使用该数据列或该点的颜色。
        borderWidth: 1,          	    //数据提示框边框宽度,默认:1。
        borderRadius: 3,	        	    //数据提示框圆角半径,默认:3。
        pointFormat: '',	                //数据提示框中该点的html代码。变量使用花括号括起来。
        pointFormatter: function(){},        //回调函数,返回格式化提示框中该点的html代码。
      },
      xAxis: {//x轴配置
        max: null,	             //坐标轴最大值,当设置为null时,将会自动计算。
                                  //当endOnTick参数值为true时,max值将会向上取整。
        min: null,	            //坐标轴最小值,当设置为null时,将会自动计算。注意:对数轴最小值不能为0,否则会出错。
                                  //如果设置了startOnTick为true时,最小值可能会进行向下取整。
        opposite: false,	         	   //是否将坐标轴显示在对立面,默认:false。
                                 //默认情况下x轴在图表下方,y轴在左边,设置为true后,x轴将在上方显示,y轴在右边显示。
        type: linear,	         	   //坐标轴类型,默认:linear。
                                  //可选:linear(线性轴)、logarithmic(对数轴)、datetime(时间轴)、category(分类轴)
        categories: null,	      //分类坐标轴中的分类,定义x轴刻度显示内容,默认:null。
        tickInterval:              //间隔多少显示刻度
        tickmarkPlacement: 'on',	         //本参数只对分类轴有效。当值为on时刻度线将在分类上方显示,当值为between时刻度线将
                                //在两个分类中间显示。当tickInterval为1时,默认是between,其他情况默认是on。
        labels: {//坐标轴标签配置
          enabled: true,	      //是否显示坐标刻度值,若不想显示则设置为false。
          rotation: -45,           //x轴刻度标题旋转一定角度
          formatter: function(){},      //回调函数,返回在刻度位置显示的格式化内容。
        },
        //十字准星线配置
        crosshair: true,             //若是柱状图直接配置true
         crosshair : {	           //其他图表类型需要配置样式
            1,
           color: 'gray',
           dashStyle: 'Solid'
         },
        visible: true	         	 //是否显示坐标轴,默认:true。包含坐标轴、坐标轴标题、坐标轴轴线、坐标轴标签等。
      },
      yAxis: {//y轴配置
                                //配置参数和x轴相同...
      },
      scrollbar : {//滚动条配置
          enabled:true	          //启用滚动条
      },
      series: {//数据列配置
        cursor: 'pointer',	      //鼠标在数据列上的形状,默认是箭头,可设置为pointer(手型)。
        name: '',	            //数据列名称,用于在legend(图例)、tooltip(数据提示框)中显示。
        data: [{	            	 //数据列数据配置,不同类型的图表数据列配置有所差异,这里示例的是柱状图数据列配置。
        x: 1,
        y: 5,
        name: '',
        color: ''
        }]
      },
      legend: {//图例配置
        enabled: true,	      	//图例开关,默认:true。
        align: 'center',	            //图例在图表区中的水平对齐方式,默认:center。可选:left、center、right。
        backgroundColor: ''	      //背景颜色
      },
      plotOptions: {
        series: {
          marker: {
            enabled: true	     //是否显示折线图上的点(折线图配置)
          },
          dataLabels: {
            enabled: true,	     //是否在图表上各个数据点显示对应数据
            color: '#a3a3a3',
            formatter: function() {  //格式化
              return this.y;
            }
          }
        },
      column: {
        colorByPoint: true	     //给柱状图每个点分配颜色(柱状图配置)
      }
    }
    });

      

    问题与方案:
    如果数据提示框中需要显示额外的信息,而且这个信息对于不同数据点是不同的,该怎么设置??
    可以在设置图表数据的data中的每个数据点对象添加额外属性,然后使用pointFormatter在回调函数中即可访问到这个额外的属性。
    拿我做过的一个实例来说:
    热力图表heatmap的data中每个数据点对象原本的格式为:{x:x轴位置, y:y轴位置, value:对应点的值},我可以在里面加多一个

    属性来为每个数据点存放额外的信息,如:tip: 数据点提示语,那么在pointFormatter回调函数中即可使用this.point.tip来访问这个属性了。

     

    特别注意:
    1.要确保x轴值和对应y轴值的正确对应,永远不要相信js的数组下标,js使用push方法添加数组元素之后数组中的元素并不是按push的先后顺序来排序的。
    2.x轴的min和max表示的是有滚动条的时候一屏显示多少数据,y轴的min和max表示的才是最大最小值。

    3.设置全局的scrollbar配置之后,只会在x轴开启滚动条,若想在y轴启用滚动条,需要在yAxis参数下添加配置:
    scrollbar: {
      enabled: true,
      showFull: false
    }

    4. 大坑:一定要注意series中的data数组里面的元素都必须是数字类型,若是字符串则会一直得不到图表显示。。而且数组的下标一定要从0开始,否则也会无法显示图表。。。

     

  • 相关阅读:
    zookeeper + dubbo 搭建
    java 测试 powermock 使用
    设计模式(结构型模式) 之 装饰器模式
    设计模式(创建型模式)工厂模式
    设计模式(结构型模式) 之 桥接模式
    django基础(转载)
    Django之ORM学习
    Django之form组件的学习
    Django之中间件学习
    Django之model 详解
  • 原文地址:https://www.cnblogs.com/wujuntian/p/6491856.html
Copyright © 2011-2022 走看看