highchart属性详解

Zerofishcoding 2015-06-12

原文地址:http://www.aimks.com/basic-properties-and-methods-rounding-highcharts.html

Highcharts的基本属性和方法详解

Highcharts 是一个用纯JavaScript编写的一个图表库, 能够很简单便捷的在web网站或是web应用程序添加有交互性的图表,并且免费提供给个人学习、个人网站和非商业用途使用。

目前HighCharts支持的图表类型有曲线图、区域图、柱状图、饼状图、散状点图和综合图表。

HighCharts界面美观,由于使用JavaScript编写,所以不需要像Flash和Java那样需要插件才可以运行,而且运行速度快。另外HighCharts还有很好的兼容性,能够完美支持当前大多数浏览器。

下面给出实例并详解分析他们:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<script type="text/javascript" src="js/jquery.min.js"></script>  
<script type="text/javascript" src="js/highcharts.js"></script>   
<script type="text/javascript">  
var chart;  
$(document).ready(function() {  
    chart = new Highcharts.Chart({  
        chart: {  
            renderTo: 'container',//设置显示图表的容器  
            type: 'line',//设置图表样式,可以为line,spline, scatter, splinearea bar,pie,area,column  
//          defaultSeriesType: 'column', //图表的默认样式  
//          margin:[21, 23, 24, 54],//整个图表的位置(上下左右的空隙)  
            marginRight: 200,//右边间距  
            marginBottom: 25//底部间距/空隙  
//          inverted: false,//可选,控制显示方式,默认上下正向显示  
//          shadow:true,//外框阴影  
//          backgroundColor:"#FFF",  
//          animation:true,  
//          borderColor:"#888",  
//          borderRadius:5,  
//          borderWidth:1,  
//          ignoreHiddenSeries:true,  
//          reflow:true,  
//          plotBorderWidth:1,  
//          alignTicks:true  
        },  
        labels:{//在报表上显示的一些文本  
            items:[{  
                html:'本图表数据有误,仅用于说明相应的属性',  
                style:{left:'100px',top:'60px'}  
            }, {  
                html:'http://www.highcharts.com/demo',  
                style:{left:'100px',top:'100px'}  
            }]  
        },  
        credits:{//右下角的文本  
            enabled: true,  
            position: {//位置设置  
                align: 'right',  
                x: -10,  
                y: -10  
            },  
            href: "http://www.highcharts.com",//点击文本时的链接  
            style: {  
                color:'blue'  
            },  
            text: "Highcharts Demo"//显示的内容  
        },  
//        plotOptions:{//绘图线条控制  
//            spline:{  
//                allowPointSelect :true,//是否允许选中点  
//                animation:true,//是否在显示图表的时候使用动画  
//                cursor:'pointer',//鼠标移到图表上时鼠标的样式  
//                dataLabels:{  
//                   enabled :true,//是否在点的旁边显示数据  
//                    rotation:0  
//                },  
//                enableMouseTracking:true,//鼠标移到图表上时是否显示提示框  
//                events:{//监听点的鼠标事件  
//                    click: function() {  
//                    }  
//                },  
//                marker:{  
//                    enabled:true,//是否显示点  
//                   radius:3,//点的半径  
//                      fillColor:"#888"  
//                    lineColor:"#000"  
//                    symbol: 'url(http://highcharts.com/demo/gfx/sun.png)',//设置点用图片来显示  
//                    states:{  
//                        hover:{  
//                            enabled:true//鼠标放上去点是否放大  
//                                                    },  
//                        select:{  
//                            enabled:false//控制鼠标选中点时候的状态  
//                        }  
//                    }  
//               },  
//                states:{  
//                    hover:{  
//                        enabled:true,//鼠标放上去线的状态控制  
//                        lineWidth:3  
//                    }  
//                },  
//                stickyTracking:true,//跟踪  
//                visible:true,  
//                lineWidth:2//线条粗细  
//                pointStart:100,  
//            }  
//        },  
 
        title: {  
            text: 'Monthly Average Temperature',//标题  
            x: -20 //center设置标题的位置  
        },  
        subtitle: {  
            text: 'Source: WorldClimate.com',//副标题  
            x: -20//副标题位置  
        },  
        xAxis: {//横轴的数据  
            categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',  
                'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']  
//          lineWidth:1,//纵轴一直为空所对应的轴,即X轴  
//          plotLines: [{//一条竖线  
//               color: '#FF0000',  
//               width: 2,  
//               value: 5.5  
//           }]  
//          labels: {//设置横轴坐标的显示样式  
//              rotation: -45,//倾斜度  
//              align: 'right',  
//              style: {  
//                   font: 'normal 13px Verdana, sans-serif'  
//                   color: 'white'  
//              }  
//          }  
 
        },  
        yAxis: {  
//          tickInterval: 200,  //自定义刻度  
//          max:1000,//纵轴的最大值  
//          min: 0,//纵轴的最小值  
            title: {//纵轴标题  
                text: '百分数'  
            },  
            labels : {  
                formatter : function() {//设置纵坐标值的样式  
                 return this.value + '%';  
                }  
               },   
            plotLines: [{  
                value: 0,  
                width: 1,  
                color: '#808080'  
            }]  
        },  
        tooltip: {//鼠标移到图形上时显示的提示框  
            formatter: function() {  
                    return '<b>'+ this.series.name +'</b><br />'+  
                    this.x +': '+ this.y +'°C';  
            }  
//          crosshairs:[{//控制十字线  
//              width:1,  
//              color:"#CCC",  
//              dashStyle:"longdash"  
//          }  
 
        },  
        legend: {//方框所在的位置(不知道怎么表达)  
            layout: 'vertical',  
            align: 'right',  
            verticalAlign: 'top',  
            x: -10,  
            y: 100,  
            borderWidth: 0  
        },  
        series: [{//以下为纵轴数据  
            name: 'Tokyo',  
            data: [7.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]  
        }, {  
            name: 'London',  
            data: [3.9, 4.2, 5.7, 8.5, 11.9, 15.2, 17.0, 16.6, 14.2, 10.3, 6.6, 4.8]  
        }]  
    });  
});  
</script>  
 
