工作卡控件库使用说明
更新时间:2024-04-18
快速入门流程
使用准备
用户可以在多API插件编排中拖入工作卡节点,在右侧抽屉中点击【创建工作卡】,前往配置工作卡。我们为用户初始化了一个简单的卡片模板,用户可以基于模板结合自己的需求进行卡片内容的构建 工作搭建平台初始化界面如下:

控件库说明
搭建工作卡的基本元素就是控件,控件目前分为两种:基本容器和基本控件。
- 基本容器:基础控件的布局载体,基础控件需要放在基本容器内进行编排。我们已经在初始化模板中为用户初始化好了几个弹性盒,用户可以直接拖拽控件进行使用
- 基本控件:搭建卡片的元素,包括文本,输入框,选择框,按钮等功能元素。我们在初始化模板中为用户初始化了一个输入框和一个按钮,并为按钮绑定了相应的事件变量

弹性盒
显隐设置:控制整个弹性盒或者单个控件元素在卡片上显示还是隐藏。如果用户想动态的改变某个布局的显隐状态,可以指定为从服务端获取的模式,然后为其配置动态变量。并在流执行的时候为动态变量赋值来完成显隐状态的变化,
- 值为1时布局显示
- 值为0时布局隐藏

容器方向:控制弹性盒内元素的布局方向

背景色:弹性盒填充颜色,支持16进制颜色编码

文字
主题色:控制文字颜色,目前固定内容支持以下几种配色,可以由服务端下发,支持十六进制颜色编码

可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | string | 否 | 客户端/web | id="unit_senior_select_1691742838005742" |
| font | 字体大小 | string | 否 | 客户端/web | font="13" |
| color | 字体颜色 | string | 否 | 客户端/web | color="#5c6473" |
| bold | 字体粗细 | string | 否 | 客户端/web | bold="1" |
| lines | 文字上线多少行 0为无限 | string | 否 | 客户端/web | lines="1" |
| align | 文字对齐方式 | string | 否 | 客户端/web | align="center" |
| text | 文本内容 | string | 是 | 客户端/web | text="${subtitle.content}" |
| richtext | 富文本 | string | 否 | 客户端/web | richtext="${subtitle.content}" |
| click | 点击事件 | string | 否 | 客户端/web | click="btn" |
| theme | 主题 | string | 否 | 客户端/web | theme="blue" |
| auto_fold | 超出最大行数是否自动折叠 | string | 否 | 客户端/web | auto_fold="1" |
| fold_text | 折叠展开文案 | string | 否 | 客户端/web | fold_text="全文,收起" |
图片
可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | string | 否 | 客户端/web | id="unit_senior_select_1691742838005742" |
| width_percent | 百分百宽度 | string | 否 | 客户端/web | width_percent="100" |
| width | 宽度 | string | 否 | 客户端/web | width="100" |
| height | 高度 | string | 否 | 客户端/web | height="100" |
| src | 图片网络来源 | string | 否 | 客户端/web | src="https://bj.bcebos.com/dev-platform/app/data/public/97ee9355b9ae4d11a3d5adf5c94fb11c" |
| auth | 图片网络请求认证信息 | string | 否 | 客户端/web | |
| local | 图片本地资源名 | string | 否 | 客户端/web | |
| mode | 图片填充方式 | string | 否 | 客户端 | aspect_fill aspect_fit aspect_fillw_top aspect_fillh_end aspect_clip_top_end aspect_noratio_fillh_end |
| tint_color | 图片做为模板刷色 | string | 否 | 客户端/web | |
| theme | 主题 | string | 否 | 客户端/web | theme="blue" |
| corner_radius | 图片圆角 | string | 否 | 客户端/web | corner_radius="4,4,4,4" |
| click | 事件id | string | 否 | 客户端/web | |
| tips | hover时展示的tips,不传或传空则无hover | string | 否 | 客户端/web |
按钮
可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | string | 否 | 客户端/web | id="unit_senior_select_1691742838005742" |
| width_percent | 百分百宽度 | string | 否 | 客户端/web | width_percent="100" |
| width | 宽度 | string | 否 | 客户端/web | width="100" |
| height | 高度 | string | 否 | 客户端/web | height="100" |
| font | 字体大小 | string | 否 | 客户端/web | font="13" |
| state | 按钮状态 | 否 | 客户端/web | state="normal" | |
| color | 标题颜色 | 颜色规范值 | 否 | 客户端/web | color="#C2D6FF" |
| border_width | 固定为1像素,不支持指定 | ||||
| border_corner | 边框圆角 | 正整数 | 否 | 客户端/web | border_corner="16" |
| border_color | 边框颜色 | 颜色规范值 | 否 | 客户端/web | |
| background_color | 背景色 | 颜色规范字 | 否 | 客户端/web | |
| theme | 主题 | 主题名称 | 否 | 客户端/web | theme |
| show_tip | tips显示开关 | 用于控制是否显示tips | 客户端 | show_tip="1" |
输入框

