百度小程序Toast組件
author: @TiffanysBear
百度小程序自定義通用toast組件
需求
手百小程序的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~