网页图表Highcharts实践教程之外层图表区

Highcharts图表区

图表区是图表的基本区域。所有的数据和图形都是绘制在图表区中。从图形绘制范围来分，图表区域分为外层图表区和绘图区。本章将详细讲解图表区的设置和创建。

Highcharts图表区的构成

为了方便管理，Highcharts将所有的图表元素都绘制在一个Box区域内，如图2.1所示。这个区域被称为图表区。由于图表中最重要的数据就是图表图形，所以图表图形所在的区域又构成一个独立的区域，称为绘图区，如图2.1所示。

图2.1 图表区构成

从图2.1中可以看到，整个图表区由坐标轴构成的矩形分为两个部分：一部分是坐标轴围成的绘图区，一部分是图表区和绘图区之间的部分，称为外层图表区。下面依次讲解这两个部分。

Highcharts外层图表区

外层图表区是图表区和绘图区之间的部分。标题、图例这类图表元素往往都分布在这个区域中。本节将详细讲解外层图表区的设置。

Highcharts外层图表区的基本设置

外层图表区基本设置主要包括图表类型、图表区所在的HTML元素、外层图表区的宽高等属性。下面依次讲解这些属性。

1.图表类型type

在Highchart中，每种图表都是由chart组件实现的。所以，要得到不同类型的图表，必须指定图表类型。图表类型由type配置项指定。语法形式如下：

type:string

其中，string是Highcharts指定的图表类型字符串。其值可以为area、arearange、areaspline、areasplinerange、bar、goxplot、bubble、column、columnrange、errorbar、funnel、gauge、heatmap、line、pie、pyramid、scatter、series、solidgauge、spline、waterfail。如果不指定，默认就是line类型。

在实例1-1中指定了图表类型为line（折线）类型。

type: 'line'

2.图表区所在HTML元素renderTo

在脚本中，也可以通过配置项renderTo直接指定图表绘制在网页中哪个容器中。语法形式如下：

renderTo: String

其中，String是网页元素的id。

在实例1-1中，直接使用了jQuery的选择器，所以没有指定该选项。

3.指定外层图表区大小

在Highcharts中，可以通过配置项width、height指定外层图表区的宽和高。语法形式如下：

width:Number1
height:Number2

其中，Number1、Number2分别是图表区的宽高值。单位为像素。

【实例2-1：chartheightandwidth】修改实例1-1的代码，将图表区宽度设定300px，高度设定为200px。代码如下：

chart: {
type: 'line',
height: 200, //指定宽度
width: 300, //指定高度
borderWidth: 1
},

执行后，效果如图2.2所示。

注意：为了显示图表区大小，这里设置了图表区的边框宽度为1px。

图2.2 设置图表区的长和宽

如果不设定图表区的长宽值，Highcharts会根据图表区中的元素自动计算。如果图表区包含的元素高度为0，则将Heigh设置为400px。

4.指定外层图表区背景颜色

为了美化图表显示效果，可以通过配置项backgroundColor来指定图表区的背景颜色。语法如下：

backgroundColor: Color

其中，Color是使用单引号括起来的颜色值。默认值是#FFFFFF。

【实例2-2：chartbackgroundColor】修改实例2-1的代码，设定图表区的背景颜色为#FFFF00。代码如下：

chart: {
type: 'line',
height: 200,
width: 400,
borderWidth: 1,
backgroundColor: '#FFFF00' //设定背景颜色
},

执行后，效果如图2.3所示。

图2.3 设置图表区背景颜色

Highcharts外层图表区的边框

在Highcharts中，允许为外层图表区设置边框。相关的配置项包括宽度borderWidth、颜色borderColor、边框圆角半径borderRadius。其语法如下：

borderWidth:Number1
borderColor:Color
borderRadius:Number2

其中，Number1表示边框的宽度，默认值为0，表示没有边框；Color是表示颜色的字符串；Number2表示边框的圆角半径。Number1和Number2的的单位均为像素px。

【实例2-3：chartborder】下面修改实例1-1的代码，为图表区添加边框。需要修改的代码如下：

chart: {
type: 'line',
borderWidth: 3, //设置边框的宽度
borderColor: '#000000', //设置边框的颜色
borderRadius:10 //设置边框的圆角
},

执行后，效果如图2.4所示。

图2.4 设置图表区的边框

Highcharts外层图表区的范围

外层图表区位于图表区内部，绘图区外部，如图2.5的浅绿色部分所示。通常，外层图表区的范围由Highcharts自动计算。

图2.5 图表区和绘图区的间距

用户也可以通过chart组件的配置项marginBottom、marginLeft、marginRight、marginTop属性来分别设置两个区域的下边距、左边距、右边距和上边距。语法如下：