<body>  
<div id="container" ></div>  
</body>

一.chart的部分相关属性说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
renderTo: 'container',      //图表的页面显示容器(也就是要显示到的div)
    defaultSeriesType: 'line',  //图表类型(line、spline、scatter、splinearea、bar、pie、area、column)
    marginRight: 50,            //上下左右空隙(图表跟图框之间)
    marginBottom: 60,           //下面空隙如果不够大,图例说明有可能看不到
    plotBackgroundImage: '../graphics/skies.jpg', //(图表的)背景图片
    plotBackgroundColor:        //背景颜色
    width: 1000,                //图框(最外层)宽(默认800)
    height: 500,                //图框高(默认500) 
    backgroundColor: "red"      //图框的背景颜色
    borderColor: "red"          //图框的边框颜色
    borderRadius: 5,            //图框的圆角大小
    borderWidth: 9,             //图框的边框大小
    inverted: false,            //(使图)倒置
    plotBorderColor: "red",     //图表的边框颜色
    plotBorderWidth: 0,         //图表的边框大小
    plotShadow: false,          //图表是否使用阴影效果
    reflow: false,   
    shadow:true                 //图框是否使用阴影
    showAxes: false,            //是否最初显示轴
    spacingTop: 100,            //图表上方的空白
    spacingRight: 10,
    spacingBottom: 15,
    spacingLeft: 10,
    colors: [...]                 //图上线。。的颜色

二. credits的部分相关属性说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
credits:  //设置右下角的标记。highchart.com (这个也可以在highcharts.js里中修改)
    {    
        //enabled: true,      //是否显示
        position: {           //显示的位置                   
            align: 'left',       
            x: 10                           
        },
        text: "xoyo.com",           //显示的文字
        style:{                     //样式
            cursor: 'pointer',
            color: 'red',
            fontSize: '20px'
        },
        href: 'http://www.xoyo.com', //路径
    },

三. title的部分相关属性说明

1
2
3
4
5
6
7
8
9
10
11
title: //标题
    { 
        text: '月份平均温度',
        x: -20,                  //center //水平偏移量 
        y: 100                   //y:垂直偏移量
        align: 'right'         //水平方向(left, right, bottom, top)
        floating: true,          //是否浮动显示
        margin: 15,
        style: ,                 //样式
        verticalAlign: "left"    //垂直方向(left, right, bottom, top)
    },

