自定义节点开发

Toast API

Toast API 提供了一种向用户显示非阻塞通知消息的方式。这对于在不打断工作流的情况下提供反馈非常有用。 基本用法 简单 Toast javascript // 显示一个简单的信息提示 app.extensionManager.toast.add severity: "info", summary: "信息", detail: "操作已成功完成", li

Toast API 提供了一种向用户显示非阻塞通知消息的方式。这对于在不打断工作流的情况下提供反馈非常有用。

基本用法

简单 Toast

javascript
// 显示一个简单的信息提示
app.extensionManager.toast.add({
  severity: "info",
  summary: "信息",
  detail: "操作已成功完成",
  life: 3000
});

Toast 类型

javascript
// 成功提示
app.extensionManager.toast.add({
  severity: "success",
  summary: "成功",
  detail: "数据保存成功",
  life: 3000
});

// 警告提示
app.extensionManager.toast.add({
  severity: "warn",
  summary: "警告",
  detail: "此操作可能导致问题",
  life: 5000
});

// 错误提示
app.extensionManager.toast.add({
  severity: "error",
  summary: "错误",
  detail: "请求处理失败",
  life: 5000
});

Alert 辅助方法

javascript
// 快捷方式创建警告提示
app.extensionManager.toast.addAlert("这是一条重要消息");

API 参考

Toast 消息

javascript
app.extensionManager.toast.add({
  severity?: "success" | "info" | "warn" | "error" | "secondary" | "contrast", // 消息严重级别(默认:"info")
  summary?: string,         // Toast 的简短标题
  detail?: any,             // 详细消息内容
  closable?: boolean,       // 用户是否可以关闭该提示(默认:true)
  life?: number,            // 自动关闭前的持续时间(毫秒)
  group?: string,           // 用于管理相关 Toast 的分组标识
  styleClass?: any,         // 消息的样式类
  contentStyleClass?: any   // 内容的样式类
});

Alert 辅助方法

javascript
app.extensionManager.toast.addAlert(message: string);

其他方法

javascript
// 移除指定的 toast
app.extensionManager.toast.remove(toastMessage);

// 移除所有 toast
app.extensionManager.toast.removeAll();

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本,并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明,不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0来源和修改说明