Toast 轻提示

使用指南

  1. import { Toast } from 'vant';

代码演示

文字提示

  1. Toast('我是提示文案,建议不超过十五字~');

加载提示

  1. Toast.loading({
  2. mask: true,
  3. message: '加载中...'
  4. });

成功/失败提示

  1. Toast.success('成功文案');
  2. Toast.fail('失败文案');

高级用法

  1. const toast = Toast.loading({
  2. duration: 0, // 持续展示 toast
  3. forbidClick: true, // 禁用背景点击
  4. loadingType: 'spinner',
  5. message: '倒计时 3 秒'
  6. });
  7. let second = 3;
  8. const timer = setInterval(() => {
  9. second--;
  10. if (second) {
  11. toast.message = `倒计时 - {second} 秒`;
  12. } else {
  13. clearInterval(timer);
  14. Toast.clear();
  15. }
  16. }, 1000);

组件内调用

引入 Toast 组件后,会自动在 Vue 的 prototype 上挂载 - toast 方法,便于在组件内调用。

  1. export default {
  2. mounted() {
  3. this.- toast('提示文案');
  4. }
  5. }

单例模式

Toast 默认采用单例模式,即同一时间只会存在一个 Toast,如果需要在同一时间弹出多个 Toast,可以参考下面的示例

  1. Toast.allowMultiple();
  2. const toast1 = Toast('第一个 Toast');
  3. const toast2 = Toast.success('第二个 Toast');
  4. toast1.clear();
  5. toast2.clear();

方法

方法名 参数 返回值 介绍
Toast options message toast 实例 展示提示
Toast.loading options message toast 实例 展示加载提示
Toast.success options message toast 实例 展示成功提示
Toast.fail options message toast 实例 展示失败提示
Toast.clear clearAll void 关闭提示
Toast.allowMultiple - void 允许同时存在多个 Toast
Toast.setDefaultOptions options void 修改默认配置,对所有 Toast 生效
Toast.resetDefaultOptions - void 重置默认配置,对所有 Toast 生效

Options

参数 说明 类型 默认值
type 提示类型,可选值为 loading success fail html String text
position 位置,可选值为 top middle bottom String middle
message 内容 String ''
mask 是否显示背景蒙层 Boolean false
forbidClick 是否禁止背景点击 Boolean false
loadingType 加载图标类型, 可选值为 spinner String circular
duration 展示时长(ms),值为 0 时,toast 不会消失 Number 3000

原文:

https://youzan.github.io/vant/#/zh-CN/toast