百度小程序Toast組件
author: @TiffanysBear
百度小程序自定義通用toast組件
需求
手百小程序的toast僅支持在頁中展示茂契，不能自定義位置莫绣、字體大小糖埋、在單個(gè)文本中增加icon等需求前计；因此自定義一個(gè)全局可通用的Toast。
效果預(yù)覽
image
image
image
image
如何使用
代碼目錄位于 /widget/toast 下捆昏，包含3個(gè)文件
- toast.js 腳本代碼
- toast.css 樣式文件乃秀，可以根據(jù)自己需求定制
- toast.swan 模板結(jié)構(gòu)菱蔬，可以根據(jù)自己需求定制
使用步驟一：
將/widget/toast的三個(gè)文件，放在與page同名的widget文件夾中砾层，如果項(xiàng)目沒有widget文件夾漩绵，就新建一個(gè)。
image
使用步驟二：
在項(xiàng)目的整個(gè) 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
}
});
使用步驟三：
在項(xiàng)目的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}}"/>
使用步驟五
在具體的頁面進(jìn)行初始化調(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è)置時(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)題，同時(shí)需要title存在才會(huì)顯示粟害，否則不顯示副標(biāo)題 |
| duration | number | 否 | 持續(xù)時(shí)間蕴忆，不填默認(rèn)1500毫秒 |
| success | function | 否 | 執(zhí)行成功的回調(diào) |
| fail | function | 否 | 執(zhí)行失敗的回調(diào) |
| complete | function | 否 | 完成的回調(diào)，不管有沒有執(zhí)行成功 |
最后說明
例子Demo中也有關(guān)于toast的點(diǎn)擊tap事件的綁定悲幅，因?yàn)榇斯δ懿皇呛艹Ｓ锰锥欤信d趣的可以clone下來自行研究。另外汰具，如果有樣式結(jié)構(gòu)或者樣式不符合需求的話卓鹿，可以自己在 widget/toast的源碼中進(jìn)行更新，直到符合自己的需求~
歡迎star留荔、issue和pull request~
