Skip to content

Toast 轻提示

命令式全局轻提示,支持成功/错误/警告/信息/加载态、操作按钮与 promise 链,默认 3 秒自动关闭。

基础用法

五种类型

成功错误警告信息加载

自定义时长

自定义时长

2 秒5 秒不自动关闭(0)手动关闭

操作按钮

操作按钮

带操作按钮不可关闭

位置

位置

top-righttop-lefttop-centerbottom-center

Promise 链

Promise 链

模拟成功模拟失败

API

方法

方法说明
toast.info(options)信息提示,返回 { close }
toast.success(options)成功提示,返回 { close }
toast.warning(options)警告提示,返回 { close }
toast.error(options)错误提示,返回 { close }
toast.loading(options)加载提示(不可关),返回 { close }
toast.promise(promise, opts)promise 链:loading → success/error
destroyAllToast()清空全部 toast

options

字段说明类型默认值
title标题string
description描述string
action操作按钮{ label, onClick }
duration自动关闭时长(ms),0 不关闭number3000
closable是否可手动关闭(loading 恒关)booleantrue
position位置top-right 等 6 个方向top-right
  • error 类型使用 role="alert",其余使用 role="status"
  • 多个 toast 共用一个栈容器,同一方向按位置堆叠;duration 计时器在关闭/卸载时清理,无泄漏。