关于Highcharts图表组件动态修改属性的方法（API）总结之Series

Highcharts图表组件内的Series很重要，如果说Categries是其大脑，那么Series就是其心脏。这两者才是Highcharts图表组件的重中之重啊。接下来就为大家介绍关于设置Series的相关方法。

一、目录结构

二、API

1、addPoint（添加一个数据点）

参数：

options：数据值（①可以是具体的一个Y轴数值，那么X轴坐标系统会随即分配一个；②可以设置一个数组，有着X和Y的数值，如：[xValue,yVlaue] 这样的形式；③可以设置一个Object(对象)，详见 setData API;

radraw：是否设置（true/false）默认为true；

shift：默认为为false；

animation：是否动画（默认为true）；

代码示例：

//完整参数
chart.series[0].addPoint(Math.random() * 100, true, true,true);
//缺失参数
chart.series[0].addPoint(Math.random() * 100);

2、chart（仅仅获取Series相关的图表属性）

参数：无

返回：Object（对象）

代码示例：

1.chart.series[0].chart;

3、data（仅仅获取某个Series相关的数据对象集合）

参数：无

返回：Object数组

代码示例：

1.chart.series[0].data;

4、hide /show （隐藏或显示某个Series，换句话说，是某条线或者某个柱子）

参数:无

代码示例：

// the button action
$button = $('#button');
$button.click(function() {
var series = chart.series[1];
if (series.visible) {
series.hide();
$button.html('显示红色线');
} else {
series.show();
$button.html('隐藏红色线');
}
});

图片示例：

show()显示

show()效果

hide()效果

5、name （获取某个Series的图例名称）

参数：无

返回：名称字符号串

代码示例：

1.//获取第二个图例的名称

2.var name = chart.series[1].name

6、options（获取某个series的项目对象）

参数：无

返回：对象

代码示例：

//获取某个series的options对象
var options = chart.series[0].options;
 
//获取options内的data数据
var data = options.data;

7、remove（删除某个series对象）

参数：

redraw：移除某个series对象过后，是否需要重新绘制图表，默认为true；如果想移除过后，继续保留图表的坐标值不变化，可以设置为false即可；

代码示例：

if (chart.series.length) {
//移除series[0]过后，不重新绘制图表
chart.series[0].remove(false);
}

图片示例：

remove()前

remove()前效果

remove()后效果

8、select（选择或者取消某个series，这个需要和plotOptions内series的showCheckbox=true属性设置配合使用）

参数：

selected：true/false 默认可以不填写任何参数；不填写的时候，连续点击两次，图表会自动切换选择状态；

代码示例：

①、设置图例有选择框

plotOptions: {
series: {
showCheckbox: true
}
}

②、选中某个series

1.chart.series[0].select(true);

③、取消选中某个series

1.chart.series[0].select(false);

图片示例：

select()选中某个图例

选中某个图例

9、selected（获取某个series的选中状态）

参数：无

返回：true（选中）/false（未选中）

代码示例：

1.chart.series[0].selected;

10、setData（设置某个series的数据）

参数：

data：数据集合（array|array|array）均可

redraw：设置数据后是否重新画图表（true/false)，默认为true，可以不设置此参数

代码示例：

1.chart.series[0].setData([129.2, 144.0, 176.0, 135.6, 148.5, 216.4, 194.1, 95.6, 54.4, 29.9, 71.5, 106.4] );

11、type（获取某条series数据展示图的类型）

参数：无

返回：string字符串（line、area等等）

代码示例：

1.var sType = chart.series[0].type;

12、visible（设置某个series的显隐）

说明：等同于之前描述的show()和hide()；

代码示例：

1.//隐藏series[0]

2.chart.series[0].visible(false);

13、xAxis（获取与某个series相关联的横坐标xAxis的相关属性对象）

参数：无

代码示例：

//获取series[0]的xAxis对象
var xAxis = chart.series[0].xAxis;
 
//获取xAxis的categories
var categories = xAxis.categories;

14、yAxis（获取与某个series相关联的纵坐标yAxis的相关属性对象）

参数：无

代码示例：

//获取series[0]的yAxis对象
var yAxis = chart.series[0].yAxis;
 
//获取yAxis的max
var max= yAxis.max;
 
//其他属性依次类推
来源： <http://blog.csdn.net/jiary5201314/article/details/39548873>
 

来自为知笔记(Wiz)

posted on 2015-12-03 20:22 imsoft 阅读(2292) 评论(0) 编辑收藏举报

刷新页面返回顶部

imsoft.cnblogs

关于Highcharts图表组件动态修改属性的方法（API）总结之Series

导航