arcColorPicker

概述

arcColorPicker 插件封装了一个环形取色器,开发者可自定义样式,设置当前色值,获取拖动指示十六进制色值

图片说明

open

打开环形取值器

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

params

x:

  • 类型:数字
  • 默认值:当前设备屏幕宽除以二
  • 描述:取色器视图的中心点坐标,可为空

y:

  • 类型:数字
  • 默认值:200
  • 描述:取色器视图中心点的坐标,可为空

r:

  • 类型:数字
  • 默认值:128
  • 描述:环形取色器外环半径,可为空

gradients:

  • 类型:数组
  • 默认值:['#000','#fff']
  • 描述:顺时针渐变色值组成的数组,可为空

slider:

  • 类型:字符串
  • 默认值:'#fff'
  • 描述:滑块背景,支持 rgb,rgba,#,img 可为空,为空时滑块背景透明

style:

  • 类型:JSON 对象
  • 默认值:内部字段
  • 描述:环形选值器样式配置,可为空

内部字段:

{
    innerR:			//预览区半径占 R 的百分比,数字类型:`25` 默认,`0-100` 取值范围,可为空
    innerRwidth:	//预览区灰色环宽占 innerR 的百分比,数字类型:`3` 默认,`0-100` 取值范围,可为空
    ringWidth:		//环形取色器环宽占 R 的百分比,数字类型:`25` 默认,`0-100` 取值范围,可为空
    intervalAngle:	//环形取值器下环缺口弧度大小,数字类型:`20` 默认,`0-180` 取值范围, 可为空
}

currentColor:

  • 类型:字符串
  • 默认值:gradients 的第一个元素
  • 描述:环形取色器当前颜色值,仅支持 #,可为空

fixedOn:

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

fixed:

  • 类型:布尔
  • 默认值:true
  • 描述:是否将插件视图固定到窗口上,不跟随窗口上下滚动,可为空

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    touchCancel:      	//是否是滑动结束事件,布尔类型:`true` 表示手指离开事件
    color: 				//色值的十六进制表示,字符串类型
}

示例代码

var arcColorPicker = api.require('arcColorPicker');
arcColorPicker.open({
    fixedOn: api.frameName
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
       api.alert({
            msg: JSON.stringify(err)
        })
    }
});

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getColor

获取取色器当前的值

getColor(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    color:			//色值的十六进制表示,字符串类型
}

示例代码

var arcColorPicker = api.require('arcColorPicker');
arcColorPicker.getColor(function(ret, err) {
    if (ret) {
         api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
         api.alert({
            msg: JSON.stringify(err)
        })
    }
});

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setColor

设置取色器的色值

setColor({params})

params

color:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)要设置的色值

示例代码

var arcColorPicker = api.require('arcColorPicker');
arcColorPicker.setColor({
    color: '#6757dj'
});

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏取色器插件视图

hide(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    status:      //操作是否成功,布尔类型
}

示例代码

var arcColorPicker = api.require('arcColorPicker');
arcColorPicker.hide();

补充说明

隐藏显示的插件视图,并没有从内存清除

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示已隐藏的取色器插件视图

show(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    status:      //操作是否成功,布尔类型
}

示例代码

var arcColorPicker = api.require('arcColorPicker');
arcColorPicker.show();

补充说明

显示已隐藏的插件视图

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭取色器

close(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    status:      //操作是否成功,布尔类型
}

示例代码

var arcColorPicker = api.require('arcColorPicker');
arcColorPicker.close();

补充说明

从内存里清除

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/10/21