微信官方的wx.showToast这个API用起来限制性太强,在正式项目上根本用不上,但是又没有其他组件或API可以替代,所以就自己通过网上大神的方法自己写了一个自定义的toast组件。
一,自定义组件
1.组件模版和样式
类似于页面,自定义组件拥有自己的 wxml 模版和 wxss 样式。组件模版的写法与页面模板相同。组件模版与组件数据结合后生成的节点树,将被插入到组件的引用位置上。在组件模板中可以提供一个 节点,用于承载组件引用时提供的子节点。
image
组件对应 wxss 文件的样式,只对组件wxml内的节点生效。编写组件样式时,需要注意以下几点:
a.组件和引用组件的页面不能使用id选择器(#a)、属性选择器([a])和标签名选择器,请改用class选择器。
b. 组件和引用组件的页面中使用后代选择器(.a .b)在一些极端情况下会有非预期的表现,如遇,请避免使用。
c.子元素选择器(.a>.b)只能用于 view 组件与其子节点之间,用于其他组件可能导致非预期的情况。
d.继承样式,如 font 、 color ,会从组件外继承到组件内。
除继承样式外, app.wxss 中的样式、组件所在页面的的样式对自定义组件无效。
Component像页面一样由wxml、wxss、js和json4个文件组成,且需要把这4个文件放在同一个目录中。与页面不一样的是,Component中的构造函数(也可以称构造器)是Component({}),而页面中的构造函数是Page({})。
image
三.如何使用自定义组件全局自定义(Toast)
1、在component目录中新建一个appToast目录,如图:
image
2、在appToast.wxml文件中新建一个template(自定义组件模块),代码如图所示:
image
3.关于appToast.wxss代码如下(根据自己需要做修改):
.toast_content_box { display: flex; width: 100%; height: 100%; justify-content: center; align-items: center; position: fixed; z-index: 999; } .toast_content { width: 50%; padding: 30rpx; background: rgba(0, 0, 0, 0.8); border-radius: 20rpx; } .toast_content_text { height: 100%; width: 100%; color: #fff; font-size: 28rpx; text-align: center; }
4、toastTest.js的代码如下:
let _compData = { '_toast_.isHide': false,// 控制组件显示隐藏 '_toast_.content': ''// 显示的内容}let toastPannel = { // toast显示的方法 show: function (data) { let self = this; this.setData({ '_toast_.isHide': true, '_toast_.content': data }); setTimeout(function () { self.setData({ '_toast_.isHide': false })//自定义方法,根据编辑需求 }, 2000) } }function ToastPannel() {//构造方法关联了当前页的方法及相关代码 // 拿到当前页面对象 let pages = getCurrentPages(); let curPage = pages[pages.length - 1]; this.__page = curPage; // 小程序最新版把原型链干掉了。。。换种写法 Object.assign(curPage, toastPannel); // 附加到page上,方便访问 curPage.toastPannel = this; // 把组件的数据合并到页面的data对象中 curPage.setData(_compData); return this; }module.exports = { ToastPannel }
在_comData中你可以添加你想展示的内容,如:title、pic等都可以往里面塞,只是你要在样式表中做相应的样式处理即可;toastPannel对象中是包含了一些自定义的方法,如我的代码中有切换组件显示隐藏的开关和接收到的显示内容;ToastPannel是一个构造函数,在这里需要通过官方给出的getCurrentPages()方法获取到要使用组件的当前页,并且将该组件的data和相应的方法附加到当前页面中,方便当前页访问;最后将该组件的构造函数暴露出来,让其他页面可以直接引用。
6、全局引用,在项目中的app.js中将组件脚本引入供全局使用,引入方法:接收暴露出来的构造函数如图:
app.js中添加
7.在项目中app.wxss的全局引入组件的样式表如图:
app.wxss中添加
8、在需要使用该组件的页面将模块引入,如我在目录中的toast.wxml文件中引入组件的模块:
9、在当前页面的js文件中实例组件的构造函数,如我的toast.js文件中实例代码:
onLoad方法中添加
使用方法
10、toast自定义组件实现的效果:
效果图
作者:honey缘木鱼
链接:https://www.jianshu.com/p/d5ca7a984756