微信小程序入坑之自定义组件

前言

• 最近接触微信小程序，再次以前公司用的前端框架是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;
}

使用方法

• 一、wxml引用页面模板
  
  
• 二、js 文件引用 toast.js

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

• 三、调用

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

改进及更多扩展

• 实际项目中会有toast confirm loading ···等多个通用组件 ，还有大量的业务组件，咱们能够把js都引入到一个js文件中，而后在页面加载的时候（onLoad方法）中注册this(page)，这样只须要注册一次即可以使用全部的组件，如

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

变成

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

• 一样的思路，咱们能够实现相似vue中混合（mixin）的功能，在业务复杂的项目中，大大提升代码的可复用 性和可维护性。
• 公司小程序只有我一我的开发，不存在多人协做开发小程序的状况，在这方面下的功夫很少。

欢迎体验

• 小程序线上版本

• 点我加群讨论