微信小程序自定义组件

ps 由于作业部落貌似出了点问题，耽误了点时间，找了一个stackedIT.io准备写。无奈，这是要自己建编辑器的节奏啊。没有一个能靠的注

为何存在组件

组件间的关系

使用relations实现组件的关系，即父子关系。

定义和使用组件间的关系

有时需要使用如下的组件间的关系

 <custom-ul> 
    <custom-li> item1 </ custom-li> 
    <custom-li> item2 </ custom-li> 
</ custom-ul> 

在上方中，
两个<custom-ul>以及<custom-li>两个组件都为自定义组件，如果进行通信会非常的难以操作，至此通过relations完成子父组件的定义，简化通信。
同样的以上方的栗子作为举例。

继续上一个栗子，新建一个页面，在新的页面中使用组件间的关系。

由于同属于一个custom大组件，所以直接在components中新建一个custom文件夹，表示一个大的新组件
由于其拥有一个子组件，所以再新建一个li文件夹，表示custom-li
目录如下

菜鸟一枚，设置的不一定正确。也不一定是最正统的，只是感觉。╮(╯▽╰)╭

设置custom/custom.js文件的relations的值

// components/custom/custom.js
Component({
  relations: {
    './li/li' : {
      type: 'child',  // 设置关联的目标节点为子节点
    }
  }
})

接着设置祖先节点，即设置custom/li/li.js文件的内容

// components/custom/li/li.js
Component({
  relations: {
    '../../custom': {
      type: 'parent'  // 应为祖先节点
    }
  }
})

设置组件的wXMl文件

<！ - 组件/自定义/立/ li.wxml  - >
< view > components / custom / li / li.wxml </ view > < slot />

<!--components/custom/custom.wxml-->
<view>components/custom/custom.wxml</view>
<slot/>

接着设置page页面的wxml页面

<!--pages/ming/ming.wxml-->
<text>hello world</text>
<custom-ul>
  <custom-li></custom-li>
  <custom-li></custom-li>
  <custom-li></custom-li>
  <custom-li></custom-li>
</custom-ul>

至此完成。

关联一类组件

被微信的路径折腾的不轻，好吧，无奈，决定重新写

微信路径

微信路径太坑了。
理所应当应该是

/ 根目录
../ 父级目录
./ 当前目录

结果非要

../../

至今也没搞清楚路径是这么回事。算了，决定在同一个目录下完成模块的问题，不在另外的分一个模块的文件夹了。

总说

要形成的在Page下的结构如下

<custom-form>
    <view>
        input
        <custom-input></custom-input>
    </view>
    <custom-submit>shubmit</custom-submit>
</custom-form>

创建目录

创建目录如下

好啦，目录如上

这一次放弃将模块放在另外一个文件夹，这一场所有的和组件相关的内容都放在同一个文件夹下 。符合组件的精神

其中form表明该为一个form的组件。module表明组件的内容，其中module下还有一个behaviors表明是behaviors的内容的模块，input和submit表明是其子组件。

behaviors

书写behaviors的内容。

// components/form/module/behaviors/controls

module.exports = Behavior({

// ...

})

父组件

书写父组件及form的内容

// components/form/form.js

VAR formControls = require('./module/behaviors/controls.js')

Component({

relations: {

'formControls': {

type: 'descendant', // 关联目标的节点应为子孙节点

target: formControls // 所有设置behavior的组件的节点都为其子孙节点

}

}

})

继续书写wxml的内容,其实就是添加一个挂载点的问题。

<!--components/form/form.wxml-->

<text>components/form/form.wxml</text>

<slot/>

input组件

// components/form/input/input.js

var formControls = require('../module/behaviors/controls.js')

Component({

behaviors: [formControls],

relations: {

'../form': {

type: 'ancestor', // 关联的目标节点应为祖先节点

}

}

})

wxml

<!--components/form/input/input.wxml-->

<text>components/form/input/input.wxml</text>

<slot/>

submit组件

此为From的子组件

// components/form/submit/submit.js

var formControls = require('../module/behaviors/controls.js')

Component({

behaviors: [formControls],

relations: {

'../form': {

type: 'ancestor', // 关联的目标节点应为祖先节点s

}

}

})

继续写wxml加上一个

<!--components/form/submit/submit.wxml-->

<text>components/form/submit/submit.wxml</text>

<label><slot/></label>

json配置文件

