Skip to content

Toast 消息

一般用于提示用户 轻量简短 的消息,例如操作成功、操作失败等。

TIP

该弹出层支持 Promise 风格 调用,具体可以查看 等待弹出层关闭

基础使用

调用 toast 方法可以弹出一条消息,在屏幕居中显示。

快速使用主题 1.5.0+

直接使用 success()info()warning()danger() 方法可以快速显示不同主题的消息。

设置主题

通过 theme 属性可以设置消息的主题,默认值为 primary,支持的主题有 primaryinfosuccesswarningdanger

设置位置 1.5.0+

通过 placement 属性可以设置消息的位置,默认值为 center,支持的位置有:

  • left-top
  • left
  • left-bottom
  • top
  • center
  • bottom
  • right-top
  • right
  • right-bottom

持续时间

通过 duration 属性可以设置消息显示的持续时间,单位为毫秒,默认值为 2000 毫秒。

开始,duration 属性支持设置为 0 ,表示消息不会自动关闭,会强制显示关闭按钮。

显示关闭按钮 1.5.0+

通过 showClose 属性可以设置是否显示关闭按钮,允许用户手动关闭消息,默认值为 false

禁用鼠标悬停持续显示 1.5.0+

开始,消息默认开启鼠标悬停持续显示,当用户鼠标悬停在消息上时,消息将会持续显示,直到鼠标移出消息区域,消息才会自动关闭。

通过将 hoverWait 属性设置为 false 可以禁用鼠标悬停持续显示。

等待弹出层关闭

该方法返回一个 Promise<void> 对象,当弹出层关闭后,会执行 resolve 方法,因此你可以通过 await 来等待弹出层关闭。

详细配置

具体可以参考 API 控制器实例 popup.toast()

Released under the MIT License.