Toast API
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();