API 文档

MetonaToast v2.0.0 完整 API 参考。所有基础通知方法（show/success/error/warning/info/loading）支持两种调用形式，均可传入任何 配置项 作为可选第二参数。

show(message, opts?)

显示默认类型的 Toast 通知，无特定颜色和图标。

// 字符串形式
MeToast.show('默认消息');
MeToast.show('自定义', { duration: 2000, position: 'bottom-center' });
// 对象形式（所有 opts 作为一级属性）
MeToast.show({ title: '标题', message: '内容', duration: 3000 });

success(message, opts?)

显示成功通知。绿色对勾图标 #10b981，type = success。

MeToast.success('保存成功！');
MeToast.success({ title: '已保存', message: '数据已同步' });
Met.success('MeToast和Met等价');

error(message, opts?)

显示错误通知。红色叉号图标 #ef4444，type = error。aria-live 设为 assertive。

MeToast.error('网络错误，请重试');
MeToast.error({ title: '提交失败', message: '服务器不可达' });

warning(message, opts?)

显示警告通知。黄色三角图标 #f59e0b，type = warning。

MeToast.warning('请注意检查输入内容');

info(message, opts?)

显示信息通知。蓝色圆形图标 #3b82f6，type = info。

MeToast.info('系统将于 22:00 维护');

loading(message, opts?)

显示加载状态。type = loading，duration 强制为 0（不自动关闭），closeButton 和 showProgress 强制为 false。返回 LoadingControl 对象。

const loading = MeToast.loading('正在提交...');
setTimeout(() => loading.success('提交成功！'), 2000);

promise(promise, opts)

监听 Promise 生命周期。自动显示 loading → 根据 resolve/reject 自动切换 success/error。返回原 Promise，支持 await 获取结果。

try {
  await MeToast.promise(fetch('/api/data'), {
    loading: '加载中...',
    success: '加载完成！',
    error: '加载失败',
  });
} catch (e) { /* promise reject 会继续抛出 */ }

confirm(message, opts?)

确认对话框。返回 Promise<boolean>。内置 10 秒安全超时，超时自动 resolve(false)。

const ok = await MeToast.confirm('确定删除？', {
  confirmText: '删除',
  confirmColor: '#ef4444',
  cancelText: '保留',
});
if (ok) MeToast.success('已删除');

prompt(message, opts?)

输入对话框。返回 Promise<string|null>。按 Enter 或点击提交按钮返回输入值，取消返回 null。内置 10 秒安全超时。

const name = await MeToast.prompt('请输入姓名', {
  placeholder: '请输入...',
  defaultValue: '张三',
  submitText: '确定',
});
if (name) MeToast.info('你好，' + name);

progress(message, opts?)

进度条通知。不自动关闭。返回 ProgressControl 对象以手动更新进度。

const p = MeToast.progress('上传中...', { progressColor: '#10b981' });
p.setProgress(45); // → 45%
p.setProgress(90); // → 90%
p.complete('上传完成！'); // → 100% → success
// 或
p.error('上传失败');
p.dismiss();

countdown(message, seconds, opts?)

倒计时 Toast。{seconds} 占位符每秒自动替换为剩余秒数。

MeToast.countdown('{seconds} 秒后执行', 5, {
  onComplete: () => MeToast.success('已执行'),
});

queue(messages, opts?)

顺序逐个显示消息队列。前一条关闭后延时显示下一条。返回 QueueControl（thenable + cancel）。

const q = MeToast.queue([
  '步骤一',
  { message: '步骤二', duration: 5000, type: 'warning' },
  '步骤三',
], { delay: 800, duration: 2000, type: 'info' });
q.cancel(); // 中途取消
await q;  // 等待完成（thenable 支持 await）

stack(messages, opts?)

同时错峰显示多条消息。每条间隔 stagger 毫秒依次出现，全部叠加在屏幕上。

MeToast.stack(['消息1', '消息2', { message: '警告', type: 'warning' }], {
  stagger: 150,
  type: 'info',
});

action(message, actions, opts?) v2.0

Action Toast：内嵌操作按钮。默认 duration=0 不自动关闭，closeButton=true。

MeToast.action('文件已删除', [
  { text: '撤销', onClick: () => restore(), color: '#3b82f6' },
  { text: '查看详情', onClick: (t) => openFile(), color: '#10b981', close: false },
]);

group(name) v2.0

创建 Toast 分组，返回 GroupAPI 对象。该对象所有方法自动传入 group: name，按组管理。

const orders = MeToast.group('orders');
orders.success('订单已创建');
orders.error('支付失败', { duration: 5000 });
orders.count();   // 该组当前 toast 数量
orders.dismiss(); // 关闭该组全部 toast
// 也支持主对象关闭
MeToast.dismissGroup('orders');

dismiss(id?)

关闭 Toast。无参数则关闭全部。

MeToast.dismiss();          // 关闭所有
MeToast.dismiss(toast.id);  // 关闭指定

clear(position?)

按位置清除 Toast。不传参数清除所有位置。

MeToast.clear();                      // 全部
MeToast.clear('bottom-right'); // 仅右下角

configure(opts)

全局配置，影响后续所有 Toast。theme 和 locale 变化会触发相应副作用（应用主题 CSS / 切换语言）。

MeToast.configure({
  position: 'top-right',
  duration: 4000,
  theme: 'dark',
  animation: 'slide',
  locale: 'zh-CN',
});

use(plugin)

安装插件。支持字符串（内置预设名）或插件对象。已被拒绝注册的无效插件会打印错误。

MeToast.use('keyboard');      // ESC 关闭所有 Toast
MeToast.use('persistence');   // 配置自动保存到 localStorage
MeToast.use('accessibility'); // 屏幕阅读器实时朗读 toast 内容

内置插件详情：keyboard 监听 keydown Escape 键；persistence 将配置写入 localStorage 并在页面加载时恢复；accessibility 在 afterShow/afterUpdate 钩子中通过 aria-live 区域朗读 toast 内容。

destroy()

完全销毁。关闭所有 Toast、移除所有 DOM 容器和注入的样式标签、清空内存缓存。

MeToast.destroy();

全部配置项

以下配置可用于 configure()、init() 或单个 Toast 方法的 opts 参数。带 v2.0 标识的为 v2.0 新增。

回调函数

动画列表

配置 animation 的值，支持以下 CSS 动画。未在此列表中的值将 fallback 到 slide。

主题参考

// 内置主题
light   — 白色玻璃质感
dark    — 深色玻璃质感
auto    — 跟随系统主题设置
warm    — 暖色调

// 注册自定义主题
MeToast.themes.registerTheme('ocean', {
  bg: 'rgba(240,249,255,0.96)',
  text: '#0c4a6e',
  border: 'rgba(14,165,233,0.2)',
  shadow: '0 10px 36px -10px rgba(14,165,233,0.18)',
  hoverShadow: '0 14px 48px -10px rgba(14,165,233,0.22)',
  progressBg: 'rgba(14,165,233,0.1)',
  closeHoverBg: 'rgba(14,165,233,0.1)',
});
MeToast.themes.switchTheme('ocean');