网页图表Highcharts实践教程之标签组与载入动画

时间:2022-10-17 17:32:58

网页图表Highcharts实践教程之标签组与载入动画

Highcharts标签组

在图表的大部分元素都提供了标签功能。但很多时候,我们需要额外说明一些信息。这个时候借助原有的图表元素的标签功能就不是很方便。Highcharts为用户提供了标签组功能。使用该功能可以在图表区的任意位置添加一个或者多个标签,如图3.9所示。该图表中在副标题前面增加一个标签,用以说明数据列展现的年份。

 网页图表Highcharts实践教程之标签组与载入动画

图3.9  标签组的应用

Highcharts标签组的结构

在Highcharts中,标签组使用labels组件实现。其语法形式如下:

  • labels:{
  • //相关配置项
  • }

由于标签组不隶属于任何图表元素,所以它不作为其他图表元素的子项,而直接包含在图表选项中。

Highcharts构建标签

顾名思义,标签组是由一组标签构成。在使用的时候,用户可以定义一个,也可以定义多个标签。标签组中标签使用items组件构成。其语法如下:

  • items: [{
  • //配置项
  • },
  • {
  • //配置项
  • }
  • .........          //可以是很多项
  • ]

其中,每个标签都由一个花括号括起来;多个标签使用逗号分隔,然后用[]括起来。

构建标签,主要使用配置项html和style来设定标签内容和位置。其语法如下:

  • html:String1
  • style:CSSObject

其中,参数String指定标签内容,该值可以是HTML代码,也可以是纯文本内容。参数CSSObject指定标签的显示位置,包含left和top配置项。其语法如下:

  • left:Number1
  • top:Number2

其中,参数Number1表示标签的水平方向偏移距离,单位为px,默认值为0;参数Number2表示标签的垂直方向偏移距离,单位为px,默认值为0。

注意:必须设置style,包括其中两个配置项left和top中的一个,这样才能显示标签。否则,光有配置项html是无法显示标签的。

【实例3-9:items】下面实现图3.9的标签效果。修改代码如下:

  • labels: {
  • items: [{                                                          //添加标签
  • html: '2013年-2015年',                      //设置标签内容
  • style: {                                                    //设置标签位置
  • left: 10,                                           //设置水平位置
  • top:-25                                           //设置垂直位置
  • }
  • }]
  • }

执行后,效果如图3.9所示。从图中可以看到,标签默认以绘图区的左上角作为原点。配置项x和y都是相对该点计算的。

Highcharts设置标签的样式

在组件items中,可以通过配置项html指定HTML脚本的方式来设定每个标签的文本样式。为了设置方便,Highcharts还为组件labels提供配置项style来设定所有的的标签样式。其语法如下:

  • style:CSSObject

其中,参数CSSObject用来指定所有标签共同的CSS样式。其默认值为{color: '#3E576F'}。

用户可以根据自己的需要添加特定的样式。

Highcharts载入动画

载入动画是一个过渡动画。当图表加载数据需要时间较长,而无法展现图表数据,可以使用加载动画。其效果如图3.10所示。加载动画位于绘图区,会覆盖绘图区原有内容,并中心显示提示内容Loading...。

 网页图表Highcharts实践教程之标签组与载入动画

图3.10  载入动画

Highcharts显示载入动画

输入动画和前面的图表元素不同,它并不会自动显示。它需要使用图表对象来显式调用。这时需要使用方法showloading()。其语法如下:

  • chart.showloading(String str)

其中,chart必须是图表对象;参数str指定组件loading的配置项。该方法返回值为null。

载入动画除了在方法showloading的参数指定,还可以在图表选项中指定。其语法形式如下:

  • loading:{
  • //相关配置项
  • }

【实例3-10:showloading】下面在图表中显示载入动画,修改代码如下:

  • <script type="text/javascript">
  • $(document).ready(function () {
  • var options = {
  • chart: {
  • type: 'line',
  • zoomType: 'x'
  • },
  • title: {
  • text: '北京一周最高温度'
  • },
  • series: [{
  • name: '2015最高温度',
  • data: [6, 6, 7, 4, 5, 6, 8]
  • }
  • ],
  • credits: {
  • text: '大学霸',
  • href: 'http://daxueba.net'
  • }
  • };
  • var chart;                                                                       //定义图表变量
  • $('#container').highcharts(options);                         //创建图表动画
  • chart = $('#container').highcharts();                         //获取图表对象
  • chart.showLoading();                                                //显示载入动画
  • });
  • </script>

执行后,效果如图3.11所示。

 网页图表Highcharts实践教程之标签组与载入动画

图3.11  显示载入动画

载入动画并不会自动消失。如果取消载入动画,需要再使用图表对象的hideloading()方法。其语法如下:

  • chart.hideloading()

其中,chart表示图表对象;该方法没有参数,返回值为null。

Highcharts本地化载入动画

从图3.11中可以看到,载入动画默认的提示内容是Loading...。对于国内使用者,这并不友好。用户可以对提示内容本地化。需要使用到组件lang的配置项loading。其语法如下:

  • loading: String

其中,参数String用来指定载入动画显示的提示内容。默认值为loading...。

【实例3-11:customloading】下面对载入动画的提示内容实现本地化,将其修改为“数据载入中...”。修改代码如下:

  • Highcharts.setOptions({
  • lang: {
  • loading: '数据载入中...'                                                        //设置载入动画的提示内容
  • }
  • });

执行后,效果如图3.12所示。

 网页图表Highcharts实践教程之标签组与载入动画

图3.12  本地化载入动画

注意:对载入动画实施本地化,并不是设置组件loading的配置项,而是组件lang中设置。

Highcharts设置动画效果

为了使载入动画更符合当前图表的需要,用户可以借助Highcharts提供的配置项对动画进行定制。下面依次讲解常用的几种定制方式。

1.设置动画区域的样式

载入动画的区域覆盖了绘图区。这样,显示载入动画的时候,就可以遮挡绘图区的显示,起到提示用户的作用。该区域可以使用组件loading的配置项style进行设置。其语法如下:

  • style: CSSObject

其中,参数CSSObject指定载入动画区域的CSS样式。默认值如下:

  • {
  • position: 'absolute',
  • backgroundColor: 'white',
  • opacity: 0.5,
  • textAlign: 'center'
  • }

2.设置提示内容样式

虽然提示提示内容支持一定的HTML的标签,但更好的方式是使用配置项labelStyle。其语法如下:

  • labelStyle: CSSObject

其中,参数CSSObject指定动画提示内容的CSS样式。默认值如下:

  • {
  • "fontWeight": "bold",
  • "position": "relative",
  • "top": "45%"
  • }

3.设置动画效果

除了设置各种CSS样式外,用户还可以设置动画的淡入、淡出效果的持续时间。这时,需要使用配置项showDuration和hideDuration。其语法如下:

  • showDuration: Number1
  • hideDuration: Number2

其中,参数Number1指定淡入动画持续时间,单位为毫秒ms,默认值为100;参数Number2指定淡出动画持续时间,单位为毫秒ms,默认值为100。

【实例3-12:loading】下面重新设定载入动画的淡入效果持续时间,修改代码如下:

  • loading: {
  • showDuration: 1000,                       //设置淡入效果持续时间
  • hideDuration: 1000                           //设置淡出效果持续时间
  • }

注意:淡入效果只有在显示载入动画时候才有效;反之,淡出效果只在隐藏载入动画时有效。

本文选自:网页图表Highcharts实践教程基础篇大学霸内部资料,转载请注明出处,尊重技术尊重IT人!