仿照微信小程序提供的 showToast 功能(小程序视觉一致的增强插件)

  • 时间:
  • 来源: 网络

WeToastfor微信小程序toast增强插件

概述

WeToast是仿照微信小程序提供的功能,提供视觉一致的增强插件,弥补小程序功能上的不足(如只能显示、两种icon,且icon不可去除,持续时间最大10秒等)。

预览

下载WeToast项目,用微信web开发者工具打开项目根目录

如何使用

WeTaost插件源码位于目录下,包含3个文件。

wetoast.js:脚本代码

wetoast.wxml:模板结构

wetoast.wxss:样式

使用时只需要加入以上3个文件即可,使用方法可参考本项目示范。

推荐方案

Step1、在项目的中引入,并注册到小程序上,小程序所有Page页面均可使用,无需再次引入

Step2、在项目的中引入

Step3、引入WeToast模板结构,

方式一,在单独页面使用

方式二,创建公用包含文件,将所有公用模板放在一起

然后通过引入

API

WeToast()

构造函数,返回WeToast实例对象,该操作会在当前Page上创建一个名为的引用,在Page中可通过访问。通常在Page的中调用,可重复使用。

示例

WeToast.prototype.toast(Object)

控制toast的显示、隐藏,接收一个可选的对象作为配置参数。不提供参数时,表示隐藏toast。

Object参数说明:

可选表示至少设置或中的一个

img参数补充说明

提示的图片设置尺寸为55px*55px,建议使用原始大小为110px*110px的图片。使用图片时,优先选择base64形式,保证实时显示。

title参数补充说明

提示框的宽度设置了最小宽度为8.4em,最大宽度为屏幕的70%,超过时会换行。

duration参数补充说明

当设置为时,将不自动隐藏提示层,直到下次再次调用,不传入配置项表示隐藏提示。

回调函数参数补充说明:

、、执行时均会回传配置参数。无论成功或失败,都会执行。

示例

问答

问:个人开发者怎么体验小程序?

答:可参考此文个人开发者体验小程序的方法。原理很简单,只要能扫码进入微信web开发者工具,就能创建小程序项目,所以问题变为如何成为开发者。

个人成为开发者最简单的方式就是申请微信订阅号,完成后即可进入开发者工具。

问:为什么做这个插件?

答:微信小程序提供的API目前仅支持显示、两种图标,不够用,且在某些场景下,最大值10秒也不够用。

在官方未提供更丰富配置的情况下,有必要在官方UI规范的框架下提供一套功能更实用的备选方案。

同时我也希望各开发者能够达成共识,在实现自身需求时,尽量以官方UI规范为指导,避免出现各种花样的弹层效果。

问:是否会出现“串页”问题?

答:此处“串页”是指上一页的代码在当前页执行。在navigate跳转的情况下,由于页面不是被关闭,因此代码还在执行,一些涉及全局的操作会被带入当前页。

在开发本插件的时候,充分考虑了这一点,采用实例化toast对象并附加到当前的Page对象上,在切换Page后仍然指向上一页的Page对象,不会出现“串页”问题。

TODO

增加预定义ICON

增加可自定义动画功能

更多小程序开发教程入门关注Hi小程序。

价值1980元火爆的0基础小程序制作开发赚钱训练营免费看