四. xAxis或者YAxis的部分相关属性说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
categories: ['一月', '二月'],
    //allowDecimals: false
    //alternateGridColor: 'red'       //在图表中相隔出现纵向的颜色格栅
    //dateTimeLabelFormats: ,
    //endOnTick: false,               //是否显示控制轴末端的一个cagegories出来
    //events: {
    //setExtremes:
    //},
    //gridLineColor: "red",           //纵向格线的颜色
    //gridLineDashStyle: Solid        //纵向格栅线条的类型
    //gridLineWidth: 5,               //纵向格线的的大小
    //id: null,
    //labels: {  //X轴的标签(下面的说明)
        //align: "center",              //位置
        //enabled: false,               //是否显示
        //formatter: ,
        //rotation: 90,                 //旋转,效果就是影响标签的显示方向
        //staggerLines: 4,              //标签的交错显示(上、下)
        //step: 2,                      //标签的相隔显示的步长
        //style:{},
        //x: 100,                     //偏移量,默认两个都是0,
        //y: 40
 
    //},
    //lineColor: "red",               //X轴的颜色
    //lineWidth: 5,                   //X轴的宽度
    //linkedTo:1,
    //opposite: true                  //是否把标签显示到对面
    //max: 12,                        //显示的最大值
    //maxPadding: 6,
    //maxZoom: 1,
    //min: 10,                        //显示的最小值
    //minorGridLineColor: 'red',        //副格线的颜色
    //minorGridLineDashStyle: 'blod', //副格线的的颜色
    //minorGridLineWidth: 50,         //副格线的宽度
    //minorTickColor: #A0A0A0,        //没有看出效果
    minorTickInterval:3,               //副标记的间隔
    //minorTickLength: 10,             //副标记的长度
    //minorTickPosition: 'inside',     //副标记的位置
    //minorTickWidth: 5,               //副标记的宽
    //minPadding: 0.01,
    //offset: 0,                       //坐标轴跟图的距离
    //plotBands: //使某数据块显示不同的效果    
    //plotLines: [{         //标线属性
        //value: 0,      //值为0的标线
    //}],        
    //tickmarkPlacement: "on",   //标记(文字)显示的位置,on表示在正对位置上。
    //reversed: true,            //是否倒置
    //showFirstLabel: false,     //第一个标记的数值是否显示
    //startOfWeek: 2,
    //tickColor: 'blue',         //标记(坐标的记号)的颜色
    //tickInterval: 20,          //标记(坐标的记号)的步长
    //tickLength: 5,
    //tickmarkPlacement: "on",
    //tickPixelInterval: 1000,   //两坐标之间的宽度
    //tickPosition: "inside",    //坐标标记的方向
    //title: {                   //设置坐标标题的相关属性
        //margin: 40,
        //rotation: 90,
        //text: "Y-values",
        //align: "middle",
        //enabled: "middle",
        //style: {color: 'red'}
    //},
    //type: "linear"

五.tooltip的部分相关属性说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
tooltip: //提示框设置
    {      
        formatter: function() {  //格式化提示框的内容样式
        return '<b>'+ this.series.name +'</b><br />'+
                this.x +': '+ this.y +'°C';
        },                       
        backgroundColor: '#CCCCCC',   //背景颜色
        //borderColor: '#FCFFC5'      //边框颜色
        //borderRadius: 2             //边框的圆角大小
        borderWidth: 3,               //边框宽度(大小)
        //enabled: false,             //是否显示提示框
        //shadow: false,              //提示框是否应用阴影,没有看出明显效果
        //shared: true,               //当打开这个属性,鼠标几个某一区域的时候,如果有多条线,所有的线上的据点都会有响应(ipad)
        //snap: 0,                    //没有看出明显效果
        crosshairs: {                 //交叉点是否显示的一条纵线
            width: 2,
            color: 'gray',
           dashStyle: 'shortdot'
        }
        style: {  //提示框内容的样式
            color: 'white',
            padding: '10px',    //内边距 (这个会常用到)
            fontSize: '9pt',            
        }
    },

