摘要：小程序自定義組件開發(fā)規(guī)范一個小程序組件由個文件組成，分別是，本規(guī)范只關(guān)注組件的，其它自行查看官方文檔。的變量可以分為以下種類型組件外部通過組件屬性的方式傳入內(nèi)部的數(shù)據(jù)。

? 一個小程序組件由4個文件組成，分別是wxml、wxss、json、js，本規(guī)范只關(guān)注組件的js，其它自行查看官方文檔。

? 在自定義組件的 js 文件中，需要使用 Component() 來注冊組件，Component是一個構(gòu)造器，可用于定義組件，調(diào)用Component構(gòu)造器時可以指定組件的屬性、數(shù)據(jù)、方法等。

Component的變量可以分為以下2種類型：

properties：組件外部通過組件屬性的方式傳入內(nèi)部的數(shù)據(jù)。

可用于wxml渲染

不能做會修改數(shù)據(jù)的運算操作，如果必須要修改數(shù)據(jù)，可以先把數(shù)據(jù)賦值給組件的data，例如：this.data.a = this.properties.a，再去做運算操作，有以下兩種情況：

如果this.properties.a的數(shù)據(jù)是基本數(shù)據(jù)類型，則直接賦值

如果this.properties.a的數(shù)據(jù)是引用數(shù)據(jù)類型，則需要深拷貝一個新的數(shù)據(jù)之后，再賦值

data：組件內(nèi)部聲明的數(shù)據(jù)

主要用于wxml渲染

可以做任何的運算符操作

Component的函數(shù)可以分為以下幾種類型：

life-cycle-function：組件生命周期函數(shù)

event-function：在組件的methods下自定義的事件響應(yīng)函數(shù)，與wxml的事件綁定一一對應(yīng)

commen-function：在組件的methods下自定義的公共函數(shù)，供life-cycle-function與event-function調(diào)用

request-function：在組件的methods下自定義的異步請求數(shù)據(jù)的函數(shù)

在實際的代碼中，我們利用注釋把變量和函數(shù)分為以上定義的幾種類型。

下面以小程序的語音消息組件為例：

文件路徑：components/voice-message

import { isCorrectVal } from "../../utils/index";

const app = getApp();

