微信小程序自定义组件

发布时间 - 2026-01-11 02:49:16    点击率:

前言

最近接触微信小程序,再次之前公司用的前端框架是vue ,然后对比发现,开发小程序是各种限制,对于开发者非常不友好。各种槽点太多,完全吐槽不过来,所以在此不多说,打算下次专门写一篇文章吐槽一下。本次主要分享下小程序自定义组件的一点思路,小程序官方提供的框架比较简陋,原始,可复用较差,没有实现自定义组件的功能,这让很多使用vue ,react前端开发非常难受。网上存在各种吐槽,也有分享实现自定义组件的方法,但是要么过于复杂,要么是微信小程序升级之后就不兼容,反正是各种坑你没商量。在这分享下本人在项目中是如何实现的,欢迎指正批评,互相学习。

toast自定义组件实现

  • 这里用最简单的toast组件为例子
  • 官方框架只提供了 页面模板功能 : WXML提供模板(template),可以在模板中定义代码片段,然后在不同的地方调用。
  • 但是这个功能不 支持js,样式封装,需要在对应的页面做处理,且模板还有自己的作用域,需要使用data传入。
  • 把功能封装成独立的组件,需要和页面独立,在使用时将组件挂载到对应的页面,所以组件需要传入页面this(Page)对象 ,实现代码如下

目录结构

|------components
        |------toast
                |------toast.js
                |------toast.wxml
                |------toast.wxss

代码

toast.wxml

<template name='toast'>
  <view class="s-toast" wx:if="{{msg}}">
    <view class="s-toast-content">{{msg}}</view>
  </view>
</template>

toast.js

/**
 * toastMsg 必传 提示内容
 * showTime 非必传 显示时间秒
*/
function toast(page, toastMsg, showTime) {
  let timer
  page.setData({ toastMsg })
  showTime = showTime || toastMsg.length / 4
  console.log(showTime)
  clearTimeout(timer)
  timer = setTimeout(() => {
    page.setData({ toastMsg: '' })
    clearTimeout(timer)
  }, showTime * 1000)
}

module.exports = {
  toast: toast,
}
toast.wxss
.s-toast-content {
  position: fixed;
  left: 50%;
  color: #fff;
  width: 500rpx;
  bottom: 120rpx;
  background: hsla(0,0%,7%,.7);
  padding: 15rpx;
  text-align: center;
  -webkit-transform: translateX(-50%);
  transform: translateX(-50%);
  border-radius: 4rpx;
  z-index: 6999;
}


使用方法

1、wxml引用页面模板

2、js 文件引用 toast.js

import { toast } from '../../../project/component/toast/toast.js'

3、调用

toast(this, '填写详细信息')

改进及更多扩展

实际项目中会有toast confirm loading ···等多个通用组件 ,还有大量的业务组件,我们可以把js都引入到一个js文件中,然后在页面加载的时候(onLoad方法)中注册this(page),这样只需要注册一次便可以使用所有的组件,如

toast(this,'填写详细信息'')

变成

toast('填写详细信息'')

同样的思路,我们可以实现类似vue中混合(mixin)的功能,在业务复杂的项目中,大大提高代码的可复用 性和可维护性。

公司小程序只有我一个人开发,不存在多人协作开发小程序的情况,在这方面下的功夫不多。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# 微信小程序  # 自定义组件  # 微信小程序动态的显示或隐藏控件的方法(两种方法)  # 微信小程序点击控件修改样式实例详解  # 微信小程序 实现动态显示和隐藏某个控件  # 微信小程序 点击控件后选中其它反选实例详解  # 微信小程序 input输入框控件详解及实例(多种示例)  # 微信小程序 视图容器组件的详解及实例代码  # 微信小程序 自己制作小组件实例详解  # 微信小程序 基础组件与导航组件详细介绍  # 微信小程序实现动态显示和隐藏某个控件功能示例  # 自定义  # 在这  # 自己的  # 复用  # 也有  # 会有  # 太多  # 多个  # 在此  # 就不  # 不多  # 我们可以  # 便可  # 不存在  # 只需要  # 你没  # 可以实现  # 多说  # 只提供  # 最简单 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel如何获取当前用户信息_Laravel Auth门面获取用户ID  Win11搜索栏无法输入_解决Win11开始菜单搜索没反应问题【技巧】  php结合redis实现高并发下的抢购、秒杀功能的实例  零基础网站服务器架设实战:轻量应用与域名解析配置指南  如何快速生成凡客建站的专业级图册?  韩国代理服务器如何选?解析IP设置技巧与跨境访问优化指南  如何在搬瓦工VPS快速搭建网站?  Laravel怎么使用Collection集合方法_Laravel数组操作高级函数pluck与map【手册】  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  Linux系统命令中tree命令详解  Windows Hello人脸识别突然无法使用  Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】  javascript和jQuery中的AJAX技术详解【包含AJAX各种跨域技术】  如何在新浪SAE免费搭建个人博客?  如何用景安虚拟主机手机版绑定域名建站?  矢量图网站制作软件,用千图网的一张矢量图做公司app首页,该网站并未说明版权等问题,这样做算不算侵权?应该如何解决?  如何获取免费开源的自助建站系统源码?  如何正确选择百度移动适配建站域名?  深圳网站制作设计招聘,关于服装设计的流行趋势,哪里的资料比较全面?  家族网站制作贴纸教程视频,用豆子做粘帖画怎么制作?  如何在IIS管理器中快速创建并配置网站?  如何用y主机助手快速搭建网站?  制作企业网站建设方案,怎样建设一个公司网站?  MySQL查询结果复制到新表的方法(更新、插入)  Laravel如何记录日志_Laravel Logging系统配置与自定义日志通道  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  详解Android中Activity的四大启动模式实验简述  jQuery中的100个技巧汇总  php8.4header发送头信息失败怎么办_php8.4header函数问题解决【解答】  html5如何实现懒加载图片_ intersectionobserver api用法【教程】  怎么用AI帮你设计一套个性化的手机App图标?  HTML5段落标签p和br怎么选_文本排版常用标签对比【解答】  Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】  如何撰写建站申请书?关键要点有哪些?  如何生成腾讯云建站专用兑换码?  ,怎么在广州志愿者网站注册?  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办?  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解  Laravel怎么实现微信登录_Laravel Socialite第三方登录集成  Laravel如何处理文件上传_Laravel Storage门面实现文件存储与管理  Laravel如何实现API资源集合?(Resource Collection教程)  如何彻底卸载建站之星软件?  php嵌入式断网后怎么恢复_php检测网络重连并恢复硬件控制【操作】  如何为不同团队 ID 动态生成多个独立按钮  Python企业级消息系统教程_KafkaRabbitMQ高并发应用  node.js报错:Cannot find module &#39;ejs&#39;的解决办法  详解Android——蓝牙技术 带你实现终端间数据传输  Laravel项目怎么部署到Linux_Laravel Nginx配置详解  Laravel如何清理系统缓存命令_Laravel清除路由配置及视图缓存的方法【总结】  nodejs redis 发布订阅机制封装实现方法及实例代码