输入类组件

输入类组件主要用于收集、接收用户的输入数据。这些组件捕获的输入数据可输出给页面中的其他组件、变量或作为数据库操作的写入源。本篇手册按组件结构化列出：定义（含基础使用场景）、个性化配置、数据源配置、行为触发器及特殊限制说明（各组件按需呈现相应章节）。

本篇只列出各组件的专属配置、数据源配置和行为配置。位置、尺寸、布局、样式、文本等通用设计字段见设计面板参考。

包含组件与核心属性

与主要用于呈现数据的展示类组件不同，输入类组件的核心价值在于向外提供输出值。用户在界面上的每一次输入、选择或切换，都会被组件实时捕获为只读输出，供页面中其他地方进行绑定和使用，其含义与数据类型见下表。

组件名称	支持的客户端	数据源配置	行为配置	输出内容与类型
输入框	网页端、微信小程序、移动端 App	—	✓	`文本 / 长整数 / 无限精度小数` \| 当前输入内容
数字输入	网页端、微信小程序、移动端 App	—	✓	`长整数` \| 当前输入数值
数据选择器	网页端、微信小程序、移动端 App	✓	✓	`对象` \| 选中的数据项
日期时间选择器	网页端、微信小程序、移动端 App	—	✓	`日期 / 时间（带时区）` \| 选择的日期或时间
富文本编辑器	网页端	—	✓	`文本 (HTML)` \| HTML 富文本
图片选择器	网页端、微信小程序、移动端 App	—	✓	`图片 / 图片数组` \| 图片或多图数组。可单独输出图片的`id`、`url`两个文本值
视频选择器	网页端、微信小程序、移动端 App	—	✓	`视频` \| 视频对象。可单独输出视频的`id`、`url`两个文本值
自定义选择器	网页端、微信小程序、移动端 App	✓	✓	`对象 / 对象数组` \| 子容器选中项或选中项数组
开关	网页端、微信小程序、移动端 App	—	✓	`布尔值` \| 开/关状态

输入框

组件定义

用于接收用户单行或多行文本、长整数、无限精度小数的输入。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
占位提示	`文本`	空	全平台	输入框无内容时显示的提示文字。支持动态绑定。与「默认值」同时设置时，优先显示「默认值」。
输入值类型	`枚举`	`文本` / `长整数` / `无限精度小数`	全平台	限制用户输入的数值格式。切换类型时，会重置默认值。
默认值	`文本 / 长整数 / 无限精度小数`	空	全平台	初始化时默认显示的内容，支持动态数据绑定，禁止绑定自身的值。
密码	`布尔值`	`false`	全平台	开启后输入内容以掩码（密文）形式呈现。
自动聚焦	`布尔值`	`false`	全平台	页面加载完成后是否自动聚焦并唤起键盘。
多行	`布尔值`	`false`	全平台	开启后支持输入多行文本。如组件宽度为「自适应内容」，则最小高度限制将不生效。
光标与键盘间距	`长整数`	默认空（单位像素）	仅微信小程序	控制唤起系统软键盘后，输入光标与键盘顶部的垂直间距。
变更防抖延时	`长整数`	0（单位毫秒）	全平台	输入内容变化后，触发值变化事件的延迟时间，可用于合并高频打字事件，提升页面运行性能。

行为配置

支持的触发器包括：值变化时、失去焦点时。详细触发规则请参考：触发器参考。

数字输入框

组件定义

用于接收数字输入。提供 “+ / -” 点击按钮进行增减调整。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
最大值	`长整数`	无限	全平台	允许输入的数值上限。输入或加算超过此值时，数值会自动纠正为该上限值。支持数据绑定。
最小值	`长整数`	无限	全平台	允许输入的数值下限。输入或减算低于此值时，数值会自动纠正为该下限值。支持数据绑定。
步长	`长整数`	1	全平台	点击 “+ / -” 按钮时数值增加或减少的步进单位。注意：手动输入数值不受步长限制。
默认值	`长整数`	0	全平台	初始化时加载的默认数值，支持动态数据绑定。
禁用加减	`布尔值`	`false`	全平台	禁用按钮微调。加减按钮置灰不可点击，输入框仅可手动输入数值。
禁用输入	`布尔值`	`false`	全平台	禁用键盘手动打字输入，仅保留 “+ / -” 按钮进行数值增减。

行为配置

支持的触发器包括：值变化时。详细触发规则请参考：触发器参考。

数据选择器

组件定义

