欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

微信小程序----自定义组件

程序员文章站 2022-03-11 11:06:25
...

微信小程序充分借鉴了vue的代码风格,但是却没有像vue那样的高效的组件特性。但是这一备受诟病的地方在小程序1.6.3版本得到了解决。

从小程序基础库版本 1.6.3 开始,小程序支持简洁的组件化编程。所有自定义组件相关特性都需要基础库版本 1.6.3 或更高。

接下来,是我参考小程序官方API总结的自定义组件的使用方法:

第一步:新建一个组件

微信开发者工具提供了组件的模板。点击“Component”,开发工具会为我们生成一个纯净的组件模板。
微信小程序----自定义组件

例如我们新建一个select的组件:

select.json

{
  "component": true,        // 自定义组件声明
  "usingComponents": {}     // 可选项,用于引用别的组件

}

select.wxml

<!--component/Select/select.wxml-->
<view class='select-modal' hidden="{{!isShow}}">
  <radio-group class="radio-group" bindchange="selectChange">
    <view wx:for-items="{{selectList}}" wx:key="name" >
        <label class="radio" class='lla'>
          <radio value="{{item.name}}" checked="{{item.checked}}"/>{{item.value}}
        </label>

    </view>
  </radio-group>
</view>

select.wxss

/* component/Select/select.wxss */
.select-modal{
  position: fixed;
  z-index: 100;
  left: 0;
  top:0;
  right: 0;
  bottom: 0;
  background:olive;

}
.lla{
 display: block;
 width: 100vw;
 height: 30px;
}

select.js

// component/Select/select.js
Component({
  /**
   * 组件的属性列表
   */
  properties: {
    selectList:{
      type: Array,     // 类型(必填),目前接受的类型包括:String, Number, Boolean, Object, Array, null(表示任意类型)
      value: [],     // 属性初始值(可选),如果未指定则会根据类型选择一个
      observer: function (newVal, oldVal, changedPath) {
        // 属性被改变时执行的函数(可选),也可以写成在methods段中定义的方法名字符串, 如:'_propertyChange'
        // 通常 newVal 就是新设置的数据, oldVal 是旧数据
        console.log(newVal + "----------" + oldVal);
      }
    }
  },

  /**
   * 组件的初始数据
   */
  data: {
   isShow:false
  },

  /**
   * 组件的方法列表
   */
  methods: {
    //隐藏弹框
    hideSelect() {
      this.setData({
        isShow: !this.data.isShow
      })
    },
    //展示弹框
    showSelect() {
      this.setData({
        isShow: !this.data.isShow
      })
    },
    selectChange:function(e){
      // console.log(e)
      this.triggerEvent("selectChange",e)
    },

  }
})

第二步:引入要使用的组件

不同于vue中自定义组件的使用,在小程序里引入组件是在页面的json文件中

在具体页面的json中:

{
  "usingComponents": {
    "select": "/component/Select/select"
  }
}

第三步:使用该组件

首先是在wxml中使用该组件:

<select id="areaS1"   selectList="{{areaList}}" bind:selectChange="_selectChange1" >{{s2Text}}</select>
<select id="areaS2"   selectList="{{areaList2}}" bind:selectChange="_selectChange2" ></select>

js部分:

// pages/home/home.js

Page({

  /**
   * 页面的初始数据
   */
  data: {
    s1Text:""

  },

  /**
   * 生命周期函数--监听页面加载
   */
  onLoad: function (options) {

  },

  /**
   * 生命周期函数--监听页面初次渲染完成
   */
  onReady: function () {
    this.select1 = this.selectComponent("#areaS1");
    this.select2 = this.selectComponent("#areaS2");
  },

  /**
   * 生命周期函数--监听页面显示
   */
  onShow: function () {

  },

  /**
   * 生命周期函数--监听页面隐藏
   */
  onHide: function () {

  },

  /**
   * 生命周期函数--监听页面卸载
   */
  onUnload: function () {

  },

  /**
   * 页面相关事件处理函数--监听用户下拉动作
   */
  onPullDownRefresh: function () {

  },

  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom: function () {

  },

  /**
   * 用户点击右上角分享
   */
  onShareAppMessage: function () {

  },
  s1Tap:function(){
    this.setData({
      "areaList": [{ name: 'USA', value: '美国' },
      { name: 'CHN', value: '中国', checked: 'true' },
      { name: 'BRA', value: '巴西' },
      { name: 'JPN', value: '日本' },
      { name: 'ENG', value: '英国' },
      { name: 'TUR', value: '法国' },]
    });
    this.select1.showSelect();
  },
  s2Tap: function () {
    this.setData({
      "areaList2": [{ name: '郑州', value: '郑州' },
        { name: '开封', value: '开封', checked: 'true' },
        { name: '洛阳', value: '洛阳' },]
    });
    this.select2.showSelect();
  },
  _selectChange1:function(e){
    console.log(e.detail.detail.value);
    var _cur = e.detail.detail.value;
    this.setData({
      "s1Text": _cur
    })
    this.select1.hideSelect();
  },
   _selectChange2: function (e) {
     var _cur = e.detail.detail.value;
     this.setData({
       "s2Text": _cur
     })
    this.select2.hideSelect();
  }
})

以上就是小程序中自定义组件的使用方法。

相关标签: 自定义组件