# 提示框 toast

# 描述

一种轻量级反馈/提示,可以用来显示不会打断用户操作的内容,适合用于页面转场、数据交互的等场景中。

# 使用效果

# 使用方法

.ux文件中引入组件

<import name="my-toast" src="apex-ui/components/toast/index"></import>
1

# 示例

<template>
  <div class="wrap">
    <my-button type="ghost" ontap="handleText">只显示文本</my-button>
    <my-button type="ghost" ontap="handleSuccess">成功</my-button>
    <my-button type="ghost" ontap="handleWarning">警告</my-button>
    <my-button type="ghost" ontap="handleError">错误</my-button>
    <my-button type="ghost" ontap="handleLoading">Loading</my-button>
    <my-button type="ghost" ontap="handleIcon">使用图标</my-button>
    <my-button type="ghost" ontap="handleImage">使用自定义图片</my-button>
    <my-button type="ghost" ontap="handleMask">无遮罩层</my-button>

    <my-toast id="toast"></my-toast>
  </div>
</template>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
.wrap {
    flex-direction: column;
    padding-top: 100px;
}
1
2
3
4
export default {
    handleText() {
        this.$child('toast').showToast({
            content: '这是文本提示'
        });
    },
    handleSuccess() {
        this.$child('toast').showToast({
            content: '成功的提示',
            type: 'success'
        });
    },
    handleWarning() {
        this.$child('toast').showToast({
            content: '警告的提示',
            type: 'warning'
        });
    },
    handleError() {
        this.$child('toast').showToast({
            content: '错误的提示',
            type: 'error'
        });
    },
    handleLoading() {
        this.$child('toast').showToast({
            content: '加载中',
            type: 'loading'
        });
    },
    handleIcon() {
        this.$child('toast').showToast({
            content: '使用内置的图标',
            icon: 'thumbs-up'
        });
    },
    handleImage() {
        this.$child('toast').showToast({
            content: '使用自定义图片',
            image: 'https://quickapp.vivo.com.cn/content/images/size/w1000/2019/03/quickapp-logo-4.png'
        });
    },
    handleMask() {
        const _this = this;
        this.$child('toast').showToast({
            content: '5秒后自动关闭',
            icon: 'woman',
            duration: 0,
            mask: false
        });
        setTimeout(() => {
            _this.$child('toast').hideToast();
        }, 5000);
    },
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# API

# 组件参数-option

属性 类型 默认值 说明
content String - 提示的内容
icon String - 提示显示的图标,值为图标库中图标的type
image String - 图示显示的图片,支持网络图片
duration Number 2 显示持续的时间
mask Boolean true 是否显示遮罩层,点击遮罩层可关闭提示
type String default 提示类型,可选值有default 、success 、warning 、error 、loading

# 组件方法

方法名称 事件描述 参数
showToast(option) 显示提示 option
hideToast() 隐藏提示 -