小程序组件接入

chameleon允许在多态组件中引入原生微信小程序组件,对于已经熟悉小程序组件开发的朋友将非常easy,之前封装的微信小程序组件可以直接使用,微信小程序相关的ui库可以直接使用,微信小程序自带的组件也可以直接使用。

为什么要接入微信小程序组件

多态组件存在的差异不过来自于各端需求不同,又或是各端实现方式的不同。微信小程序组件的接入跟第二个问题完美契合,在原有的小程序开发过程中或许已经产出了常用组件,又或是使用着某个微信小程序的组件库,当使用chameleon进行开发时,避免了二次开发原有组件的成本。

怎么引入微信小程序组件

第一类是微信小程序支持的组件,比如view text等,详细请查看微信小程序组件列表,如果这样的组件已经满足开发需求,那么就可以直接使用了:

<!-- list.wx.cml -->
<template>
  <view>
    <text v-for="l in list">{{l}}</text>
  </view>
</template>

第二类是原有的组件,首先你需要将组件复制到chameleon项目中,然后只需要在chameleon组件中声明式引入该组件即可使用。 还是以list组件为例,假设原有封装好的微信小程序的组件custom-list,目录结构如下:

├── components                      // 组件文件夹
|   ├── custom-list
|   |   ├── custom-list.wxml
|   |   ├── custom-list.wxss
|   |   ├── custom-list.js
|   |   └── custom-list.json

那么,在list.wx.cml中可以直接引用:

<!-- list.wx.cml -->
<template>
  <custom-list list="{{list}}"></custom-list>
</template>
...
<script cml-type="json">
{
  "base": {
    "usingComponents": {
      "custom-list": "/components/custom-list/custom-list"
    }
  }
}

需要注意的是组件路径需要写到.wxml层级,但是不带后缀。

第三类是微信小程序的组件库,这里以iVew Webapp为例,首先需要将其代码下载下来放到chameleon项目中,假设目录结构如下:

├── components                      // 组件文件夹
|   ├── iview
|   |   ├── action-sheet
|   |   |   ├── index.js
|   |   |   ├── index.json
|   |   |   ├── index.wxml
|   |   |   └── index.wxss
|   |   ├── alert
|   |   ├── avatar
|   |   └── ...

这里我们需要使用action-sheet组件只需要如下即可:

<!-- component.wx.cml -->
<template>
  <action-sheet></action-sheet>
</template>
...
<script cml-type="json">
{
  "base": {
    "usingComponents": {
      "action-sheet": "/components/iview/action-sheet/index"
    }
  }
}

需要注意的是组件路径需要写到.wxml层级,但是不带后缀。

示例

详细示例戳这里多态组件扩展

results matching ""

    No results matching ""