提供下拉列表，接收与配置数据源选项类型相同的结构化数据，实现更规范的数据采集。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
占位提示	`文本`	空	全平台	还没有选中选项时显示的提示占位文字。支持数据绑定。支持配置文字样式。
允许清除	`布尔值`	`false`	全平台	开启后，输入框右侧会出现清除图标（X），点击可一键清空选中项。

数据源配置

注：数据选择器包含独立的「数据」标签页，用于选项集合的数据来源配置。

属性名称	预期数据类型	默认值 / 可选项	说明
数据源	`数组`	默认空	配置下拉选项的数据来源（支持自建数据库表查询、API 数据或动态绑定变量）。支持进行数据筛选（过滤、排序、去重）。
显示字段	`文本`	默认空	指定选项数据源中，渲染展示在下拉框列表中的字段（如选项的“名称”）。
默认值	与显示字段同类型	默认空	初始默认选中项，其类型需与选项的“显示字段”一致。

数据源选择数据表时，可在下方配置筛选、排序、去重等数据筛选条件。

行为配置

支持的触发器包括：值变化时。详细触发规则请参考：触发器参考。

日期时间选择器

组件定义

提供标准的日历面板或滚动滑轮，用于快速选择精确日期或具体时间的组件。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
模式	`枚举`	`日期` / `时间`	全平台	控制选择器展现的是日期日历面板还是时间点选择滚轮。
开始时间	`日期 / 时间（带时区）`	无限	全平台	限制用户可选的最小时间范围，低于该时间将置灰无法选择。支持数据绑定。
结束时间	`日期 / 时间（带时区）`	无限	全平台	限制用户可选的最大时间范围，超出该时间将置灰无法选择。支持数据绑定。
时间间隔	`长整数`	1 / 5 / 10 / 15 / 30 / 60 (分钟)	仅网页端，时间模式下	控制选择器分钟列表的最小递减和递增间隔。
占位提示	`文本`	空	全平台	日期和时间为空时的默认占位提示。
默认值	`日期 / 时间（带时区）`	默认空	全平台	初始化时默认加载显示的日期/时间点，支持动态数据绑定。

行为配置

支持的触发器包括：值变化时。详细触发规则请参考：触发器参考。

富文本编辑器

组件定义

网页端专用的富格式图文排版编辑器，支持文本排版、多媒体插入等富文本内容的编辑。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
内容	`文本 (HTML)`	空	仅网页端	编辑器的初始内容。支持在内容内拼接数据绑定。

行为配置

支持的触发器包括：值变化时。详细触发规则请参考：触发器参考。

图片选择器

组件定义

提供系统相册、拍照或本地文件上传接口，用以收集和上传单张或多张图片的资源上传组件。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
数量上限	`长整数`	1 至 99	全平台	限制用户允许上传的最大图片张数。大于 1 为多图模式，将重置默认值为列表数组。
列数	`长整数`	默认空	数量上限 > 1	多张图片平铺展示时，每行显示的照片列数。
行间距	`长整数`	默认空（单位像素）	数量上限 > 1	多图展示时，图片卡片之间的垂直间距。
列间距	`长整数`	默认空（单位像素）	列数 > 1	多图展示时，图片卡片之间的水平间距。
占位图	`文本 (图片链接)`	默认空	全平台	未上传前图片上传格中显示的提示背景图，支持动态绑定。
默认图片	`图片 / 图片数组`	默认空	全平台	初始加载的已有图片。单图模式下为图片对象，多图模式下为图片数组。
单图大小限制	`长整数`	默认空	全平台	限制单张允许上传的最大图片文件大小（单位 MB）。超过限制会拦截并抛出提示。
启用预览	`布尔值`	`true`	全平台	上传后是否允许点击缩略图直接全屏预览。
显示加载动画	`布尔值`	`true`	全平台	上传过程中是否在卡片中央显示加载动画。
上传模式	`枚举`	`默认` / `仅原图` / `仅压缩`	仅微信小程序	传入微信 `chooseMedia` 的 `sizeType` 参数，控制选取图片时是否压缩。`默认` 时不指定，由微信自行处理。

行为配置

支持的触发器包括：成功时。详细触发规则请参考：触发器参考。

💡

高级使用技巧：批量添加图片到数据库 若需将用户选择的多张图片批量添加到数据库中，在「添加数据」行为配置中需开启「批量添加」，将其数据源绑定为图片选择器的输出结果。

视频选择器

组件定义

