Highcharts图表库使用教程[Highcharts详细参数配置]

Highcharts介绍：


Highcharts是Javascript图标库，提供包括线，样条，面积，areaspline，柱形图，条形图，饼图和散点图等类型直观、互动性图表。最关键是功能强大，使用简单，无需基础！
Highcharts 官网示例：http://www.highcharts.com/demo/
Highcharts 官网下载：http://www.highcharts.com/download

Highcharts结构：

var chart = new Highcharts.Chart({
  chart: {…}        // 配置chart图表区
  colors: [{...}]    // 配置主体显示颜色（多个线条和柱体的颜色顺序的）
  credits: {…}      // 配置右下角版权链接
  exporting: {…}  	  // 配置导出及打印
  global: {…}       // HighCharts国际化方法调用
  labels: {…}       // HTML标签，可以放置在绘图的任何位置
  lang: {…}        	 // 语言对象属性配
  legend: {…}       // 配置图例选项
  loading: {…}    	  // 配置图表加载选项
  navigation: {…}   // 配置导出按钮属性
  pane: {…}        	 // 仅适用于极性图表和角仪表
  plotOptions: {…}  // 配置数据点选项
  series: [{...}]   // 配置数据列选项
  subtitle: {…}     // 配置副标题
  title: {…}        // 配置标题
  tooltip: {…}      // 配置数据点提示框
  xAxis: {…}        // 配置x轴选项
  yAxis: {…}        // 配置y轴选项
})

Highcharts详细参数配置：

Chart：图表区选项：Chart图表区选项用于设置图表区相关属性。




参数
描述
默认值


backgroundColor
设置图表区背景色
#FFFFFF


borderWidth
设置图表边框宽度
0


borderRadius
设置图表边框圆角角度
5


renderTo
图表放置的容器，一般在html中放置一个DIV，获取DIV的id属性值
null


defaultSeriesType
默认图表类型line, spline, area, areaspline, column, bar, pie , scatter
0


width
图表宽度，默认根据图表容器自适应宽度
null


height
图表高度，默认根据图表容器自适应高度
null


margin
设置图表与其他元素之间的间距，数组，如[0,0,0,0]
[null]


plotBackgroundColor
主图表区背景色，即X轴与Y轴围成的区域的背景色
null


plotBorderColor
主图表区边框的颜色，即X轴与Y轴围成的区域的边框颜色
null


plotBorderWidth
主图表区边框的宽度
0


shadow
是否设置阴影，需要设置背景色backgroundColor。
false


reflow
是否自使用图表区域高度和宽度，如果没有设置width和height时，会自适应大小。
true


zoomType
拖动鼠标进行缩放，沿x轴或y轴进行缩放，可以设置为：'x','y','xy'
''


events
事件回调，支持addSeries方法，click方法，load方法，selection方法等的回调函数。




Color：颜色选项：Color颜色选项用于设置图表的颜色方案。




参数
描述
默认值


color
用于展示图表，折线/柱状/饼状等图的颜色，数组形式。
array



Highcharts已经默认提供了多种颜色方案，当要显示的图形多于颜色种类时，多出的图形会自动从第一种颜色方案开始选取。自定义颜色方案的方法：

Highcharts.setOptions({    colors: ['#058DC7', '#50B432', '#ED561B', '#DDDF00', '#24CBE5', '#64E572', '#FF9655', '#FFF263', '#6AF9C4'] });

Title：标题选项：Title标题选项用于设置图表的标题相关属性。




参数
描述
默认值


text
标题文本内容。
Chart title


align
水平对齐方式。
center


verticalAlign
垂直对齐方式。
top


margin
标题与副标题之间或者主图表区间的间距。
15


floating
是否浮动，如果为true，则标题可以偏离主图表区，可配合x,y属性使用。
false


style
设置CSS样式。
{color: '#3E576F',fontSize: '16px'}



Subtitle：副标题选项：副标题提供的属性选项与标题title大致相同，可参照上述标题选项，值得一提的是副标题的text选项默认为''，即空的，所以默认情况下副标题不显示。

xAxis：X轴选项：X轴选项用于设置图表X轴相关属性。




参数
描述
默认值


categories
设置X轴分类名称，数组，例如：categories: ['Apples', 'Bananas', 'Oranges']
[]


title
X轴名称，支持text、enabled、align、rotation、style等属性



labels
设置X轴各分类名称的样式style，格式formatter，角度rotation等。
array


max
X轴最大值(categories为空时)，如果为null，则最大值会根据X轴数据自动匹配一个最大值。
null


min
X轴最小值(categories为空时)，如果为null，则最小值会根据X轴数据自动匹配一个最小值。
array


gridLineColor
网格（竖线）颜色
#C0C0C0


gridLineWidth
网格(竖线)宽度
1


lineColor
基线颜色
#C0D0E0


lineWidth
基线宽度
0



yAxis：Y轴选项：Y轴选项与上述xAxis选项基本一致，请参照上表中的参数设置，不再单独列出。

Series：数据列选项：数据列选项用于设置图表中要展示的数据相关的属性。




参数
描述
默认值


