微信小程序自定义组件（Toast）

最新推荐文章于 2025-06-24 16:12:44 发布

原创最新推荐文章于 2025-06-24 16:12:44 发布 · 2.3k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#自定义组件 #let _compData = { '_toast_.i

小程序专栏收录该内容

26 篇文章

订阅专栏

本文介绍了一种在微信小程序中创建自定义Toast组件的方法，详细解释了组件的构造原理及其实现步骤，包括组件模版、样式编写以及全局引用的具体操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

微信官方的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中将组件脚本引入供全局使用，引入方法：接收暴露出来的构造函数如图：