插入组件 v1.4.3+
约 637 字大约 2 分钟
2026-05-13
概述
MSLX 的插件系统允许您在原有页面的一些槽位新增组件/插入下拉菜单,效果如下:

新增的组件注入均在插件的 入口文件 中导出的 pluginConfig 集合中的 extensions 数组。
具体示例可参考 mslx-plugin-demo 插件的插件入口示例:mslx-plugin-demo/Frontend/src/pluginEntry.ts at main · MSLTeam/mslx-plugin-demo
本文档将展示所有支持的插槽。其中徽章指示代表该插槽支持的最低MSLX SDK版本。Version
配置示例
extensions[i].slotRequiredstring
插槽名字(见本文档)
extensions[i].componentRequiredstring
嵌入的组件(需要在上方import)
以上两项为插槽的通用配置,如插槽有其他配置项(例如label),会在下方文档补充说明。
extensions: [
{
slot: 'instance-console-dropdown', // 注入到实例控制台更多功能的下拉菜单
component: InstanceDropDownItemInject, // 弹窗组件
label: '插件弹窗', // 下拉子菜单名
icon: GitBranchIcon, // 下拉子菜单Icon
},
{
slot: 'instance-console-overview-bottom', // 注入到实例控制台玩家卡片下方
component: InstanceCardInject, // 组件
}
]服务端管理-实例控制台-更多功能菜单插槽
插槽名:instance-console-dropdown v1.4.3
在此页面的 更多功能 下拉菜单处新增一个菜单项,点击该菜单应该新显示一个 t-dialog 组件。
此插槽需要新增以下配置项:
extensions[i].labelRequiredstring
新增的下拉菜单的名字
extensions[i].iconRequiredcomponent
嵌入的图标组件(需要是TDesign的图标组件)
{
slot: 'instance-console-dropdown', // 注入到实例控制台更多功能的下拉菜单
component: InstanceDropDownItemInject, // 弹窗组件
label: '插件弹窗', // 下拉子菜单名
icon: GitBranchIcon, // 下拉子菜单Icon
},
此外,为了能正常触发t-dialog的显示,需要在插入的组件中暴露一个open方法给宿主。
// 暴露接口给宿主
defineExpose({
open: () => {
console.log('👉 [插件内部] open 方法被成功触发!');
visible.value = true; // 显示弹窗
}
});简单的弹窗组件示例在这里:mslx-plugin-demo/Frontend/src/views/InstanceDropDownItemInject.vue at main · MSLTeam/mslx-plugin-demo
服务端管理-实例控制台-左侧控制栏下方插槽
插槽名:instance-console-overview-bottom v1.4.3

示例插入组件:mslx-plugin-demo/Frontend/src/views/InstanceCardInject.vue at main · MSLTeam/mslx-plugin-demo
