arcColorPicker

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) {
        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/11/18