用于从相册或本地选择并上传视频文件。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
默认值	`视频`	默认空	全平台	初始化时默认呈现的已有视频文件。
限制上传大小	`长整数（单位 MB）`	默认空	全平台	限制单次允许上传的视频文件大小上限。超过限制将拦截。
禁用预览	`布尔值`	`false`	全平台	开启后，用户在选择视频后无法在卡片上直接点击进行预览播放。
显示加载动画	`布尔值`	`true`	全平台	在大视频上传至服务端期间，是否展示上传进度或加载动画。
上传模式	`枚举`	`默认` / `仅原图` / `仅压缩`	仅微信小程序	传入微信 `chooseMedia` 的 `sizeType` 参数，控制选取视频时是否压缩。`默认` 时不指定，由微信自行处理。

行为配置

支持的触发器包括：成功时。详细触发规则请参考：触发器参考。

自定义选择器

组件定义

自定义选项输入组件，内含「选中」「未选中」两个子画布，支持横向或纵向排列、单选或多选。常用于自定义表单、答题页、选项卡等场景。

个性化配置

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
选项自动换行	`布尔值`	`false`	全平台	横向展示选项卡片时，超出容器宽度后是否自动换行。
支持多选	`布尔值`	`false`	全平台	是否允许同时选中多个选项。切换此开关会重置默认值。
允许取消选中	`布尔值`	`false`	全平台	开启后，点击当前已处于选中高亮状态的项会反选复位到未选中。
不选即全选	`布尔值`	`false`	仅多选模式下	开启后，未选中任何选项时，输出值为全部选项。
刷新时保留选中项	`布尔值`	`false`	全平台	列表或数据源刷新时，是否保持用户之前的选中状态，而不是将状态重置。
保留子组件状态	`布尔值`	`false`	全平台	选项切换隐藏后，是否在内存中保持其画布内表单子组件输入的值。

数据源配置

注：自定义选择器包含独立的「数据」标签页，用于选项列表的数据源声明。

属性名称	预期数据类型	默认值 / 可选项	说明
数据源	`数组`	默认空	选择一个数组类型的数据源，可为数据表查询/订阅、自定义 API，或绑定页面/上级上下文中的数组变量。
默认值匹配字段	`文本`	默认空	指定默认值匹配的字段。
默认值	与默认值匹配字段同类型 / `数组`	默认空	初始默认选中项，其类型需与「默认值匹配字段」保持一致；多选时为数组。

数据源选择数据表时，可在下方配置筛选、排序、去重等数据筛选条件。

行为配置

支持的触发器包括：值变化时。详细触发规则请参考：触发器参考。

子组件

每一个自定义选择器都会自动生成两个独立的子组件：「选中」状态容器和「未选中」状态容器，用于呈现选中与未选中状态的样式。你只需在对应的子组件中设计外观和放置组件，系统会根据数据行数自动循环生成。

「选中」状态：当该选项在运行时被用户选中（单选或多选触发）时呈现的样式。建议在此画布内配置激活态视觉，如高亮背景、颜色加深、文字加粗或添加对勾图标。
「未选中」状态：选项默认常态下呈现的样式。建议配置普通非激活态视觉（如灰色边框、常规文本）以形成明显对比。

子组件数据绑定

无论是选中还是未选中状态，放入其中的子组件（如文本、图片等）在需要呈现选项信息时，可通过数据绑定引用当前选项的值。

绑定方式：在数据绑定中选择 上下文 -> 当前项 -> 自定义选择器 下的具体字段（如 当前项.名称、当前项.价格），即可将当前选项的数据填入子组件。

子组件行为绑定

每一个子组件都可以配置自己的点击时行为。

开关组件

组件定义

用于快速切换是/否（布尔值）二选一状态的输入组件。

个性化配置项

属性名称	预期数据类型	默认值 / 可选项	适用平台与条件	说明
样式	`枚举`	`开关` / `勾选` / `圆形勾选`	全平台	控制开关组件的外观展示形态。
默认值	`布尔值`	`false`	全平台	指定开关初始为打开（True）或关闭（False）状态。
缩放	`无限精度小数`	0 至 2 之间	仅在样式为「开关」时可见	组件的整体缩放比例。
尺寸	`长整数`	0 至 50 之间	仅在样式为勾选类时可见	勾选框的边长（像素）。
选中颜色	`文本 (颜色值)`	主题色	全平台	开关激活处于 True 打开状态下的主题填充颜色值。

行为配置

支持的触发器包括：值变化时。详细触发规则请参考：触发器参考。