Skip to main content

组件

组件动作是指与组件相关的动作,包含组件可见性、组件可用性、刷新组件、设置组件数据、提交表单、清空表单、重置表单、校验表单、组件特性动作。

组件可见性

控制组件的显示与隐藏。

动作说明

配置参数说明如下:

参数说明
componentId目标组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 组件可见性
  2. 选择目标组件,勾选显示或者隐藏,确认提交。

image

组件可用性

控制组件的启用与禁用。

动作说明

配置参数说明如下:

参数说明
componentId目标组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 组件可用性
  2. 选择目标组件,勾选启用或者禁用,确认提交。

image

组件展示态

控制组件的输入态与静态

动作说明

配置参数说明如下:

参数说明
componentId目标组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 组件展示态
  2. 选择目标组件,勾选表单输入或者表单静态,确认提交

image

刷新组件

刷新指定组件,使目标组件重新请求并重新加载初始化数据,同时可以给目标组件的数据域追加数据

动作说明

配置参数说明如下:

参数说明
componentId目标组件ID
data目标组件ID
dataMergeMode目标组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 刷新组件
  2. 选择目标组件,选择开启追加数据,开启追加数据可以向目标组件的数据域中追加数据 image
  3. 选择目标组件,开启追加数据后,可以选择开启自定义数据。自定义数据关闭则追加当前事件产生的数据到目标组件数据域;自定义数据开启则追加自定义数据到目标组件数据域 image
  4. 选择目标组件、开启追加数据、开启自定义数据后。可以选择自定义数据赋值方式,选择直接赋值则输入的数据将与数据域数据进行合并;选择成员赋值则指定变量名进行赋值 image
  5. 选择追加方式,合并或者覆盖原有数据,并确认提交

设置组件数据

传递数据给指定组件,与目标组件的数据域进行合并或修改目标组件的值。

动作说明

配置参数说明如下:

参数说明
componentId目标组件ID
value要传递的数据

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 设置组件数据

  2. 选择目标组件

  3. 如果目标组件是具备独立数据域的容器类组件,需要先选择赋值方式,包含直接赋值和成员赋值,直接赋值会将输入的数据与数据域原有数据合并; image 成员赋值可以指定数据域中具体变量和值;如果目标组件是表单项组件,可以选择当前表单已有的组件赋值也可以输入其它变量名进行赋值。 image

  4. 完成配置后,确认提交。

提交表单

提交指定表单。

动作说明

配置参数说明如下:

参数说明
componentId表单组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 提交表单
  2. 选择目标表单组件,确认提交。 image

清空表单

清空指定表单。

动作说明

配置参数说明如下:

参数说明
componentId表单组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 清空表单
  2. 选择目标表单组件,确认提交。 image

重置表单

重置指定表单。

动作说明

配置参数说明如下:

参数说明
componentId表单组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 重置表单
  2. 选择目标表单组件,确认提交。 image

校验表单

校验指定表单。

动作说明

配置参数说明如下:

参数说明
componentId表单组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 校验表单
  2. 选择目标表单组件,确认提交。 image

组件特性动作

触发指定组件的特性动作,特性动作是指组件自身的专属动作。可以前往amis 文档查看各组件的动作表(没有动作表的组件表示暂不支持触发专属动作)。

动作说明

配置参数说明如下:

参数说明
actionType组件动作名称
componentId组件ID

操作步骤

按以下步骤在页面设计器进行动作配置:

  1. 打开动作配置弹窗后,选择:组件 > 提交表单
  2. 选择目标表单组件
  3. 选择组件动作,组件动作列表中会罗列出当前所选组件支持的特性动作
  4. 完成所选组件动作相关配置,确认提交。 image