视频1 视频21 视频41 视频61 视频文章1 视频文章21 视频文章41 视频文章61 推荐1 推荐3 推荐5 推荐7 推荐9 推荐11 推荐13 推荐15 推荐17 推荐19 推荐21 推荐23 推荐25 推荐27 推荐29 推荐31 推荐33 推荐35 推荐37 推荐39 推荐41 推荐43 推荐45 推荐47 推荐49 关键词1 关键词101 关键词201 关键词301 关键词401 关键词501 关键词601 关键词701 关键词801 关键词901 关键词1001 关键词1101 关键词1201 关键词1301 关键词1401 关键词1501 关键词1601 关键词1701 关键词1801 关键词1901 视频扩展1 视频扩展6 视频扩展11 视频扩展16 文章1 文章201 文章401 文章601 文章801 文章1001 资讯1 资讯501 资讯1001 资讯1501 标签1 标签501 标签1001 关键词1 关键词501 关键词1001 关键词1501 专题2001
百度小程序自定义通用toast组件
2020-11-27 21:53:42 责编:小采
文档


需求

手百小程序的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="https://www.gxlcms.com/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~

    BdToast百度小程序自定义通用组件-github地址

    下载本文
    显示全文
    专题