CoCo 自定义控件

Appearance

properties ​

控件属性

  • 类型：object[]

可见控件内置属性 ​

参考值功能
'__width'可见控件宽度
'__height'可见控件高度
'__size'可见控件尺寸
'__opacity'可见控件透明度（须自行设置 validators ）
'__disabled'可见控件是否禁用
'__visible'可见控件是否显示
推荐的写法
js
{
    key: "__width", label: "宽度",
    valueType: "number", defaultValue: 100,
    blockOptions: { generateBlock: false, },
},
{
    key: "__height", label: "高度",
    valueType: "number", defaultValue: 100,
    blockOptions: { generateBlock: false, },
},
{
    key: "__size", label: "",
    valueType: "number", defaultValue: 100,
    readonly: true, hidePropertyEditor: true,
    blockOptions: {
        setter: { keys: ["__height", "__width",], },
        getter: { keys: ["__height", "__width",], },
    },
},
{
    key: "__opacity", label: "不透明度", valueType: "number", defaultValue: 100,
    validators: { greaterThan: 0, lessThan: 100, isInteger: true, },
},
{ key: "__disabled", label: "禁用", valueType: "boolean", defaultValue: false, },
{ key: "__visible", label: "显示", valueType: "boolean", defaultValue: true, }

key ​

属性名称，控件内唯一，标识不同属性（遵循JavaScript命名规范）

  • 类型：string
  • 示例：'property1'

label ​

属性积木文本

  • 类型：string
  • 示例：'属性1'

valueType ​

属性类型，影响编辑器内积木嵌套和属性面板编辑

  • 类型：string
参考值功能
'number'数字类型， editorType 默认为 'InputNumber'
'string'字符串类型， editorType 默认为 'TextInput'
'boolean'布尔类型， editorType 默认为 'OptionSwitch'
'color'颜色类型， editorType 默认为 'OptionSwitch'
'image'图片类型，内部返回值为图片文件名

checkType ​

属性数据类型，影响编辑器内积木嵌套

  • 类型：string
参考值功能
'number'数字类型
'string'字符串类型
'boolean'布尔类型
'color'颜色类型

editorType ​

属性编辑器类型，影响属性面板编辑

  • 类型：string
参考值功能
TextInput文本（单行）
TextArea文本（多行）
InputNumber数字
NumberSlider（数字）滑动条
RichTextEditor富文本编辑器
AntSwitch普通开关
OptionSwitch选项开关
Color颜色
FontFamily字体
更多参考值（但可能没什么用）
参考值功能说明
WidgetTitle控件名称
VisibleSwitch显示开关
DisabledSwitch禁用开关
Headline单选/多选框题干
NumberInputRow数字输入
DegreeInputRow角度输入
FlipInputRow水平垂直二合一开关
CoordinateXY坐标输入
ScaleInputRow可锁定比例的宽高输入
WidgetOpacity不透明度
BackgroundColor背景颜色（与颜色相同）
HttpBodyPOST请求文本
HttpHeader请求头格式：[{'key':'114', 'value':'514'}]
HttpParamsGET请求参数
audioVolume音量条
audioRate音速条
AudioChangeSoundFile音源
DictFields云字典数据源
ListNewDataSource数据表数据源（本地+云 二合一）
TableFields云数据表数据源
LocalStorageFields微数据库初始数据
CloudDbList未知，显示数据加载中
ListViewerDataSource（未知）表格数据源
ListViewerStyleTemplate列表数据框样式
WarningFields停止服务警告
BluetoothConnect蓝牙
AqaraAuth绿米
PreviewImage对话框预览效果值为对话框的主题色
BrushDrawProcess（未知）绘画过程开关
BrushPenColor（未知）颜色及光标形状

@SLIGHTNINGの提示

ListViewerDataSource 需要设置 templateSlotMap 属性

这样就不会白屏了

defaultValue ​

属性默认值

  • 类型：any

hidePropertyEditor ​

是否不在属性面板中显示

  • 类型：boolean

readonly ​

属性是否只读（只生成返回值积木并在属性面板中隐藏）

  • 类型：boolean

unit ​

属性 valueType 为 'number'

validators ​

属性值检查器

  • 类型：object

lessThan ​

检查属性 valueType 为 'number' 时是否小于指定值

  • 类型：object

value ​

指定值

  • 类型：number

message ​

不满足条件时的报错信息

  • 类型：string

greaterThan ​

检查属性 valueType 为 'number' 时是否大于指定值

  • 类型：object

value ​

指定值

  • 类型：number

message ​

不满足条件时的报错信息

  • 类型：string

isInteger ​

检查属性 valueType 为 'number' 时是否为整数

  • 类型：object

value ​

是否为整数

  • 类型：boolean

message ​

不满足条件时的报错信息

  • 类型：string

notEmpty ​

检查属性 valueType 为 'string' 时是否不为空

  • 类型：object

value ​

是否不为空

  • 类型：boolean

message ​

不满足条件时的报错信息

  • 类型：string

maxLength ​

检查属性 valueType 为 'string' 时是否小于指定长度

value ​

指定长度

  • 类型：number

message ​

不满足条件时的报错信息

  • 类型：string

minLength ​

检查属性 valueType 为 'string' 时是否大于指定长度

value ​

指定长度

  • 类型：number

message ​

不满足条件时的报错信息

  • 类型：string

属性值下拉列表

  • 类型：object[]

value ​

属性下拉选项值，属性内唯一，标识不同属性值选项

  • 类型：any

label ​

属性值下拉选项文本

  • 类型：string

tooltip ​

积木提示，鼠标悬浮在积木上显示

  • 类型：string

blockOptions ​

积木配置

  • 类型：object

getter ​

属性获取积木的blockOptions

  • 类型：object

keys ​

获取积木的下拉列表（通过一块积木获取多个属性）

  • 类型：string[]
  • 示例：['prop1', 'prop2']

setter ​

属性设置积木的blockOptions

  • 类型：object

keys ​

设置积木的下拉列表（通过一块积木设置多个属性）

  • 类型：string[]
  • 示例：['prop1', 'prop2']

同步文档

以下为通用blockOptions

generateBlock ​

是否在积木盒生成积木

  • 类型：boolean

line ​

积木盒中此积木上方行标签

  • 类型：string

space ​

积木盒中此积木下方间距

  • 类型：number

order ​

积木盒中此积木位置

  • 类型：number

TIP

默认事件积木从10001依次递增1

默认方法积木从20001依次递增1

默认修改属性积木从30001依次递增1

默认读取属性积木从40001依次递增1