百度小程式自定義通用toast元件

Tiffany的小熊發表於2019-07-16
AST元件

百度小程式Toast元件

author: @TiffanysBear

百度小程式自定義通用toast元件

BdToast百度小程式自定義通用元件-github地址

需求

手百小程式的toast僅支援在頁中展示，不能自定義位置、字型大小、在單個文字中增加icon等需求；因此自定義一個全域性可通用的Toast。

效果預覽

image
image
image
image

如何使用

程式碼目錄位於 /widget/toast 下，包含3個檔案

  • toast.js 指令碼程式碼
  • toast.css 樣式檔案，可以根據自己需求定製
  • toast.swan 模板結構，可以根據自己需求定製

使用步驟一：

將/widget/toast的三個檔案，放在與page同名的widget資料夾中，如果專案沒有widget資料夾，就新建一個。

image

使用步驟二：

在專案的整個 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~

相關文章