输入框可以帮助用户将输入自己想输入的文本,并结合数据上传进行数据提交。
可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | string | 否 | web | id="time_selector_id" |
| width_percent | 百分百宽度 | string | 否 | web | width_percent="100" |
| width | 宽度 | string | 否 | web | width="100" |
| height | 高度 | string | 否 | web | height="100" |
| text | 输入框默认值 | string | 否 | web | text="${title.content}" |
| font | 字体大小 | string | 否 | web | font="13" |
| placeholder | 输入框placeholder | string | 否 | web | placeholder="请输入" |
| state | 输入框状态 | string | 否 | web | state="normal" |
| limit | 文字上限 | string | 否 | web | limit="500" |
| max_display_lines | 文字多行展示 | string | 否 | web | max_display_lines="4" |
选择框
选择框可以给用户提供可选条目,并结合数据上传事件进行数据提交。选择框支持单选、多选模式。通过配置选项的动态变量来提供下来选择条目。
例如:选项创建了option的动态变量,类型为字符串数组。

在调试时指定对应的字符串数组的参数,将参数中的item0和动态变量的item0绑定即可。

进行调试,效果如下

可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | string | 否 | web | id="unit_senior_select_1691742838005742" |
| width_percent | 百分百宽度 | string | 否 | web | width_percent="100" |
| width | 宽度 | string | 否 | web | width="100" |
| height | 高度 | string | 否 | web | height="100" |
| font | 字体大小 | string | 否 | web | font="13" |
| placeholder | 空态提示语 | string | 否 | web | placeholder="请输入" |
| state | 下拉框状态 | string | 否 | web | state="normal" |
| multi_limit_count | 多选上限/仅多选 | string | 否 | web | multi_limit_count="4" |
| mode | 0/1 配置单选/多选 多选场景目前桌面端支持,移动端还不支持 |
string | 是 | web | mode="0" |
| no_data_toast | 无选项提示语 | string | 否 | 客户端 | no_data_toast="选项为空" |
| searchMode | 下拉框是否可搜索 | string | 是 | web | searchMode="0"("0": 不搜索,“1”本地搜索,“2”远程搜索) |
| isDefaultRequest | 远程搜索是否配置默认请求 | string | 是 | web | isDefaultRequest="0" |
| type | 搜索类型 | string | 否 | web | type="city" |
| expand | 自定义参数 | array | 否 | web | expand=[realSpaceId: ""] |
时间选择器

时间选择器支持用户从动态变量中获取默认时间值,并支持客户通过日历选择的方式调整时间输入参数。
可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | String | 否 | web | id="time_selector_id" |
| placeholder | 无内容时默认提示内容,灰色文案 | String | 否 | web | placeholder="请输入时间" |
| sel_type | 选择器类型 | String | 否 | web | sel_type="1" |
| timestamp | 当前时间戳(秒级) | String | 否 | web | timestamp="1692539044" |
| state | 组件状态 | String | 否 | web | state="disabled" |
| is_select_before | 用于开始时间和结束时间的联动效果 | String | 否 | web | isSelectBefore="true" |
| selected_timestamp | 可选择的时间范围边界,时间戳(秒级) | String | 否 | web | selectedTimestamp="1692539044" |
| icon | 最右侧icon图片链接,支持http链接 | String | 否 | web | icon="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAA…pgFqWj0bBaAiMhsCgCAEA53WhIfW9B60AAAAASUVORK5CYII=" |
| select | 选择时间后的回调事件,绑定对应的事件名称即可 | String | 否 | web | select="botCard_time_select" |
单复选

用户可以定义自己的单复选元素,可以指定模式为单选/复选。与选择框一样,用户需要为该控件提供选项的动态变量
可配置参数说明:
| 属性 | 含义 | 类型 | 是否必填 | 适用场景 | Mock |
|---|---|---|---|---|---|
| id | 控件id | string | 否 | web | id="unit_senior_select_1691742838005742" |
| width_percent | 百分百宽度 | string | 否 | web | width_percent="100" |
| width | 宽度 | string | 否 | web | width="100" |
| height | 高度 | string | 否 | web | height="100" |
| direction | 布局方式 | string | 否 | web | direction="column" |
| mode | 单复选模式 | string | 否 | web | mode="0" |
| options | 选项 | string | 否 | web | options="${asdsa.contents}" |
| limit | 多选上限/仅多选 | string | 否 | web | limit="4" |
| select | 选择事件 | string | 否 | web | select="asdsad" |
| optionsConfig | 选项控制参数 | string | 否 | web | {"type": "array", "array0": { "type": "array", "enable": { "type": "text", "content": "0" }, "selected": { "type": "text", "content": "0" } }, "array1": { "type": "array", "enable": { "type": "text", "content": "1" }, "selected": { "type": "text", "content": "1" } }} |
