输入类组件
输入类组件包括:输入框、数字输入、数据选择器、日期时间选择器、富文本编辑器、图片选择器、视频选择器、开关等。
统一用法
可输出数据
所有输入类组件添加到页面后,均可暴露输入内容,便于数据展示、修改或与数据库交互。
可配置交互行为
- 值变化时:输入内容变更触发
- 失去焦点时:光标离开输入框触发
- 成功时:如图片/视频上传成功后触发
输入框
常用于信息填写、密码输入、数字输入、搜索等场景。默认类型为文本,可改为数字类型。
💡
当类型为数字时,默认值为 0。可通过页面数据设置默认值。
配置说明
- 提示文字:无内容时显示的提示,不参与数据绑定
- 默认值:初始内容,可绑定数据
默认值配置 | 效果 |
---|---|
![]() | ![]() |
💡
- 同时设置占位符和默认值时,优先显示默认值。
- 默认值仅在页面加载时赋值,后续输入不受影响。
- 禁止输入框默认值绑定自身,避免无限循环。
特殊配置
- 密码:内容加密显示,常用于账号密码登录
- 自动聚焦:页面加载自动弹出键盘
- 多行:内容超出宽度自动换行
密码开启 | 密码关闭 |
---|---|
![]() | ![]() |
💡
多行输入框在“适应内容”布局下最小值不生效。
使用示例
建议:页面有多个输入框时建议重命名,便于数据引用。
- 信息填写:用户输入信息后,行为配置中选择对应输入框数据字段
- 编辑原有数据:默认值配置为当前信息,便于用户参考修改
数字输入
数字输入组件用于让用户通过 + - 按钮或直接输入数字,输出数值型数据,常见于购物数量、设备数量等场景。
配置说明
- 最大值:输入大于最大值时自动显示为最大值
- 最小值:输入小于最小值时自动显示为最小值
- 步长:点击 + 或 - 时的增减幅度,直接输入数字不受步长影响
- 禁用加减:无法点击 +、- 或输入数字,组件仅显示默认值且不可更改
- 输入框禁用:无法直接输入/修改数字,但可通过 +、- 按钮调整
数据选择器
数据选择输入框组件允许用户通过选择数据而非手动输入,实现更规范的数据采集。
配置说明
- 数据源选择:可选自建数据表或内置省市区表,支持设置选项数量、过滤、筛选、排序
- 列表字段:必须指定,明确展示哪个字段内容
- 默认值:可直接输入或绑定远程数据,需与列表字段类型一致
日期时间选择器
允许用户选择日期或时间,输出标准格式。
配置说明
- 开始/结束时间(日期):仅支持数据绑定,非必填
- 时间间隔:默认 1 分钟,可选 5/10/15/30/60 分钟
- 默认值:可数据绑定,非必填
- 提示文字:无默认值时显示
富文本编辑器(仅 Web 端)
允许用户输入富文本内容,输出文本类型数据。
图片选择器
用于上传单张或多张图片,常用于照片、头像等场景。
配置说明
- 最大图片数量:上传图片数量上限,默认 1 张
- 纵列数量:多图时设置每行显示数量
- 图片间距:多图时设置图片间隔
- 占位图片:未上传时的占位样式
- 默认值:上传前显示的内容,可为单张或多张
💡
如需将多张图片批量插入数据库,需开启“批量修改”行为,数据源绑定图片选择器结果,字段设置为“切换”模式。
视频选择器
用于上传视频,配置方式同图片选择器。
配置说明
- 上传成功后可重新选择视频
- 支持数据绑定默认展示视频
开关
用于二选一(是/否)场景,输出布尔值(true/false),支持三种样式。
使用示例
如待办事项完成状态,添加时默认 false,完成后切换为 true。
未完成 | 已完成 |
---|---|
![]() | ![]() |
Last updated on