thwartwiseBarChart

来自于:开发者立即使用

概述

thwartwiseBarChart 是一个横着的柱状图模块,开发者可自定义该模块的各种样式。 详情参考实例截图:

图片说明

open

打开横排柱状图模块,当数据条数超过当前显示区域时,可上下滑动查看

open({params}, callback(ret))

params

rect:

  • 类型:JSON 对象
  • 描述:(可选项)模块的位置及尺寸
  • 内部字段:
{
    x: 0,   //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
    y: 0,   //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
    w: 320, //(可选项)数字类型;模块的宽度,支持auto;默认:auto
    h: 200  //(可选项)数字类型;模块的高度,支持auto;默认:w * 2.0/3.0
}

data:

  • 类型:数组
  • 描述:横排柱形图关键结点的数据,数据排列方式为从下而上
  • 内部字段:
[{
    count: 4,                    //数字类型;节点数据大小
    color:'#ff0',                //字符串类型;结点对应柱子的颜色,支持rgb、rgba、#
    id: 1,                       //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    title: '',                   //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    ...
},{
    count: 13,                   //字符串类型;节点数据大小
    color:'#EEB422',             //数字类型;结点对应柱子的颜色,支持rgb、rgba、#
    id: 2,                       //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    title: '',                   //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    ...
}]

styles:

  • 类型:
  • 描述:(可选项)模块视图内元素样式设置
  • 默认值:见内部字段
  • 内部字段:
{ 
      xAxis: {              //(可选项)JSON 对象;X轴距离底部区域的样式
          height:30,        //(可选项)数字类型;X轴距离底部的高度,默认:30
          bg: '#4A708B',    //(可选项)字符串类型;X轴距离底部区域的背景,支持 rgb、rgba、#;默认:'#4A708B'
          markColor: '#fff',//(可选项)字符串类型;X轴标注字体颜色,支持 rgb、rgba、#;默认:'#fff'
          markSize: 12        //(可选项)数字类型;X轴标注字体大小;默认:12
          max: 25,            //数字类型;x轴标注最大值;默认:25
          min: 0,             //数字类型;x轴标注最小值;默认:0
          step: 5             //数字类型;x 轴刻度间隔;默认:5
      },   
      coordinate: {         //(可选项)JSON 对象;坐标系样式
          bg: '#4A708B',    //(可选项)字符串类型;坐标系背景,支持 rgb、rgba、#;默认:'#4A708B'
          borderSize: 0.5,  //(可选项)数字类型;坐标线粗细;默认:0.5
          borderColor:'#fff'//(可选项)字符串类型;坐标线颜色;默认:#fff
      },    
      bar: {                //(可选项)JSON 对象;柱子样式配置
          width:20,         //(可选项)数字类型;柱子的宽度,默认:20
          interval: 5       //(可选项)数字类型;柱子间隔大小,默认:5
      }     
}

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)模块是否随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
 id: 1,                 //数字类型;模块的 id,用于区分模块的多个实例
  eventType: 'show',     //字符串类型;交互事件类型
                        //取值范围:
                        //show(打开模块成功)
                        //click(点击柱状图的柱子的点击事件)
  index:                //数字类型;点击柱状图柱子的索引,当 eventType 为 click 时有效
  value:                //数字类型;所点击柱子的值,当 eventType 为 click 时有效
  selectedInfo: {       //JSON 对象,返回所选柱子的数据详情,当 eventType 为 click 时有效
           count: 4,                    //数字类型;节点数据大小
           color:'#ff0',                //字符串类型;结点对应柱子的颜色,支持rgb、rgba、#
           id: 1,                       //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
           title: '',                   //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)                
           ...
  }                    
}

示例代码

var thwartwiseBarChart = api.require('thwartwiseBarChart');
thwartwiseBarChart.open({
    rect: {
        x: 30,
        y: api.frameHeight / 2 - 170,
        w: api.frameWidth - 60,
        h: 340
    },
    data: [{
        count: 4,
        color: ‘#ff0’
    }, {
        count: 13,
        color: ‘#EE9A00’
    }, {
        count: 17.5,
        color: ‘#6495ED’
    }, {
        count: 23',
        color: ‘#43CD80’
    }, {
        count: 7,
        color: ‘#696969’
    }],
    styles: {
         xAxis: {              
          height:30,        
          bg: '#4A708B',   
          markColor: '#fff',
          markSize: 12,      
          max: 25,            
          min: 0,             
          step: 5             
      },   
      coordinate: {         
          bg: '#4A708B',    
          borderSize: 0.5,  
          borderColor:'#fff'
      },    
      bar: {                
          width:20,         
          interval: 5       
      }     
    },
    fixedOn: api.frameName,
    fixed: false
}, function(ret) {
    if (ret) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

reloadData

重新加载数据,当数据条数超过当前显示区域时,可上下滑动查看

reloadData({params}, callback(ret, err))

params

id:

  • 类型:数字
  • 描述: 要刷新数据的模块的 id

data:

  • 类型:数组
  • 描述:横排柱形图关键结点的数据,数据排列方式为从下而上
  • 内部字段:
[{
    count: 4,                    //数字类型;节点数据大小
    color:'#ff0',                //字符串类型;结点对应柱子的颜色,支持rgb、rgba、#
    id: 1,                       //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    title: '',                   //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    ...
},{
    count: 13,                   //字符串类型;节点数据大小
    color:'#EEB422',             //数字类型;结点对应柱子的颜色,支持rgb、rgba、#
    id: 2,                       //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    title: '',                   //开发者可自定义扩展参数 ,可在回调函数内获取(selectedInfo)
    ...
}]

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:

    {
         status: true,        //布尔类型;数据源是否刷新成功, true|false
         count: 20            //数字类型;刷新数据后总数据量数 
    }
    

示例代码

var thwartwiseBarChart = api.require('thwartwiseBarChart');
thwartwiseBarChart.reloadData({
    id: 1,
    data: [{
        count: 4,
        color: ‘#ff0’
    }, {
        count: 19,
        color: ‘#EE9A00’
    }, {
        count: 27.5,
        color: ‘#6495ED’
    }, {
        count: 3',
        color: ‘#43CD80’
    }, {
        count: 17,
        color: ‘#696969’
    }]
}, function(ret) {
    if (ret) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭柱状图,并从内存里清除

close({params})

params

id:

  • 类型:数字
  • 描述:要关闭的模块的 id

示例代码

var thwartwiseBarChart = api.require('thwartwiseBarChart');
thwartwiseBarChart.close({
    id: 1
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏柱状图视图,并没有从内存里清除,可调用 show 接口显示

hide({params})

params

id:

  • 类型:数字
  • 描述:要隐藏的模块的 id

示例代码

var thwartwiseBarChart = api.require('thwartwiseBarChart');
thwartwiseBarChart.hide({
    id: 1
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示已隐藏的柱状图视图

show({params})

params

id:

  • 类型:数字
  • 描述:要显示的模块的 id

示例代码

var thwartwiseBarChart = api.require('thwartwiseBarChart');
thwartwiseBarChart.show({
    id: 1
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本