Skip to content
On this page

配置

通过字段禁用

根据配置字段的值来判定按钮禁用,仅支持单个字段。

配置项类型默认值描述
disableFieldstring判定按钮禁用的字段
disableFieldValuestring | number | (string | number)[]判定按钮禁用的字段对应的值
disableFieldCondiction"some" | "every""some"判定按钮禁用的选中数据范围

配置填写位置

功能设计器 -> 事件明细 -> 自定义参数列

配置示例

  • 示例一:{disableField: 'status', disableFieldValue: 1}

    1. 工具栏按钮:列表选中行数据,有一行数据的 status 字段值为 1 时禁用按钮
    2. 行内按钮:当前行数据,status 字段值为 1 时禁用按钮
    3. 表单按钮:表单数据,status 字段值为 1 时禁用按钮
  • 示例二:{disableField: 'status', disableFieldValue: 1, disableFieldCondiction: 'every'}

    1. 工具栏按钮:列表选中行数据,每一行数据的 status 字段值都为 1 时禁用按钮
    2. 行内按钮:当前行数据,status 字段值为 1 时禁用按钮
    3. 表单按钮:表单数据,status 字段值为 1 时禁用按钮

WARNING

注意:表单按钮禁用仅在切换至表单时判定一次,编辑表单数据时不会再次判定

通过表达式禁用

根据表达式的值来判定按钮禁用。表达式的书写方式参考表达式

配置项类型默认值描述
disableExpressionstring判定按钮禁用的表达式
disableExpressionCondiction"some" | "every""some"判定按钮禁用的选中数据范围
  • disableExpression 在表达式中可以使用 row 来表示当前行的数据,例如 row.id === 1
  • disableExpressionCondiction
    • 配置为 some 时,勾选行内有一行数据使得表达式为真值,即禁用按钮;
    • 配置为 every 时,需要所有勾选行的数据都使得表达式为真值,才禁用按钮

配置填写位置

功能设计器 -> 事件明细 -> 自定义参数列

配置示例

  • 示例一:{disableExpression: 'row.status === \'1\''}

    1. 工具栏按钮:列表选中行数据,有一行数据传入表达式执行返回 true 时禁用按钮
    2. 行内按钮:当前行数据传入表达式执行返回 true 时禁用按钮
    3. 表单按钮:表单数据传入表达式执行返回 true 时禁用按钮
  • 示例二:{disableExpression: "row.status === 1", disableExpressionCondiction: 'every'}

    1. 工具栏按钮:列表选中行数据,所有行的数据传入表达式执行都返回 true 时禁用按钮
    2. 行内按钮:当前行数据传入表达式执行返回 true 时禁用按钮
    3. 表单按钮:表单数据传入表达式执行返回 true 时禁用按钮

WARNING

  • 表单按钮禁用仅在切换至表单时判定一次,编辑表单数据时不会再次判定。
  • 此配置项会生成到标签属性上,因此表达式中的字符串需要使用单引号包裹,例如 {disableExpression: 'row.status === \'1\''}