Component({
    properties: {
        // work:作業(yè)的語音 comment:評論的語音
        type: {
            type: String,
            value: "work"
        },
        // 語音的地址
        voiceUrl: {
            type: String,
            value: ""
        },
        // 音頻的長度
        voiceLength: {
            type: Number,
            value: 0
        }
    },
    data: {
        unsubscribe: function() {},
        model: {
            loading: false,
            render: false,
            id: 0,
            voiceLength: 0,
            innerAudioContext: null,
            playing: false,
            trumpetStatus: [false, false, true],
            btnLength: "0"
        }
    },

    /**
     * life-cycle-function
     * @description 初始化組件
    */
    attached: function() {
        this.data.unsubscribe = app.soundScheduler.subscribe(
            "beforePlay",
            () => {
                this.data.model.innerAudioContext.stop();
            }
        );
        if (!isCorrectVal(this.properties.voiceUrl)) {
            throw new Error("音頻地址錯誤");
        }

        /* 計算音頻按鈕長度 */
        let base = 40; // 10s內(nèi)基礎(chǔ)長度
        let step = 20; // 每10s增加的長度
        let stepNum = 0;
        let length = 40; // 按鈕初始長度
        if (this.properties.type === "comment") {
            base = 30;
            step = 15;
            length = 30;
        }
        if (this.properties.voiceLength > 10) {
            stepNum = Math.ceil((this.properties.voiceLength - 10) / 10);
        }
        length = base + step * stepNum;
        this.setData({
            "model.btnLength": length,
            "model.voiceLength":
                this.properties.voiceLength >= 2
                    ? this.properties.voiceLength
                    : 2
        });

        this.data.model.innerAudioContext = wx.createInnerAudioContext();
        this.data.model.innerAudioContext.obeyMuteSwitch = false;
        this.data.model.innerAudioContext.src = this.properties.voiceUrl;
        this.data.model.innerAudioContext.onPlay(() => {
            this.onPlay();
        });
        this.data.model.innerAudioContext.onStop(res => {
            this.onStop();
        });
        this.data.model.innerAudioContext.onEnded(res => {
            this.onStop();
        });
        this.data.model.innerAudioContext.onError(res => {
            this.onError(res);
        });
    },

    methods: {
        /**
         * event-function
         * @description 切換音頻播放狀態(tài)（播放/停止）
        */
        togglePlay: function() {
            if (this.data.model.loading) return;
            if (this.data.model.playing) {
                this.data.model.innerAudioContext.stop();
            } else {
                this.setData(
                    {
                        "model.loading": true
                    },
                    () => {
                        app.soundScheduler.dispatch("beforePlay");
                        app.videoContext.pause();
                        this.data.model.innerAudioContext.play();
                        setTimeout(() => {
                            if (this.data.model.loading) {
                                this.setData({
                                    "model.loading": false
                                });
                            }
                        }, 3000);
                    }
                );
            }
        },

        /**
         * common-function
         * @description 音頻開始播放觸發(fā)時的處理函數(shù)
        */
        onPlay: function() {
            this.setData(
                {
                    "model.loading": false
                },
                () => {
                    this.running();
                }
            );
        },

        /**
         * common-function
         * @description 音頻停止播放或者播放結(jié)束時的處理函數(shù)
        */
        onStop: function() {
            this.stop();
        },

        /**
         * common-function
         * @description 音頻播放錯誤時的處理函數(shù)
        */
        onError: function(res) {
            console.log(res);
            this.setData(
                {
                    "model.loading": false
                },
                () => {
                    this.stop();
                }
            );
        },

        /**
         * common-function
         * @description 啟動音頻小喇叭動畫
         */
        running: function() {
            let vm = this;

            vm.data.model.playing = true;

            let num = 1;
            let idx = 1;
            let timer = null;
            function animation() {
                if (!vm.data.model.playing) {
                    clearTimeout(timer);
                    vm.setData({
                        "model.trumpetStatus": [false, false, true]
                    });
                    return;
                }

                switch (idx) {
                    case 1:
                        vm.setData({
                            "model.trumpetStatus": [true, false, false]
                        });
                        break;
                    case 2:
                        vm.setData({
                            "model.trumpetStatus": [false, true, false]
                        });
                        break;
                    case 3:
                        vm.setData({
                            "model.trumpetStatus": [false, false, true]
                        });
                        break;
                }
                ++idx;
                if (idx === 4) {
                    idx = 1;
                }

                ++num;
                timer = setTimeout(animation, 600);
            }
            timer = setTimeout(animation, 600);
        },

        /**
         * common-function
         * @description 停止音頻小喇叭動畫
         */
        stop: function() {
            this.data.model.playing = false;
        }
    }，
    
    /**
     * life-cycle-function
     * @description 卸載組件
     */
    detached: function() {
        this.data.model.innerAudioContext.stop();
        this.data.unsubscribe();
    },
});

如果你已經(jīng)看完了代碼，那么對這個組件的 代碼執(zhí)行過程 是否心里已經(jīng)有數(shù)？
這個組件的代碼執(zhí)行過程是這樣的：

1. 在生命周期鉤子函數(shù)attached中初始化組件
2. 組件掛載并渲染完成，到達(dá)可響應(yīng)用戶操作的狀態(tài)（這個步驟由小程序自動執(zhí)行，無需寫額外的代碼）
3. 響應(yīng)用戶操作
    - 用戶點擊語音消息，如果語音沒在播放，則播放語音
    - 用戶點擊語音消息，如果語音正在播放，則停止播放
4. 卸載組件

如果心里還沒數(shù)，那把除了life-cycle-function和events-function的之外的代碼都忽略掉，再看看組件生命周期鉤子函數(shù)和用戶交互事件響應(yīng)函數(shù)的代碼與注釋呢？