Toast 轻提示

引入

通过以下方式来全局注册组件,更多注册方式请参考。

文字提示

加载提示

使用 Toast.loading 方法展示加载提示,通过 forbidClick 属性可以禁用背景点击。

  1. message: '加载中...',
  2. forbidClick: true,
  3. });

成功/失败提示

使用 Toast.success 方法展示成功提示,使用 Toast.fail 方法展示失败提示。

  1. Toast({
  2. message: '自定义图标',
  3. icon: 'like-o',
  4. });
  5. Toast({
  6. message: '自定义图片',
  7. icon: 'https://img.yzcdn.cn/vant/logo.png',
  8. });
  9. Toast.loading({
  10. message: '加载中...',
  11. forbidClick: true,
  12. loadingType: 'spinner',
  13. });

自定义位置

Toast 默认渲染在屏幕正中位置,通过 position 属性可以控制 Toast 展示的位置。

  1. Toast({
  2. position: 'top',
  3. Toast({
  4. message: '底部展示',
  5. position: 'bottom',
  6. });

动态更新提示

执行 Toast 方法时会返回对应的 Toast 实例,通过修改实例上的 message 属性可以实现动态更新提示的效果。

全局方法

通过 app.use 全局注册 Toast 组件后,会自动在 app 的所有子组件上挂载 $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.setDefaultOptions 函数可以全局修改 Toast 的默认配置。

方法

ToastOptions 数据结构

类型定义

组件导出以下类型定义:

    样式变量