data
显示在图表中的数据列，可以为数组或者JSON格式的数据。如：data:[0, 5, 3, 5]，或data: [{name: 'Point 1',y: 0}, {name: 'Point 2',y: 5}]
''


name
显示数据列的名称。
''


type
数据列类型，支持 area, areaspline, bar, column, line, pie, scatter or spline
line



plotOptions：数据点选项：plotOptions用于设置图表中的数据点相关属性。plotOptions根据各种图表类型，其属性设置略微有些差异，现将常用选项列出来。




参数
描述
默认值


enabled
是否在数据点上直接显示数据
false


allowPointSelect
是否允许使用鼠标选中数据点
false


formatter
回调函数，格式化数据显示内容
formatter: function() {return this.y;}



Tooltip：数据点提示框：Tooltip用于设置当鼠标滑向数据点时显示的提示框信息。




参数
描述
默认值


enabled
是否显示提示框
true


backgroundColor
设置提示框的背景色
rgba(255, 255, 255, .85)


borderColor
提示框边框颜色，默认自动匹配数据列的颜色
auto


borderRadius
提示框圆角度
5


shadow
是否显示提示框阴影
true


style
设置提示框内容样式，如字体颜色等
color:'#333'


formatter
回调函数，用于格式化输出提示框的显示内容。返回的内容支持html标签如：<b>, <strong>, <i>, <em>, <br/>, <span>
2



Legend：图例选项：legend用于设置图例相关属性。




参数
描述
默认值


layout
显示形式，支持水平horizontal和垂直vertical
horizontal


align
对齐方式。
center


backgroundColor
图例背景色。
null


borderColor
图例边框颜色。
#909090


borderRadius
图例边框角度
5


enabled
是否显示图例
true


floating
是否可以浮动，配合x，y属性。
false


shadow
是否显示阴影
false


style
设置图例内容样式
''



Highcharts使用案例一：【简单线形图图表实现】

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
<script src="./js/highcharts.js"></script>
<script src="./js/themes/grid.js"></script><!---选择主题,可以不加载 by http://www.phpddt.com---> <script src="./js/modules/exporting.js"></script><!---导出图表，可以不加载--->
<script type="text/javascript">
$(function () {
        $('#container').highcharts({
            //设置图表区相关属性
            chart: {
                defaultSeriesType: 'line'
            },
            //配置标题
            title: {
                text: '这是title',
                x: -20
            },
            //配置副标题
            subtitle: {
                text: '这是sub title ',
                x: -20
            },
            //配置x轴
            xAxis: {
                categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
                    'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
            },
            //配置y轴
            yAxis: {
                title: {
                    text: '这是yAxis'
                },
                //设置X轴各分类名称的样式style
                labels: {
                    rotation: -45,
                    align: 'right',
                    style: {
                        fontSize: '9px',
                        fontFamily: 'Verdana, sans-serif'
                    }
                },
            },
            //配置数据点提示框
            tooltip: {
                valueSuffix: '°C'
            },
            //设置图例相关属性。
            legend: {
                layout: 'vertical',
                align: 'right',
                verticalAlign: 'middle',
                borderWidth: 0
            },
            //配置数据列 
            series: [{
                    name: 'Tokyo',
                    data: [17.0, 6.9, 9.5, 14.5, 18.2, 21.5, 25.2, 26.5, 23.3, 18.3, 13.9, 9.6]
                }, {
                    name: 'New York',
                    data: [-0.2, 0.8, 5.7, 11.3, 17.0, 22.0, 24.8, 24.1, 20.1, 14.1, 8.6, 2.5]
                }, {
                    name: 'Berlin',
                    data: [-0.9, 0.6, 3.5, 8.4, 13.5, 17.0, 18.6, 17.9, 14.3, 9.0, 3.9, 1.0]
                }]
        });
    });
</script>
<div id="container" style="min-width: 310px; height: 400px; margin: 0 auto"></div>

效果图如下：



Highcharts使用案例二：【简单饼状图图表实现】

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
<script src="./js/highcharts.js"></script>
<script type="text/javascript">
$(function () {
    $('#container').highcharts({
        chart: {
            plotBackgroundColor: null,
            plotBorderWidth: null,
            plotShadow: false
        },
        title: {
            text: 'PHP点点通-http://www.phpddt.com'
        },
        tooltip: {
    	    pointFormat: '{series.name}: <b>{point.percentage:.1f}%</b>'
        },
        plotOptions: {
            pie: {
                allowPointSelect: true,
                cursor: 'pointer',
                dataLabels: {
                    enabled: true,
                    color: '#000000',
                    connectorColor: '#000000',
                    format: '<b>{point.name}</b>: {point.percentage:.1f} %'
                }
            }
        },
        series: [{
            type: 'pie',
            name: 'Browser share',
            data: [
                ['Firefox',   45.0],
                ['IE',       26.8],
                {
                    name: 'Chrome',
                    y: 12.8,
                    sliced: true,
                    selected: true
                },
                ['Safari',    8.5],
                ['Opera',     6.2],
                ['Others',   0.7]
            ]
        }]
    });
});
</script>
<div id="container" style="min-width: 310px; height: 400px; margin: 0 auto"></div>

效果如下图：