百度小程序Toast组件

Posted on | In
Words count in article: 669 | Reading time ≈ 2

百度小程序Toast组件
author: @TiffanysBear

BdToast百度小程序自定义通用组件

BdToast百度小程序自定义通用组件-github地址

需求

手百小程序的toast仅支持在页中展示，不能自定义位置、字体大小、在单个文本中增加icon等需求；因此自定义一个全局可通用的Toast。

效果预览




如何使用

代码目录位于 /widget/toast 下，包含3个文件

  • toast.js 脚本代码
  • toast.css 样式文件，可以根据自己需求定制
  • toast.swan 模板结构，可以根据自己需求定制

使用步骤一：

将/widget/toast的三个文件，放在与page同名的widget文件夹中，如果项目没有widget文件夹，就新建一个。

使用步骤二：

在项目的整个 app.js 中引入，一次引入，所有page均可以使用：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// app.js
import { BdToast } from './widget/toast/toast.js';

App({
    BdToast, // 挂载
    onLaunch(options) {
        // do something when launch
    },
    onShow(options) {
        // do something when show
    },
    onHide() {
        // do something when hide
    }
});

使用步骤三：

在项目的app.css中引入 toast.css：

1
2
// app.css
@import "./widget/toast/toast.css";

使用步骤四：

在需要的page页面，将模板引入：

1
2
3
4
// pages/index/index.swan
<!-- toast使用 -->
<import src="/widget/toast/toast.swan"/>
<template is="bdtoast" data="{{bdtoast}}"/>

使用步骤五

在具体的页面进行初始化调用：

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
// 初始化
new app.BdToast();

// 具体调用：
Page({
    data: {},
    onLoad() {
        new app.BdToast();
    },
    clickShowToast(e) {
        switch (+e.target.dataset.id) {
            case 1:
                this.bdtoast.toast({
                    title: '仅显示标题'
                });
                break;
            case 2:
                this.bdtoast.toast({
                    title: '设置图片+文字',
                    iconSrc: '../../images/loading.gif'
                });
                break;
            case 3:
                this.bdtoast.toast({
                    title: '设置时间',
                    duration: 1000
                });
                break;
            case 4:
                this.bdtoast.toast({
                    title: '设置标题',
                    subTitle: '副标题'
                });
                break;
        }
    }
});

参数说明：

参数 类型 必填 说明
title string 是 标题
iconSrc string 否 icon地址，提供icon的url，icon大小为32px * 32px
subTitle string 否 副标题，同时需要title存在才会显示，否则不显示副标题
duration number 否 持续时间，不填默认1500毫秒
success function 否 执行成功的回调
fail function 否 执行失败的回调
complete function 否 完成的回调，不管有没有执行成功

最后说明

例子Demo中也有关于toast的点击tap事件的绑定，因为此功能不是很常用，有兴趣的可以clone下来自行研究。另外，如果有样式结构或者样式不符合需求的话，可以自己在 widget/toast的源码中进行更新，直到符合自己的需求~
欢迎star、issue和pull request~