微信小程序中的组件使用1

不管是vue还是react中，都在强调组件思想，同样，在微信小程序中也是使用组件思想来实现页面复用的，下面就简单介绍一下微信小程序中的组件思想。

组件定义与使用

要使用组件，首先需要有组件页面和使用组件的页面，所以，先在pages文件夹下面新建classic页面，然后在项目根目录下新建component文件用于存放组件，并在该文件夹下面新建like组件：

  

这里建议在新建页面的时候，先新建存放页面的文件夹，然后编辑器中鼠标右击该文件夹，然后选择新建page。新建组件的时候，也是先新建存放组件的文件夹，然后鼠标右击该文件夹，选择新建组件，这样会默认生成一些必要的配置，而不用我们自己去添加。

定义组件

因为是按照上面说的方式新建组件的，里面已经有了相关的默认配置，现在主要是先将这个组件展示出来，所以先暂不做修改，生成的相关默认配置如下：

index.json

{
  "component": true,
  "usingComponents": {}
}

index.wxml

<!--components/like/index.wxml-->
<text>components/like/index.wxml</text>

使用组件

组件新建完成后，就是使用组件了，目前的例子呢，是在classic页面引用该组件，那么首先需要在classic.json页面引入该组件：

{
  "usingComponents": {
    "v-like":"../../components/like/index"
  }
}

上面的usingComponents接收的是一个JSON对象，每一个组件就是一个键值对，key是我们为组件定义的名称，这里的名称是可以自定义的（目录中的like只是一个目录，和组件名称没有太多的关系），value值是该组件的路径，可以是相对路径（"/components/like/index"），也可以是绝对路径（"../../components/like/index"）。

组件引入完成以后就是使用组件了，记住我们刚刚为组件定义的名称后，在classic.wxml中使用就可以了。

<v-like />

组件传值

继续修改上面的v-like组件，现在要实现的功能是，默认选中，则显示红色的图标；点击后取消选中，显示灰色图标，数字减一；再次点击又选中，显示红色图标，数字加一，先不考虑点击事件，我们可以这样做：

index.wxml

 <view class="container" >
  <image src="{{like?yes_url:no_url}}" />
   <text>{{count}}</text>
</view>

index.js

Component({
  properties: {},
  data: {
    yes_url: 'images/like.png',
    no_url: 'images/[e-mail]',
    like:true,
    count:88,
  },
  methods: {}
})

但是在实际运用过程中，count和like是由父组件在调用时传递进来的，所以，不能直接放在data里面，而是应该放在properties里面，需要注意的是，变量放在properties就变为了属性，是一个对象，这个对象有三个属性：type(类型，必填)、value（默认值，可选）、observer(属性被改变时执行的函数，可选)。所以需要对上面的index.js进行如下修改

index.js

Component({
  properties: {
    like:{
      type:Boolean,
      value:false,
    },
    count:{
      type:Number,
      value:0
    }
  },
  data: {
    yes_url: 'images/like.png',
    no_url: 'images/[e-mail]',
  },
  methods: {}
})

组件事件

上面说了，需要通过用户的触摸事件，来改变该组件里面元素的状态，所以，接下来先来完善上面的触摸事件

index.wxml

<view class="container" bind:tap="onLike">
  <image src="{{like?yes_url:no_url}}" />
   <text>{{count}}</text>
</view>

index.js

Component({
  properties: {
    like:{
      type:Boolean,
    },
    count:{
      type:Number,
    }
  },
  data: {
    yes_url: 'images/like.png',
    no_url: 'images/[e-mail]',
  },
  methods: {
    onLike(){
      let like = this.properties.like;
      let count = this.properties.count;
      count = like ? count-1 : count+1;
      this.setData({
        count:count,
        like:!like
      })
    }
  }
})

   

组件传参

在上面的组件中，我们在classic里面调用v-like组件的时候有说到，放在data里面的变量是组件自己的变量，然后放在properties里面的变量是由父组件传入的，在上面的例子中，由于组件里面对这两个变量设置了默认值，所以父组件里没有传入值得时候，也能正常显示，现在介绍如何进行组件传值。

classic.wxml

<v-like like="{{classic.like_status}}" count="{{classic.fav_nums}}"/>

classic.js

import {HTTP} from '../../util/http.js'
let http = new HTTP()

Page({
    data: {
        classic: {}
    },
    onLoad: function(options) {
        http.request({
            url: 'classic/latest',
            method: 'get',
            success: (res) => {
                this.setData({
                    classic: res
                })
                console.log(this.data.classic);
            }
        })
    },
})

组件事件激活与监听

在上面，我们给v-like组件添加了一个点击事件，这个事件写在like/index.js里面，但是在实际运用过程中，点赞和取消点赞是需要与后台进行数据交换的，如果将事件写在like/index.js里面的话，有一个问题，在不同的组件调用中，点赞和取消点赞请求的接口是不一样的，所以更好的做法是将数据请求放在调用的父组件里面，也就是说，我们需要在子组件中通过点击来激活这个事件，然后在父组件中监听这个事件：

like/index.js

Component({
  properties: {
    like:{
      type:Boolean,
    },
    count:{
      type:Number,
    }
  },
  data: {
    yes_url: 'images/like.png',
    no_url: 'images/[e-mail]',
  },
  methods: {
    onLike(){
      let like = this.properties.like;
      let count = this.properties.count;
      count = like ? count-1 : count+1;
      this.setData({
        count:count,
        like:!like
      })
      //判断是点赞还是取消点赞
        let behavior = this.properties.like?'like':'cancel'
        this.triggerEvent('like',{
            behavior: behavior
        },{})
    }
  }
})

事件激活使用triggerEvent，接收三个参数：自定义事件名称，需要传递的相关字段信息，触发事件（bubbles、composed、capturePhase）。这里我们将这事件命令为like，然后传递一个behavior字段用于判断是点赞还是取消点赞，接下来就需要在父组件中监听这个like事件了。

classic.wxml

classic.js

onLike(event){
    console.log(event);
    let like = event.detail.behavior;
    let url = like === 'cancel' ? 'like/cancel' : 'like'
    http.request({
        url: url,
        method: 'POST',
        data: {
            art_id: this.data.classic.fav_nums,
            type: this.data.classic.type
        },
        success: (res) => {
            console.log(res);
        }
    })
},

首先是打印event，可以看到，我们刚刚传递的字段信息放在detail里面，所以通过event.detail就可以获取我们传递相关信息了。