WePY组件

原生小程序支持js模块化，但彼此独立，业务代码与交互事件仍需在页面处理。无法实现组件化的松耦合与复用的效果。
在WePY中实现了小程序的组件化开发，组件的所有业务与功能在组件本身实现，组件与组件之间彼此隔离。

普通组件引用

当页面需要引入组件，或组件需要引入子组件时，必须在.wpy文件的

组件ID

WePY中的组件都是静态组件，是以组件ID作为唯一标识的，每一个ID都对应一个组件实例。当页面引入两个相同ID的组件时，这两个组件共用同一个实例与数据，当其中一个组件数据变化时，另外一个也会一起变化。
如需避免这个问题，则需要分配多个组件ID和实例。代码如下：

组件的循环渲染

当需要循环渲染WePY组件时，须使用WePY定义的辅助标签，示例如下：

组件的computed属性

computed计算属性，是一个有返回值的函数，可直接被当作绑定数据来使用。类似于data属性。示例如下：

  data = {
      aaa: 1
  }

  // 计算属性aPlus，在脚本中可通过this.aPlus来引用，在模板中可通过{{ aPlus }}来插值
  computed = {
      aPlus () {
          return this.aaa + 1
      }
  }

watcher监听器

通过监听器watcher，能够监听到任何属性的更新。监听器在watch对象中声明，类型为函数，函数名与需要被监听的data对象中的属性同名，每当被监听的属性改变一次，监听器函数就会被自动调用执行一次。

监听器适用于当属性改变时需要进行某些额外处理的情形。

示例：

  data = {
      num: 1
  }

  // 监听器中的监听函数名，必须与其对应的属性名一样
  // 参数newValue为属性改变后的新值，oldValue为改变前的旧值
  watch = {
      num (newValue, oldValue) {
          console.log(`num value: ${oldValue} -> ${newValue}`)
      }
  }

props传值

在WePY中属于父子组件之间传值的一种机制，包括静态传值与动态传值。

1、静态传值
父组件向子组件传递常量数据，只能传递String。
做法：在父组件template模板部分的组件标签中，使用子组件props对象中所声明的属性名，作为其属性名来接收父组件传递的值。
示例：

//* 父组件 template模板部分


//*子组件 childCom.wpy中
props = {
    title: String
};

onLoad () {
    console.log(this.title); // 输出 “mytitle”
}

2、动态传值
指父组件向子组件传递动态数据内容，父子组件数据完全独立互不干扰。

-可以通过.sync修饰符，来达到父组件数据绑定至子组件的效果；
-也可以通过设置子组件props的twoWay: true，来达到子组件数据绑定至父组件的效果；
-如果既使用.sync修饰符，同时子组件props中添加的twoWay: true时，就可以实现数据的双向绑定了。
-在父组件template模板部分所插入的子组件标签中，使用:prop属性，来进行动态传值。

// parent.wpy



data = {
    parentTitle: 'p-title'
};


// child.wpy

props = {
    // 静态传值
    title: String,

    // 父向子单向动态传值
    syncTitle: {
        type: String,
        default: 'null'
    },

    twoWayTitle: {
        type: Number,
        default: 'nothing',
        twoWay: true
    }
};

组件通信与交互

wepy.component基类提供$broadcast、$emit、$invoke三个方法，用于组件之间的通信和交互。有关的事件处理函数，需要写在组件和页面的events对象中声明。

$broadcast
事件是由父组件发起，所有子组件都会收到此广播事件，除非事件被手动取消。

$emit
由某个子组件发起，其所有祖先组件会依次接收到$emit事件。

示例
this.$emit('some-event', 1, 2, 3, 4);

import wepy from 'wepy'

export default class Com extends wepy.component {
    components = {};

    data = {};

    //  声明
    events = {
        'some-event': (p1, p2, p3, $event) => {
               console.log(`${this.$name} receive ${$event.name} from ${$event.source.$name}`);
        }
    };
    // Other properties
}

$invoke
是一个页面或组件，直接调用另一个组件的方法。通过传入组件路径找到相应的组件，然后再调用其方法。

比如：
-想在页面Page_Index中，调用组件ComA的某个方法：
this.$invoke('ComA', 'someMethod', 'someArgs');
-想在组件ComA中，调用组件ComG的某个方法：
this.$invoke('./../ComB/ComG', 'someMethod', 'someArgs');

组件自定义自己的事件处理函数

使用.user修饰符，为自定义组件 绑定事件。

如：@customEvent.user="myFn"
其中，@表示事件修饰符，customEvent 表示事件名称，.user表示事件后缀。

示例:

// page.wpy

// child.wpy

slot 组件内容分发插槽

...

第三方组件

WePY允许使用基于WePY开发的第三方组件

相关资料

https://tencent.github.io/wepy/document.html#/?id=%e7%bb%84%e4%bb%b6