WePY组件

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

普通组件引用

当页面需要引入组件，或组件需要引入子组件时，必须在.wpy文件的<script>部分先import组件文件，然后在components对象中给组件声明唯一的组件ID；接着在<template>模板部分中，添加以组件ID进行命名的自定义标签，以插入组件。

<template>
    <!-- 以`<script>`脚本部分中所声明的组件ID为名命名自定义标签，从而在`<template>`模板部分中插入组件 -->
    <child></child>
</template>

<script>
    import wepy from 'wepy';
    import Child from '../components/child';    // 引入组件文件

    export default class Index extends wepy.component {
        
        components = {
            child: Child    //  声明组件，分配组件id为child
        };
    }
</script>

组件ID

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

<template>
    <view class="child1">
        <child></child>
    </view>

    <view class="child2">
        <anotherchild></anotherchild>
    </view>
</template>


<script>
    import wepy from 'wepy';
    import Child from '../components/child';

    export default class Index extends wepy.component {
        components = {
            //为两个相同组件的不同实例分配不同的组件ID，从而避免数据同步变化的问题
            child: Child,
            anotherchild: Child
        };
    }
</script>

组件的循环渲染

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

<template>
    <!-- 注意，使用for属性，而不是使用wx:for属性 -->
    <repeat for="{{list}}" key="index" index="index" item="item">
        <!-- 插入<script>脚本部分所声明的child组件，同时传入item -->
        <child :item="item"></child>
    </repeat>
</template>

<script>
    import wepy from 'wepy';
    import Child from '../components/child';    // 引入child组件文件

    export default class Index extends wepy.component {
        components = {
            child: Child
        }

        data = {
            list: [{id: 1, title: 'title1'}, {id: 2, title: 'title2'}]
        }
    }
</script>

组件的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 title="mytitle"></childCom >

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

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

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

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

// parent.wpy

<child :title="parentTitle" :syncTitle.sync="parentTitle" :twoWayTitle="parentTitle"></child>

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

<template>
    <child @childFn.user="parentFn"></child>
</template>

<script>
    import wepy from 'wepy'
    import Child from '../components/child'

    export default class Index extends wepy.page {
        components = {
            child: Child
        }

        methods = {
            parentFn (num, evt) {
                console.log('parent received emit event, number is: ' + num)
            }
        }
    }
</script>

// child.wpy

<template>
    <view @tap="tap">Click me</view>
</template>

<script>
    import wepy from 'wepy'

    export default class Child extends wepy.component {
        methods = {
            tap () {
                console.log('child is clicked')
                this.$emit('childFn', 100)
            }
        }
    }
</script>

slot 组件内容分发插槽