工具栏扩展
通过工具栏扩展,您可以在工具栏中添加自定义菜单分组,实现个性化工具栏的配置。同时您也可以通过插槽和页边栏实现联动,在页边栏中添加自定义内容,也可以手动控制工具栏的打开和关闭等。
使用场景
- 按业务定制工具栏分组(办公/审核/AI 等)
- 按角色定制入口(编辑者、审阅者、只读用户看到不同的工具栏)
- 把“高频动作”上浮为一级入口(导出、插入表格、打开素材库等)
- 通过插槽注入企业自定义按钮(审批、归档、发布、同步到外部系统)
- 多产品形态复用一套编辑器(不同页面用不同的 menus 配置)
与其他功能协同使用
- 页边栏(aside):工具栏负责“触发”,页边栏负责“承载复杂 UI/流程”
- AI(ai):把 AI Assistant/Chat 入口放到工具栏,结合页边栏做完整交互
- 导入/导出(import/export):把常用导入/导出操作放入专属分组
- 修订(revision)与评论(comments):给审阅者提供清晰的一键入口
- 内容锁定(locked)与模板(template):把“锁定/解锁/套用模板”等操作做成固定入口
默认配置
const defaultOptions = {
// 工具栏扩展配置
toolbar: {
menus: [
'base',
'insert',
'table',
'tools',
'page',
'view',
'import',
'export',
],
extensions: [],
},
}配置项说明
toolbar.extensions
说明:工具栏菜单分组扩展。
类型:Array
默认值:[]
示例
extensions: [
{ title: '办公助手', key: 'office' },
{ title: '扩展插件', key: 'plugins' },
]数组中的每一项表示一个分组。
配置项
title:分组显示名称。key:分组唯一标识,是插槽注入的重要依据,不允许和默认分组标识重复,不可设置值包括:base、insert、table、tools、page、export。
插槽配置项
插槽设置和标准的工具栏插槽格式相同,其中标识为#toolbar_{key} 依据配置项中key值的不同来处理。
其他工具栏插槽配置见插槽列表。
示例
<template #toolbar_office="props">
<span>toolbar_office slot:{{ props }}</span>
</template>
<template #toolbar_plugins="props">
<span>toolbar_plugins slot:{{ props }}</span>
</template>