API 文档

// 字符串形式
MeToast.show('默认消息');
MeToast.show('自定义', { duration: 2000, position: 'bottom-center' });
// 对象形式
MeToast.show({ title: '标题', message: '内容', duration: 3000 });

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

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

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

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

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

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

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

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

const p = MeToast.progress('上传中...', { progressColor: '#10b981' });
p.setProgress(45);
p.complete('上传完成！');

MeToast.countdown('{seconds} 秒后执行', 5, { onComplete: () => MeToast.success('已执行') });
// 返回 { cancel(), pause(), resume() }

const q = MeToast.queue(['步骤一', '步骤二', '步骤三'], { delay: 800, duration: 2000 });
q.cancel();  // 中途取消
await q;      // 等待完成

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

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

const orders = MeToast.group('orders');
orders.success('订单已创建');
orders.count();    // 该组数量
orders.dismiss();  // 关闭整组
MeToast.dismissGroup('orders');

MeToast.dismiss();         // 全部
MeToast.dismiss(toast.id); // 指定

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

const t = MeToast.info('可移动的 Toast');
t.updatePosition('bottom-left');

t.remove();                  // 实例方法
MeToast.removeToast(t.id);    // 按 id（等价）

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

MeToast.use('keyboard');      // ESC 关闭所有
MeToast.use('persistence');   // 配置持久化 localStorage
MeToast.use('accessibility'); // 屏幕阅读器朗读
MeToast.use('dedupe');        // 相同 type+message 自动去重

MeToast.destroy();
MeToast.init({ config: { duration: 3000 } });  // 恢复

import MeToast, { Toast } from '@metona-team/metona-toast';

// 拦截：非允许时段禁止错误提示
const off = Toast.on('beforeShow', (toast) => {
  if (toast.type === 'error' && !isAllowed) return false;
});
// ...
off();  // 取消注册

import { useToast, Toast } from '@metona-team/metona-toast/react';

function SubmitButton() {
  const toast = useToast();  // 组件卸载自动清理本组件创建的 Toast
  const submit = async () => {
    const loading = toast.loading('正在提交...');
    try { await api(); loading.success('完成！'); }
    catch (e) { loading.error('失败'); }
  };
  return <button onClick={submit}>提交</button>;
}

// 声明式 Toast：props 变化更新，卸载自动移除（autoClose 默认 true）
function SaveIndicator({ saving }) {
  return saving ? <Toast type="info" message="正在保存..." /> : null;
}

// 内置主题：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');