Skip to content

禁用及只读

禁用及只读用于控制字段是否可编辑,适合限制用户修改内容或仅展示数据的场景。两者都会限制编辑,但一个更强调“不可操作”,一个更强调“可见但不允许修改”。

  1. 禁用状态:通过布尔值控制字段是否可交互,禁用时字段呈现灰色不可点击状态,用户无法修改内容。
  2. 只读样式:字段内容可见但不可编辑,通常保留默认样式区分可编辑状态。

应用场景

禁用

表单提交后防止用户修改已提交数据。 根据业务逻辑动态禁用部分字段(如未勾选协议时禁用提交按钮)。这类动态场景通常也会继续用到禁用条件

只读

展示系统生成或不可修改的信息(如订单号、创建时间)。 预览模式下禁止编辑,仅允许查看。

设置入口

字段禁用与只读通过以下方式设置,在「组件配置 >> 属性配置」处设置「字段禁用/只读」:

设置效果

字段禁用效果

字段只读效果

支持字段

支持设置「字段禁用」的字段:

输入框、多行输入框、密码输入框、提及「不支持只读样式」、分段控制器「不支持只读样式」、数字输入框「不支持只读样式」、单选框「不支持只读样式」、多选框、选择器、开关、评分、时间、时间区间、滑块、日期、日期区间、颜色选择器、级联选择器、上传、穿梭框、树形控件、树形选择、省市区选择器、富文本框、手写签名、子表单选择器、子表单、分组、表格表单、嵌套表单、无限级表单、按钮

支持设置「字段只读」的字段:

输入框、多行输入框、密码输入框、时间、时间区间、日期、日期区间、计算公式、插槽区域、动态区域

如果你需要在运行时统一切换多个字段的编辑状态,也可以继续结合表单 API中的 disabled 等方法处理;若是基于条件自动切换,则更适合和逻辑条件禁用条件配合。