微信小程序自定义组件(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构造器 

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自定义组件实现的效果:

效果图

demo下载地址https://github.com/dt8888/component

展开阅读全文

没有更多推荐了,返回首页