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

基本用法

简单 Toast

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

Toast 类型

// 成功提示
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 辅助方法

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

API 参考

Toast 消息

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 辅助方法

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

其他方法

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

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