arcColorPicker

来自于：开发者立即使用

Method

open getColor setColor hide show close

概述

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) {
        alert(JSON.stringify(ret));
    } else {
        alert(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) {
        alert(JSON.stringify(ret));
    } else {
        alert(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及更高版本