跳转到主要内容
侧边栏标签页 API 允许扩展为 ComfyUI 界面的侧边栏添加自定义标签页。这对于添加需要持续可见性和快速访问的功能非常有用。

基本用法

标签页配置

每个标签页需要以下属性:
render 函数会接收一个 DOM 元素,你应在其中插入标签页的内容。

图标选项

侧边栏标签页图标使用 icon-[lucide--<icon-name>] 格式的 Lucide 图标类名(如 icon-[lucide--compass])。 这些类名在前端构建时生成,因此只能使用前端自身用到的 Lucide 图标。如果图标无法显示,请换一个图标,或在扩展加载的样式表中定义自己的图标类名。 PrimeIcons(pi pi-*)和 Material Design Icons(mdi mdi-*)类名目前仍可显示,但正在逐步淘汰,请勿在新代码中使用。请参阅 PrimeVue 移除迁移指南。

有状态标签页示例

你可以创建带有状态的标签页:

使用 React 组件

你可以在侧边栏标签页中挂载 React 组件:
如需查看将 React 应用集成为侧边栏标签页的真实案例,请参考 ComfyUI-Copilot 项目(GitHub)。

动态内容更新

你可以根据图变化动态更新侧边栏内容: