功能按钮配置

功能按钮是视图列表工具栏上的主功能按钮，点击后执行事件流或加载微应用组件。

概述

功能按钮位于列表上方工具栏，用于承载「新建」「导出」等主功能。在编辑器的 视图按钮配置 卡片中：

点击 新增视图按钮 添加一个按钮，新按钮默认名称为「视图按钮」，业务类型为「执行事件流」，样式为主题色。
卡片中以按钮真实样式预览，拖动可调整显示顺序。
点击按钮打开属性抽屉，可修改属性或点击右上角删除按钮移除。

配置项

配置项	说明
按钮名称	按钮显示文字，必填
业务类型	执行事件流或微应用组件
事件流	业务类型为「执行事件流」时配置，决定点击后执行的动作
微应用名称	业务类型为「微应用组件」时配置（待废弃）
微应用路由	业务类型为「微应用组件」时配置（待废弃）
按钮样式	默认 / 主题色 / 幽灵（反色）/ 虚线 / 链接 / 文本
展示为危险按钮	是否使用危险色呈现
按钮图标	按钮前的图标
是否隐藏	是否隐藏该按钮

微应用组件已废弃

业务类型「微应用组件」的按钮配置项处于禁用状态，新功能请统一使用「执行事件流」。

业务类型

业务类型	存储值	说明
执行事件流	`ExecuteActionPipeline`	点击后执行配置的事件流，为推荐方式
微应用组件	`MicroAppCmp`	加载微应用渲染按钮，待废弃

按钮样式

样式	存储值
默认	`default`
主题色	`primary`
幽灵（反色）	`ghost`
虚线	`dashed`
链接	`link`
文本	`text`

建议：主要操作（新建、提交）用 primary，次要操作（导出）用 default，危险操作（删除）用 default 并开启「展示为危险按钮」。

支持的动作类型

「执行事件流」可配置以下动作：

动作类型	存储值	说明
弹窗新增后刷新	`PopFormAddThenRefresh`	打开新增表单，提交后刷新列表
批量编辑表单后刷新	`BatchEditFormThenRefresh`	打开批量编辑表单，提交后刷新
数据导出	`DataExport`	导出列表数据
数据导入	`DataImport`	导入数据
请求接口	`RequestInterface`	调用平台接口
抽屉展示页面	`DrawerShowPage`	抽屉打开页面
弹窗展示页面	`ModalShowPage`	弹窗打开页面
打开当前页	`OpenCurrentPage`	在当前页内打开页面
打开新页面	`OpenNewPage`	新开页面
关闭临时页面	`CloseTemporaryPage`	关闭临时页面
刷新关联数据	`RefreshRelation`	刷新关联数据
刷新页面	`RefreshPage`	刷新当前页面
重新加载页面	`ReloadPage`	重新加载页面

下一步

批量操作按钮 - 配置勾选后的批量操作
列表行按钮 - 配置行内操作按钮
平台接口 - 了解可被请求的接口

属性明细

以下内容面向技术实现与 AI 检索，逐个说明功能按钮 MetaViewButtonItem 的属性。

MetaViewButtonItem 属性表

功能按钮继承自 MetaViewButtonBase：

属性名	类型	含义	取值/存储值
`Id`	string(GUID)	按钮标识	仅作前端标识，无业务意义
`Name`	string	按钮名称	显示文字，必填
`IsHide`	bool	是否隐藏	默认 `false`
`BizType`	string	业务类型	`ExecuteActionPipeline` 或 `MicroAppCmp`
`ActionPipeline`	string	事件流	JSON 字符串，业务类型为 `ExecuteActionPipeline` 时使用
`MicroAppName`	string	微应用名	业务类型为 `MicroAppCmp` 时使用（待废弃）
`MicroAppPath`	string	微应用路由	业务类型为 `MicroAppCmp` 时使用（待废弃）
`Type`	string	按钮样式	`default`/`primary`/`ghost`/`dashed`/`link`/`text`
`IsDanger`	bool	危险按钮	默认 `false`
`Icon`	string	图标	图标标识串，前端由 `IconSelectCmp` 选择

存储示例

{
  "Id": "b1a2c3d4-0001-4a2b-8c3d-111122223333",
  "Name": "新建图书",
  "IsHide": false,
  "BizType": "ExecuteActionPipeline",
  "ActionPipeline": "[{\"ActionType\":\"PopFormAddThenRefresh\",\"Params\":{}}]",
  "MicroAppName": null,
  "MicroAppPath": null,
  "Type": "primary",
  "IsDanger": false,
  "Icon": "PlusOutlined"
}

概述​

配置项​

业务类型​

按钮样式​

支持的动作类型​

下一步​

属性明细​

MetaViewButtonItem 属性表​

存储示例​

相关接口​

概述

配置项