微信小程序实现自定义组件的创建和使用(一)

从小程序基础库版本 1.6.3 开始,小程序支持简洁的组件化编程。所有自定义组件相关特性都需要基础库版本 1.6.3 或更高。

开发者可以将页面内的功能模块抽象成自定义组件,以便在不同的页面中重复使用;也可以将复杂的页面拆分成多个低耦合的模块,有助于代码维护。自定义组件在使用时与基础组件非常相似。

如何创建和使用自定义组件呢?

创建自定义组件:类似于页面,一个自定义组件由 json, wxml, wxss, js 4个文件组成。

1.要编写一个自定义组件,首先需要在 json 文件中进行自定义组件声明(将 component 字段设为 true 可将这一组文件设为自定义组件):

{
  "component": true
}

2.在 wxml 文件中编写组件模板

<view class="inner">
  {{innerText}}
</view>
<slot></slot>

3.在 wxss 文件中加入组件样式,它们的写法与页面的写法类似。

.inner {
  color: red;
}

注意:在组件wxss中不应使用ID选择器、属性选择器和标签名选择器。
4.组件的js文件,需要使用 Component() 来注册组件,并提供组件的属性定义、内部数据和自定义方法。

Component({
  properties: {
    // 这里定义了innerText属性,属性值可以在组件使用时指定
    innerText: {
      type: String,
      value: 'default value',
    }
  },
  data: {
    // 这里是一些组件内部数据
    someData: {}
  },
  methods: {
    // 这里是一个自定义方法
    customMethod: function(){}
  }
})

4.使用自定义组件
首先要在需要引用组件的页面的 json 文件中进行引用声明。此时需要提供每个自定义组件的标签名和对应的自定义组件文件路径:

{
  "usingComponents": {
 // 组件名字:组件文件路径
    "component-name": "subpage1"
  }
}

5.在页面中引用组件

<view>
  <text>组件页面</text>
  <!-- 以下是对一个自定义组件的引用 -->
  <component-name inner-text="我是子组件">
    <view>这里是插入到组件slot中的内容</view>
  </component-name>
</view>

效果图:


图片.png

注意事项
一些需要注意的细节:
因为 WXML 节点标签名只能是小写字母、中划线和下划线的组合,所以自定义组件的标签名也只能包含这些字符。
自定义组件也是可以引用自定义组件的,引用方法类似于页面引用自定义组件的方式(使用 usingComponents 字段)。
自定义组件和页面所在项目根目录名不能以“wx-”为前缀,否则会报错。
注意,是否在页面文件中使用 usingComponents 会使得页面的 this 对象的原型稍有差异,包括:
使用 usingComponents 页面的原型与不使用时不一致,即 Object.getPrototypeOf(this) 结果不同。
使用 usingComponents 时会多一些方法,如 selectComponent 。
出于性能考虑,使用 usingComponents 时, setData 内容不会被直接深复制,即 this.setData({ field: obj }) 后 this.data.field === obj 。(深复制会在这个值被组件间传递时发生。)
如果页面比较复杂,新增或删除 usingComponents 定义段时建议重新测试一下。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 1.小程序起步 (1)点击https://mp.weixin.qq.com/wxopen/waregister?a...
    GXW_Lyon阅读 3,480评论 0 0
  • 什么是微信小程序的自定义组件以及意义 自定义组件,类似于Vue中的组件概念(事件通信机制非常类似),将页面内的一些...
    Gopal阅读 730评论 0 0
  • 因新工作主要负责微信小程序这一块,最近的重心就移到这一块,该博客是对微信小程序整体的整理归纳以及标明一些细节点,初...
    majun00阅读 7,499评论 0 9
  • 人生第一次无知犯错,16岁时因为一人家说了句“读书有什么卵用”心里觉得难受就把书包扔进池塘,当时就觉得花了...
    马兴坚阅读 111评论 0 0
  • 我在云南丽江短期旅游,住在一个客栈;为了留个纪念,特意向客栈的老板娘借了笔墨,在客厅用毛笔给我女儿写张明信片。不知...
    杰郭阅读 324评论 0 0