微信小程序自定义组件(Toast)
微信官方的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目录,如图:
image2、在appToast.wxml文件中新建一个template(自定义组件模块),代码如图所示:
image3.关于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自定义组件实现的效果:
效果图