Skip to Content
搭建UI系统组件 - 输入类

输入类组件

输入类组件包括:输入框、数字输入、数据选择器、日期时间选择器、富文本编辑器、图片选择器、视频选择器、开关等。

统一用法

可输出数据

所有输入类组件添加到页面后,均可暴露输入内容,便于数据展示、修改或与数据库交互。

输入组件数据绑定示意

可配置交互行为

  • 值变化时:输入内容变更触发
  • 失去焦点时:光标离开输入框触发
  • 成功时:如图片/视频上传成功后触发

输入框

常用于信息填写、密码输入、数字输入、搜索等场景。默认类型为文本,可改为数字类型。

💡

当类型为数字时,默认值为 0。可通过页面数据设置默认值。

配置说明

  • 提示文字:无内容时显示的提示,不参与数据绑定
  • 默认值:初始内容,可绑定数据
默认值配置效果
输入框默认值配置输入框默认值效果
💡
  1. 同时设置占位符和默认值时,优先显示默认值。
  2. 默认值仅在页面加载时赋值,后续输入不受影响。
  3. 禁止输入框默认值绑定自身,避免无限循环。

特殊配置

  • 密码:内容加密显示,常用于账号密码登录
  • 自动聚焦:页面加载自动弹出键盘
  • 多行:内容超出宽度自动换行
密码开启密码关闭
密码输入框加密密码输入框明文
💡

多行输入框在“适应内容”布局下最小值不生效。

使用示例

建议:页面有多个输入框时建议重命名,便于数据引用。

  • 信息填写:用户输入信息后,行为配置中选择对应输入框数据字段

信息填写输入框示例

  • 编辑原有数据:默认值配置为当前信息,便于用户参考修改

编辑数据输入框示例

数字输入

数字输入组件用于让用户通过 + - 按钮或直接输入数字,输出数值型数据,常见于购物数量、设备数量等场景。

配置说明

  1. 最大值:输入大于最大值时自动显示为最大值
  2. 最小值:输入小于最小值时自动显示为最小值
  3. 步长:点击 + 或 - 时的增减幅度,直接输入数字不受步长影响
  4. 禁用加减:无法点击 +、- 或输入数字,组件仅显示默认值且不可更改
  5. 输入框禁用:无法直接输入/修改数字,但可通过 +、- 按钮调整

数据选择器

数据选择输入框组件允许用户通过选择数据而非手动输入,实现更规范的数据采集。

配置说明

  • 数据源选择:可选自建数据表或内置省市区表,支持设置选项数量、过滤、筛选、排序
  • 列表字段:必须指定,明确展示哪个字段内容
  • 默认值:可直接输入或绑定远程数据,需与列表字段类型一致

日期时间选择器

允许用户选择日期或时间,输出标准格式。

配置说明

  1. 开始/结束时间(日期):仅支持数据绑定,非必填
  2. 时间间隔:默认 1 分钟,可选 5/10/15/30/60 分钟
  3. 默认值:可数据绑定,非必填
  4. 提示文字:无默认值时显示

富文本编辑器(仅 Web 端)

允许用户输入富文本内容,输出文本类型数据。

富文本编辑器演示

图片选择器

用于上传单张或多张图片,常用于照片、头像等场景。

图片选择器多张示例

配置说明

  1. 最大图片数量:上传图片数量上限,默认 1 张
  2. 纵列数量:多图时设置每行显示数量
  3. 图片间距:多图时设置图片间隔
  4. 占位图片:未上传时的占位样式
  5. 默认值:上传前显示的内容,可为单张或多张
💡

如需将多张图片批量插入数据库,需开启“批量修改”行为,数据源绑定图片选择器结果,字段设置为“切换”模式。

视频选择器

用于上传视频,配置方式同图片选择器。

配置说明

  1. 上传成功后可重新选择视频
  2. 支持数据绑定默认展示视频

开关

用于二选一(是/否)场景,输出布尔值(true/false),支持三种样式。

使用示例

如待办事项完成状态,添加时默认 false,完成后切换为 true。

未完成已完成
开关未完成示例开关已完成示例
Last updated on