{

"usingComponents": {

"component": "/components/component",

"body": "/components/body/body",

"custom-form": "/components/form/form",

"custom-input": "/components/form/input/input",

"custom-submit": "/components/form/submit/submit"

}

}

编写页面的wxml

<custom-form>

<view>

<custom-input/>

</view>

<custom-submit/>

</custom-form>

完成(^o^)/
至此，根据一个behaviors完成一个组件

抽象性节点

抽象节点类似于挂载点，但是和挂载点不同的是，可以通过属性来更改挂载的组件。需要注意的一点是，其值需要为静态值，不能为动态值，抽象节点只能使用静态的内容。

但是个人感觉和挂载点还是有一点类似的作用，不过这个是通过不同的条件达到调用的目的。

抽象节点核心在于调用的时候才能确定内部需要什么组件，只有调用才能确认需要的组件，核心在于将业务和逻辑分离，彻底达到消除耦合的目的。

组件的目的在于尽可能的减少业务逻辑在里面。
注意，组件的确是要尽可能的减少逻辑在里面，因为组件的核心在于复用，在于大量的复用。减少重复代码的书写，即将一段业务中的重复的，多次的抽象出来，提取成为一个组件，如果因为某些原因，必须要存在一定的业务逻辑在里面，这个时候就需要抽象节点。

抽象节点和挂载点的不同就在上方体现出来了，抽象节点是必须有的，但是挂载点可有可无

抽象节点的核心在于分离，抽象。
再次感受抽象的重要性

在组件中使用抽象节点

在自定义模板中的一些节点，其对应的自定义组件不是由自定义组件本身确定的，由调用者确定，称为抽象节点

这定义╮(╯▽╰)╭

例如下面的代码

<view>
    <label>
        <selectable disabled="{{false}}"/>
    </label>
</view>

在上方的代码中，selectable 是由调用者确定的，需要在调用的时候根据属性值进行替换
还需要在json文件中添加如下的配置

{
    "componentGenerics": {
        "selectable": true
    }
}

直接声明该节点为抽象节点，其值由调用者确定

使用包含抽象节点的组件

上方是在代码中定义抽象节点。仅仅是定义，还不能使用。
如果要是使用抽象节点，需要再次添加属性

generic 为一个选项

在page页面中写入如下内容

<custom-form  generic:selectable="component">

</custom-form>

表明引入一个组件，其中的抽象节点的selectable替换为component内容。

需要注意的是，需要在json文件中引入component的内容

默认组件

即在未指定组件内容的时候使用的组件
在组件文件夹中的json声明。
此时不需要使用true即可声明抽象节点

{

"usingComponents": {},

"componentGenerics": {

"selectable": {

"default": "/components/component"

}

}

}

自定义组件扩展

自定义组件的扩展实质为提供了修改自定义组件定义段的能力。使用自定义组件的扩展能动态的修改的自定义组件的扩展。

一直别一个及其简单的问题困扰了很久，es6中新增加的对象属性声明，并赋值，可以直接省去function关键字。

关于es6

关于es6的问题，是滴，被微信官方文档的一个写法纠结了很久

module.exports = Behavior({
  definitionFilter(defFields) {
    defFields.data.from = 'behavior'
  },
})

就上方的写法，由于是一种新的写法，上方的等价于下方的内容

module.exports = Behavior({
    definitionFilter: function definitionfilter(defFields) {
        defFields.data.form = 'behavior'
    }
})

仅仅是一种新的es6的写法。一种声明私有函数的方式，一般在组件里声明私有函数。这个时候，可以直接省去function。
好啦，最大的障碍解决了。

definitionfilter函数

Behavior() 构造器定义了一个新的段，即definitionfilter段。
该函数具有两个定义段，分别是defFields 以及 definitionFilterAll 此为两个参数
下面解释这两个参数

defFields参数

对于该参数来说，是当前被调用使用的behavior，这个灰常简单不在多说

definitionFilterAll 参数

这个参数为behaviors顺序。
使用一个官方的栗子来解释吧

// behavior3.js
module.exports = Behavior({
    definitionFilter(defFields, definitionFilterArr) {},
})

// behavior2.js
module.exports = Behavior({
  behaviors: [require('behavior3.js')],
  definitionFilter(defFields, definitionFilterArr) {
    // definitionFilterArr[0](defFields)
  },
})

