微信小程序入坑之自定義組件

前言

• 最近接觸微信小程序，再次以前公司用的前端框架是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）的功能，在業務複雜的項目中，大大提升代碼的可複用 性和可維護性。
• 公司小程序只有我一我的開發，不存在多人協做開發小程序的狀況，在這方面下的功夫很少。

歡迎體驗

• 小程序線上版本

• 點我加羣討論