Highcharts 是通过 JavaScript 对象的形式(JSON)来定义图表的配置参数。
一、图表配置对象
当使用图表构造函数 Highcharts.Chart 来初始化图表时,图表的配置对象是以第二个参数传递给该构造函数的。
下面是示例代码(其中红色部分是配置对象):
var options = {chart: {type: 'bar'},title: {text: 'Fruit Consumption'},xAxis: {categories: ['Apples', 'Bananas', 'Oranges']},yAxis: {title: {text: 'Fruit eaten'}},series: [{name: 'Jane',data: [1, 0, 4]}, {name: 'John',data: [5, 7, 3]}]};var chart = Highcharts.chart('container', options);
为了更好的使用 Highcharts 配置,你需要了解 JavaScript 对象的基本知识,下面我们简单的说一些 JavaScript 对象操作的要点。
1、对象的创建及赋值
对于 C语言风格的开发者来说,下面的方式更符合编写习惯
var oiptions = new Object();options.chart = new Object();options.chart.renderTo = 'container';options.chart.type = 'line';options.series = new Array();options.series[0] = new Object();options.series[0].name = '小明';options.series[0].data = new Array(1, 0, 4);
上述编写方式在 JS 里是不推荐的,更好的做法应该是
var options = {chart: {renderTo: 'container',type: 'line'},series: [{name: '小明',data: [1, 0, 4]}]}
因为后面的方式更简单易读(当然上述两种方式运行的结果是一样的),这也是 JSON 的优势。
创建配置对象后,我们就可以通过构造函数来创建图表了。
var chart = Highcharts.chart('container', options);
2、对象取值
在 JS 中可以通过逗号或中括号的形式取对象的值,另外可以通过 delete 删除对象属性,示例代码如下:
options.chart.type // JS 对象取值options.chart['type'] // 同上delete options.chart.type // 删除属性
3、数组相关操作
JS 数组的创建可以用 new Array() 或更简单的 [] 来创建,其中 length 属性为数组的长度,push() 函数可以添加数组元素;join() 可以将数组转换成字符串,相应字符串可以通过的 split() 函数将其分隔成数组,下面用示例代码说明:
var series = [{name: '小明',data: []}];series.push({name: '小红',data: []});series[2].name;var arr = [1, 2, 4, 10, 20];var arrJoin = arr.join(); // 结果"1,2,4,10,20",默认的分隔符是 ,arrJoin.split(','); // 将字符串按照 , 分隔,结果是 [1, 2, 4, 10, 20]
二、全局配置
全局配置是针对同一个页面多个图表有效的配置,我们将多个图表的相同配置提取出来并配置在全局配置中(这样就可以省去在每个图表中配置一样的参数,这也是 Highcharts API 灵活性的表现)。
实例代码如下:
// 全局配置,针对页面上所有图表有效Highcharts.setOptions({chart: {backgroundColor: {linearGradient: [0, 0, 500, 500],stops: [[0, 'rgb(255, 255, 255)'],[1, 'rgb(240, 240, 255)']]},borderWidth: 2,plotBackgroundColor: 'rgba(255, 255, 255, .9)',plotShadow: true,plotBorderWidth: 1}});var chart1 = Highcharts.chart('container', {xAxis: {type: 'datetime'},series: [{data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4],pointStart: Date.UTC(2010, 0, 1),pointInterval: 3600 * 1000 // one hour}]});var chart2 = Highcharts.chart('container', {chart: {type: 'column'},xAxis: {type: 'datetime'},series: [{data: [29.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4],pointStart: Date.UTC(2010, 0, 1),pointInterval: 3600 * 1000 // one hour}]});