// behavior1.js
module.exports = Behavior({
  behaviors: [require('behavior2.js')],
  definitionFilter(defFields, definitionFilterArr) {},
})

// component.js
Component({
  behaviors: [require('behavior1.js')],
})

在上方的栗子中，每个defFelds都为当前调用的behaviors，而definitionFilterArr是这样的情况
当调用2的时候，因为会调用3的definitionFilter函数，对其内容进行更改，在3中的definitionFilter函数有两个参数，第一个参数为2的behavior的定义段，即2中的各项内容进行更改，第二个参数为3的behaviors的内容，由于3没有引用其他的behaviors，所以为一个空数组

总结，当调用的时候，第一个参数为调用者的behaviors，而第二个参数为其本身的behaviors

当进行到1的时候，将会调用2的definitionFilter，其2的该函数的第一个参数为1的behaviors，和其他的一些项，第二个参数为2引用的behaviors，由于2引用了3的behaviors，而3没有引用，所以是一个只有一项的数组，该数组的内容为2引用的behaviors，即3的definitionFilter定义段

如果当调用1的时候，要调用3的definitionFilter函数
分析，3的definitionFilter函数由2的behaviors函数调用，而2的·definitionFilter函数是由1的behaviors调用，并且3的definitionFilter函数在2中的definitionFilter函数的第二个参数的第一项(数组)中有其内容，所以需要在2中写数组，用来调用3的definitionFilter函数。
所以第2中有definitionFilterArr[0](defFields)表明是调用3的definitionFilter而参数defFields表明是2中的behaviors中的内容。

同理使用Component构造函数的时候，将会调用1的definitionFilter函数对Component内容进行更改。

最后，总结就是一句话

当调用的时候，第一个参数为调用者的behaviors，而第二个参数为其本身的behaviors

官方扩展包 https://github.com/wechat-min... 实现动态的计算属性

哦。貌似切图仔最重要的瀑布流还没有学习

第三方自定义组件

终于到自己的知识范畴啦。目前已经会node.js和npm，下面的就比较好学习了。
微信小程序的官方ide支持npm
官方提供有一个模板 https://github.com/wechat-min...
属于小程序的自定义脚手架的相关内容。
官方的事例的组件 https://github.com/wechat-min...
以及官方提供的命令行工具 https://github.com/wechat-min...

命令行工具

npm install -g @wechat-miniPRogram/miniprogram-cli

东西有点多

安装完成以后进行初始化

miniprogram init [options] [dirPath]

进行选择即可。

miniprogram

即第三方的自定义组件，custom-component为创建一个空的自定义组件目录，miniprogram为一个小程序的自定义组件的快速的开始，会有一个从github上下的一个模板，写代码即可。
属于脚手架的一部分。

由于涉及到glup，暂时搁置。

目录如下

|--miniprogram_dev // 开发环境构建目录
|--miniprogram_dist // 生产环境构建目录
|--src // 源码
|   |--common // 通用 js 模块
|   |--components // 通用自定义组件
|   |--images // 图片资源
|   |--wxml // 通用 wxml 模版资源
|   |--wxs // 通用 wxs 资源
|   |--wxss // 通用 wxss 资源
|   |
|   |--xxx.js/xxx.wxml/xxx.json/xxx.wxss // 暴露的 js 模块/自定义组件入口文件
|
|--test // 测试用例
|--tools // 构建相关代码
|   |--demo // demo 小程序目录，开发环境下会被拷贝生成到 miniprogram_dev 目录中
|   |--test // 测试工具相关目录
|   |--config.js // 构建相关配置文件
|
|--gulpfile.js

即，按照上方进行构建相关的组件即可。目前src部分能看明白，暴露的接口和node.js的包如出一辙，都是直接在主文件中进行暴露出接口的，最上方两个文件，最开始接触到的是git的工作流，根据git的工作流也能明白，最后test和tools这一点还有点晕。测试用例使用下方的命令构建出测试用例。

npm run test

tools中的demo为一个演示，即开发者下载下来内容以后将会直接出现的内容，例如，文档中的使用微信小程序打开这一点就是参考这样的，
test测试工具相关目录，进行测试的工具存放的目录。例如进行自动化测试的一些脚本要书写在这里。
config.js为进行自动化构建所要进行的文件，

ps 由于构建工具未学，构建工具的学习重点肯定是配置文件的书写。以及对接口的暴露等。

至此，暂时结束微信小程序的自定义组件化，明天写插件。