六.legend(图例说明)的部分相关属性说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
legend: //图例说明
    {   
        //layout: 'vertical',   //图例说明布局(垂直显示,默认横向显示)
        align: 'center',        //图例说明的显示位置
        //verticalAlign: 'top', //纵向的位置
        //x: 250,                 //偏移量 
        //y: 0,               
        borderWidth: 1,            //边框宽度
        //backgroundColor: 'red'   //背景颜色
        borderColor: 'red',
        //borderRadius             //边框圆角
        //enabled: false          //是否显示图例说明
        //floating:true           //是否浮动显示(效果就是会不会显示到图中)
        //itemHiddenStyle: {color: 'red'},
        //itemHoverStyle: {color: 'red'}   //鼠标放到某一图例说明上,文字颜色的变化颜色
        //itemStyle:  {color: 'red'}   //图例说明的样式
        //itemWidth:                   //图例说明的宽度
        //labelFormatter: function() { return this.value}       //默认(return this.name)
        //lineHeight: 1000             //没看出明显效果
        //margin: 20
        //reversed:true                //图例说明的顺序(是否反向)
        //shadow:true                  //阴影
        //style: {color:'black'}
        //symbolPadding: 100           //标志(线)跟文字的距离
        //symbolWidth: 100             //标志的宽
        //width:100
    },

七. plotOptions的部分修改属性说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
plotOptions:
    {  
        column: //柱形图
        {
            //pointPadding: 0.2,
            //borderWidth: 1,               //柱子边框的大小
            //borderColor: "red",           //柱子边框的颜色
            //borderRadius: 180,            //柱子两端的圆角的半径
            //colorByPoint: true,           //否应该接受每系列的一种颜色或每点一种颜色
            groupPadding: 0,                //每一组柱子之间的间隔(会影响到柱子的大小)
            //minPointLength: 0,            //最小数据值那一条柱子的长度(如果是0,可能看不到,可以设置出来)
            //pointPadding: 0.1,            //柱子之间的间隔(会影响到柱子的大小)
            //pointWidth: 2,                //柱子的大小(会影响到柱子的大小)
            //allowPointSelect: false, 
            //animation: true,              //图形出来时候的动画
            //color: 'red',                 //柱子的颜色
            //connectNulls: false,          //连接图表是否忽略零点(如线形图,数据为0是是否忽略)
            //cursor: '',                   //游标
            //dashStyle: null,
            dataLabels: { //图上是否显示数据标签
            //enabled: true,
            align: "center",
            //color: 'red',
            formatter: function() 
            {
                return this.y + 'mm'
            },
            rotation: 270,
            //staggerLines: 0,
            //step: ,
            //style: ,
            //x: 0,
            //y: -6
            },
            //enableMouseTracking: 
            events: {    //事件
            click: function(event)
            {
                alert(this.name);
            },
            //checkboxClick: ,
            //hide: ,
            //legendItemClick: ,
            //mouseOver: ,
            //mouseOut: ,
            //show:
            },
            //id: null,
            //lineWidth: 20,
            //marker: {  //图例说明上的标志
            //enabled: false
            //},
            point: {     //图上的数据点(这个在线形图可能就直观)
            events: {
                click: function() 
                {
                alert(this.y);
                },
                //mouseOver: ,
                //mouseOut: ,
                //remove: ,
                //select: ,
                //unselect: ,
                //update:
                }
            },
            //pointStart: 0,     //显示图数据点开始值
            //pointInterval: 1,  //显示图数据点的间隔
            //selected: false,
            //shadow: true,
            //showCheckbox: true,  //是否显示(图例说明的)复选框
            //showInLegend: false, //是否显示图例说明
            //stacking: 'percent', //是否堆积
            states: 
            {
                            hover: 
                {
                                //brightness: 0.1,
                                enabled: true,    //图上的数据点标志是否显示
                                //lineWidth: 2,    //没看出效果
                                marker: 
                {
                                    //states: ,
                                    //enabled: true,         //数据点标志是否显示
                                    //fillColor: null,       //数据点标志填充的颜色
                                    //lineColor: "#FFFFFF",  //数据点标志线的颜色
                                    //lineWidth: 0,          //数据点标志线的大小
                                    //radius: 45,            //数据点标志半径
                                    //symbol: 'triangle'//'url(http://highcharts.com/demo/gfx/sun.png)' //数据点标志形状(triangle三角形,或者用图片等等)
                                }
                            }
                     },
             //stickyTracking: true,  //轨道粘性 (例如线图,如果这个设置为否定,那就必须点到数据点才有反应)
             //visible: true,         //设置为false就不显示图
             //zIndex: null           //层级
    },

相关推荐