Skip to content

属性配置 ​

属性配置控制当前选中组件自身的行为与交互细节:占位文案、选项来源、能否清除、是否禁用/只读等。不同组件显示的项不同,但入口一致——在右侧 组件配置 里找到 属性配置,按业务需要逐项改。

在哪里找 ​

工作区选中组件 → 右侧 组件配置 → 向下滚动到 属性配置(常在基础配置、高级配置下方)。

属性配置标题同行还有两个入口:数据绑定(把属性接到变量)和 自定义属性配置(用 JSON 补写组件 props)。数据绑定细节见数据绑定;也可结合全局变量。下方「配置表单项」管的是标签位置/宽度等表单项外壳,与自定义属性配置不是同一面板。

和基础、验证、高级的分工 ​

分区管什么
基础配置名称、字段 ID、宽度、是否提交
属性配置(本文)组件行为:占位、选项、清除、禁用、行数等
验证配置填得对不对
高级配置随填写自动显隐、赋值、公式

怎么用(分步) ​

下面以输入框「姓名」为例认识常见属性项(选择器等组件项会略有不同,以面板为准)。

  1. 选中字段后,滚到 属性配置。输入类常见项包括 输入框占位文本、是否显示清除按钮、是否禁用 / 是否只读 等。

属性配置分区

  1. 设置 输入框占位文本(空态时框内的灰色提示)。

输入框占位文本

  1. 按需打开 是否显示清除按钮,方便一键清空。

是否显示清除按钮

  1. 详情只看不改时,可开 是否只读;需要灰掉不可点时用 是否禁用。流程中「通过后才锁定」更适合禁用条件。

是否禁用与是否只读

  1. 需要限制输入形态时看 类型、最大输入长度(严格格式仍靠验证配置)。

类型与最大输入长度

  1. 属性配置标题右侧有两个入口:数据绑定(变量图标)和 自定义属性配置(铅笔编辑图标)。

数据绑定与自定义属性配置入口

  1. 属性要跟变量走时点 数据绑定;面板里没有的 props 要用 JSON 补时点 自定义属性配置(见下文两节)。

数据绑定入口示意

推荐顺序

选对组件类型 → 基础配置 名称/ID → 属性(占位、选项、清除、禁用等)→ 需要时再开数据绑定 / 自定义属性配置 → 验证 → 高级 → 预览。

数据绑定面板 ​

用来把当前组件的某个属性接到变量(或计算)。界面标题为 数据绑定;更细说明见数据绑定。

怎么打开:选中组件 → 属性配置 → 点标题旁的 数据绑定。

  1. 弹窗左侧是 属性列表(选要绑定的属性)和 自定义键名规则;右侧是 变量列表(点选插入)。

数据绑定弹窗左右区

  1. 绑到组件自身 props 时,键名按提示写成 props.<属性名>,例如 props.placeholder、props.disabled。需要多行绑定时点 添加。

添加绑定行

和高级配置的区别

数据绑定改的是「这个属性的值从哪来」;业务上随填写自动显隐、赋值、公式,仍用高级配置。

自定义属性配置 ​

面板标题为 自定义属性配置(有时口语叫「自定义配置项」)。用 JSON 直接补写或覆盖组件的 props,适合面板上没有单独表单项、但组件本身支持的属性。

怎么打开:选中组件 → 属性配置 → 点标题旁的铅笔(编辑)图标。

  1. 在弹窗里按 JSON 对象填写,键为属性名、值为对应配置;写完点 确定。

自定义属性配置弹窗

什么时候用面板项,什么时候用自定义

能在属性配置里直接改的(占位、清除、禁用等)优先用面板开关/输入框,所见即所得。只有面板没有、或要一次补多个冷门 props 时,再用自定义属性配置。

别和「配置表单项」搞混:基础配置区可展开的 配置表单项 管标签位置、标签宽度等「表单项外壳」,不是 JSON 自定义 props。

配置表单项(基础配置)

本手册已展开的属性专题 ​

专题说明
数据绑定把属性接到变量 / 计算
自定义输入框占位文本输入框内灰色提示
选项数据静态 / 远程 / 全局数据源
输入行数及高度自适应多行文本高度
输入内容类型限制限制可输入内容形态
清除按钮展示隐藏一键清空
禁用及只读不可编辑状态

其它属性(上传限制、日期格式等)以当前组件面板为准,改完务必预览。

场景示例 ​

入门:给输入框加占位并开清除 ​

背景:访客登记的「姓名」要提示怎么填,并允许一键清空重填。

步骤:

  1. 选中「姓名」,在属性配置里把 输入框占位文本 写成「请输入访客姓名」。

设置占位文案

  1. 打开 是否显示清除按钮。

打开清除按钮

  1. 预览:空态应看到占位;输入后可点清除图标清空。

预览空态占位

预期:占位不是默认值;需要预填内容请配默认值或数据联动。更细说明见占位文本、清除按钮。

常用:详情页字段只读 ​

背景:审批详情里姓名只展示、不能改。

步骤:

  1. 选中字段,打开 是否只读。

打开是否只读

预期:仍可看见内容,但不能编辑。若「审批通过后才锁定」,改用禁用条件。详见禁用及只读。

常用:下拉的选项数据 ​

背景:费用报销里「商品」选项要可维护;多个表共用同一套类型时,可接到全局数据源。

步骤:

  1. 选中选择器(如「商品」),在属性配置中找到 选项数据。

选择器的选项数据

  1. 按需打开 是否可搜索、是否可以清空选项 等(文案以面板为准)。

可搜索与可清空

预期:静态选项可直接添加;远程或全局数据源见选项数据。改选项的值前确认是否影响历史已填数据。

常用:属性从变量读取 ​

背景:占位文案要随语言或全局变量变化,而不是写死在面板里。

步骤:

  1. 选中字段,打开 数据绑定,在左侧选属性(或按 props.placeholder 规则填键名),右侧从变量列表点选(如 $t / $var)。

场景:打开数据绑定并点选变量

预期:变量变化后,该属性同步更新。完整写法与计算模式见数据绑定。

常用:用 JSON 补一个面板没有的 props ​

背景:某组件支持额外 props,但右侧属性配置里没有单独开关。

步骤:

  1. 选中组件,点 自定义属性配置,写入例如 {"maxlength":20,"showWordLimit":true},点 确定 后预览核对。

场景:用 JSON 补写 props

预期:补写的键会合并进组件 props。已有面板项请优先用面板改,避免和自定义 JSON 互相覆盖搞混。

注意点 ​

  • 先看当前组件面板有哪些项,不要假设「所有组件都有同一套属性」。
  • 输入框清除叫 是否显示清除按钮;部分选择器叫 是否可以清空选项。
  • 类型/长度限制管输入形态,严格格式仍靠验证。
  • 静态只读适合详情模板;流程中动态锁定用高级里的禁用条件。
  • 数据绑定 与 自定义属性配置 都在属性配置标题旁;前者接变量,后者写 JSON props。
  • 配置表单项(基础配置里)≠ 自定义属性配置。
  • 自定义键名绑 props 时按 props.<属性名> 填写(弹窗内有规则说明)。

相关阅读 ​

相关技术文档 ​