百度小程序自定義通用toast組件

百度小程序Toast組件

author: @TiffanysBear

百度小程序自定義通用toast組件

BdToast百度小程序自定義通用組件-github地址

需求

手百小程序的toast僅支持在頁中展現，不能自定義位置、字體大小、在單個文本中增長icon等需求；所以自定義一個全局可通用的Toast。

效果預覽

如何使用

代碼目錄位於 /widget/toast 下，包含3個文件

• toast.js 腳本代碼
• toast.css 樣式文件，能夠根據本身需求定製
• toast.swan 模板結構，能夠根據本身需求定製

使用步驟一：

將/widget/toast的三個文件，放在與page同名的widget文件夾中，若是項目沒有widget文件夾，就新建一個。

使用步驟二：

在項目的整個 app.js 中引入，一次引入，全部page都可以使用：

// 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：

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

使用步驟四：

在須要的page頁面，將模板引入：

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

使用步驟五

在具體的頁面進行初始化調用：

// 初始化
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~