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

百度小程序Toast組件

author: @TiffanysBear

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

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

需求

手百小程序的toast僅支持在頁中展示,不能自定義位置、字體大小、在單個文本中增加icon等需求;因此自定義一個全局可通用的Toast。

效果預(yù)覽

image

image

image

image

如何使用

代碼目錄位于 /widget/toast 下,包含3個文件

  • toast.js 腳本代碼
  • toast.css 樣式文件,可以根據(jù)自己需求定制
  • toast.swan 模板結(jié)構(gòu),可以根據(jù)自己需求定制

使用步驟一:

將/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}}"/>


使用步驟五

在具體的頁面進行初始化調(diào)用:

// 初始化
new app.BdToast();

// 具體調(diào)用:
Page({
    data: {},
    onLoad() {
        new app.BdToast();
    },
    clickShowToast(e) {
        switch (+e.target.dataset.id) {
            case 1:
                this.bdtoast.toast({
                    title: '僅顯示標(biāo)題'
                });
                break;
            case 2:
                this.bdtoast.toast({
                    title: '設(shè)置圖片+文字',
                    iconSrc: '../../images/loading.gif'
                });
                break;
            case 3:
                this.bdtoast.toast({
                    title: '設(shè)置時間',
                    duration: 1000
                });
                break;
            case 4:
                this.bdtoast.toast({
                    title: '設(shè)置標(biāo)題',
                    subTitle: '副標(biāo)題'
                });
                break;
        }
    }
});

參數(shù)說明:

參數(shù) 類型 必填 說明
title string 標(biāo)題
iconSrc string icon地址,提供icon的url,icon大小為32px * 32px
subTitle string 副標(biāo)題,同時需要title存在才會顯示,否則不顯示副標(biāo)題
duration number 持續(xù)時間,不填默認1500毫秒
success function 執(zhí)行成功的回調(diào)
fail function 執(zhí)行失敗的回調(diào)
complete function 完成的回調(diào),不管有沒有執(zhí)行成功

最后說明

例子Demo中也有關(guān)于toast的點擊tap事件的綁定,因為此功能不是很常用,有興趣的可以clone下來自行研究。另外,如果有樣式結(jié)構(gòu)或者樣式不符合需求的話,可以自己在 widget/toast的源碼中進行更新,直到符合自己的需求~
歡迎star、issue和pull request~

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容