marginBottom:Number1
marginLeft:Number2
marginRight:Number3
marginTop:Number4

其中，Number1、Number2、Number3、Number4分别表示各个边距值。单位为px。这四个配置项可以同时使用，也可以分开使用。

【实例2-4：chartmargin】修改实例1-1的图表区和绘图区下间距，将其设置为2。修改代码如下：

chart: {
type: 'line',
borderWidth: 1,
marginBottom: 2, //设置下边距
marginLeft: 30, //设置左边距
marginRight: 30, //设置右边距
marginTop:20 //设置上边距
},

执行后，效果如图2.6所示。从运行结果中可以看到，当边距设置不当，会造成部分图表内容显示不完整，甚至丢失。例如，x坐标轴的刻度没有显示。

图2.6 修改图表区和绘图区间距

为了简化操作，Highcharts提供一个配置项margin，可以一次性对四个边距直接设置。语法如下：

margin:Array

其中，Array是一个数组，用来设置图表区和绘图区的上边距、右边距、下边距和左边距。使用该属性后，实例2-4的代码就可以简化为：

var options = {
chart: {
type: 'line',
borderWidth: 1,
margin:[2,30,30,20] //依次设置上边距、右边距、下边距、左边距
},

Highcharts外层图表区和图表内容的间距

为了美观，图表中的内容和图表区之间有一定的间距。如图2.7所示，绿色的部分为两者之间的间距。对于这部分间距，chart组件提供了对应的配置项来设置。例如，配置项spacingBottom用来设置下端间距；配置项spacingLeft用来设置左侧间距；配置项spacingRight用来设置右侧间距；配置项spacingTop用来设置顶部间距。

图2.7 图表区和图表内容的间距

这四个配置项的语法如下：

spacingBottom: Number1
spacingLeft: Number2
spacingRight: Number3
spacingTop: Number4

其中，Number1参数用来设置底部间距，默认值为15；Number2参数用来设置左侧间距，默认值为10；Number3参数用来设置右侧间距，默认值为10；Number4参数用来设置顶部间距，默认值为10。

【实例2-5：spacing】下面取消实例1-1中，图表内容和图表区的间距。修改代码如下：

chart: {
type: 'line',
borderWidth: 1,
spacingBottom: 0, //设置底部间距
spacingLeft: 0, //设置左侧间距
spacingRight: 0, //设置右侧间距
spacingTop:0 //设置顶部间距
},

执行后，效果如图2.8所示。从图中可以发现，取消间距后，图例和标题紧贴外层图表区边框。

图2.8 取消图表区和图表内容间距

为了方便设置，chart组件提供一个配置项spacing，用来同时设置四个间距。语法形式如下：

spacing:Array

其中，Array参数是由四个数值构成的数组。其中每个数值依次表示顶部、右侧、底部、左侧间距值。使用属性spacing可以简化实例2-5的代码。简化后的代码如下：

chart: {
type: 'line',
borderWidth: 1,
spacing:[0,0,0,0] //依次设置四个间距值
},

间距值也可以设置为负数，代码如下：

spacing:[-10,-10,-10,-10]

这个时候，会造成部分图表内容显示不完整，如图2.9所示。标题和图例都没有完全显示。

图2.9 间距值为负值

注意：版权信息部分不受间距影响。

Highcharts外层图表区阴影

为了增加立体感，chart组件提供阴影配置项。其语法如下：

shadow: Boolean|Object

其中，shadow的参数可以是布尔值true/false，也可以是参数对象。

（1）当为布尔值的时候，可以使用true和false表示是否有属性。

【实例2-6：shadow】下面为实例1-1添加阴影效果。修改代码如下：

chart: {
type: 'line',
shadow:true //启用阴影效果
},

执行后，效果如图2.10所示。在图表区的右侧和底端均出现灰色的阴影效果。

图2.10 图表阴影

（2）用户也可以采用对象的方式添加阴影效果。语法形式如下：

{
color:Color,
setX:Number1,
setY:Number2,
opacity:Number3,
width:Number4
}

其中，配置项color表示阴影的颜色；配置项setX表示阴影在x轴上的偏移距离；配置项setY表示阴影在y轴上的偏移距离；配置项opacity表示阴影的透明度；配置项width设置阴影的宽度。

【实例2-7：shadowObject】使用对象的方式重新实现实例2-6的阴影效果。修改代码如下：

chart: {
type: 'line',
shadow: {
color: 'grey', //设置阴影颜色
offsetX: 1, //设置x轴方向的偏移距离
offsetY: 1, //设置y轴方向的偏移距离
opacity: 0.5, //设置透明度
width: 2 //设置阴影宽度
}
},