🖥️ 微信小程序 专栏:小程序组件化开发
🧑‍💼 个人简介:一个不甘平庸的平凡人🍬

✨ 个人主页:CoderHing的个人主页

🍀 格言: ☀️ 路漫漫其修远兮,吾将上下而求索☀️

👉 你的一键三连是我更新的最大动力❤️


目录

一、小程序组件化思想

小程序组件化开发

二、自定义组件的过程

创建一个组件

使用自定义组件和细节注意事项

三、组件样式实现细节

组件的样式细节

四、组件使用过程通信

组件的通信

向组件传递数据 - properties

向组件传递样式 -  externalClasses(较少使用)

组件向外传递事件 – 自定义事件

页面直接调用组件方法(使用的较少)

五、组件插槽定义使用

什么是插槽?

多个插槽的使用

behaviors

组件的生命周期

组件所在页面的生命周期

六、Component构造器


一、小程序组件化思想

小程序组件化开发

  • 小程序刚推出时是不支持组件化的,也是为人诟病的一个点
  • 从1.6.3开始,便支持自定义组件开发了,也让我们更加方便在程序中使用组件化
  • 微信小程序 | 小程序组件化开发
  • 组件化思想的应用:
  • 我们在之后的开发中可以充分利用它
  • 尽可能将页面拆成一个个 小的、可复用的组件
  • 这会让我们的代码更加 方便组织管理,并且拓展性更强

二、自定义组件的过程

创建一个组件

  • 类似于页面,自定义组件由 json wxml wxjj js 四个文件组成
  • 先在根目录下创建一个文件夹;
  • components里存放 自定义的公共组件
  • 常见的一个自定义组件 section-info: 包含对应的四个文件
  • 微信小程序 | 小程序组件化开发
  • 微信小程序 | 小程序组件化开发
  • 自定义组件步骤
  • 需要在json文件中进行 自定义组件声明(将component字段设置为true 可以讲这一组文件设为自定义组件(当你在文件中设置了这个属性之后,那么它将是一个组件)

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发  

  • 在wxml中编写属于自定义组件自己的模板
  • 在wxss中编写属于自己的样式
  • 在js文件中,定义数据或组件内部的相关逻辑代码

微信小程序 | 小程序组件化开发 

  • 在哪个组件中想要使用自定义组件,那么就在哪个里面的json文件中进行书写.

使用自定义组件和细节注意事项

  • 自定义组件也是可以引用自定义组件的,引用方法类似于页面引用自定义组件的方式(使用usingComponents 字段)
  • 自定义组件和页面所在项目根目录 名 不能以“wx-”为前缀,否则会报错
  • 如果在app.json的usingComponents声明某个组件,那么所有页面和组件可以直接使用该组件

微信小程序 | 小程序组件化开发 

三、组件样式实现细节

组件的样式细节

  • 组件内的样式 对 外部样式 的影响
  • 组件内的class样式 只对组件wxml内的节点生效,对于引用组件的Page页面不生效
  • 组件内不能使用id选择器,属性选择器,标签选择器(会对其他组件进行样式更改)
  • 外部样式 对 组件内样式 的影响
  • 外部使用class的样式,只对外部wxml的class生效,对组件内的无效
  • 外部使用id选择器,属性选择器不会对组件内产生影响
  • 外部使用了 标签选择器 会对组件内产生影响
  • 如何让class可以相互影响?
  • 在Component对象中 可以传入一个 options属性, 其中options属性中有一个 styleIsolation(隔离)属性.
  • stylelsolation有三个取值:
  • Isolated 启用样式隔离,在自定义组件内外,使用class指定的样式将不会相互影响(默认值)
  • Apply-shared 页面wxss样式将影响到自定义组件 但自定义组件中的wxss中指定的样式不影响页面
  • Shared 页面wxss样式将影响到自定义组件,自定义组件 wxss 中指定的样式也会影响页面和其他设置

微信小程序 | 小程序组件化开发 

四、组件使用过程通信

组件的通信

很多情况下,组件内展示的内容(数据、样式、标签),并不是在组件内写死的,而且可以由使用者来决定.

微信小程序 | 小程序组件化开发

向组件传递数据 - properties

  • 给组件传递数据:
  • 大部分情况下,组件只负责布局和样式,内容由使用组件的对象 决定的
  • 我们经常需要从外部传递数据给我们的组件,让我们的组件来进行展示
  • 如何传递? => 使用 properties属性
  • 支持的类型:
  • String Number Boolean
  • Object Array null(不限制类型)
  • 默认值:
  • 通过value来设置

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发 

向组件传递样式 -  externalClasses(较少使用)

  • 给组件传递样式:
  • 我们不希望将样式写在组件内固定不变,而是通过外部来决定样式
  • 这时,我们可以使用externalClasses 属性:
  • 1.在Component对象中,先定义externalClasses属性

微信小程序 | 小程序组件化开发

  • 2.在组件内的wxml中使用externalClasses属性中的class

微信小程序 | 小程序组件化开发

  • 3.在页面中传入对应的class,并且给这个class设置样式

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发

组件向外传递事件 – 自定义事件

有时候是自定义组件内部发生了事件,需要告知使用者,这个时候可以使用自定义事件:

微信小程序 | 小程序组件化开发

页面直接调用组件方法(使用的较少)

  • 可以在父组件里调用 this.selectComponent,获取子组件的实例对象
  • 调用时需要传入一个匹配选择器 selector,如:this.selectComponent(".my-component")。

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发 

微信小程序 | 小程序组件化开发  

五、组件插槽定义使用

什么是插槽?

  • 组件的插槽
  • 为了让我们封装的组件更加具有拓展性
  • 让使用者可以决定组件内部的一些内容到底展示什么?

单个插槽的使用

  • 除了内容和样式可能由外界决定之外,也可能外界想决定显示的方式
  • 如:我们有一个组件定义了头部和尾部,但是中间的内容可能是一段文字,可能是图片,等等...
  • 在不确定外界想插入什么其他组件的前提下,我们可以在组件内预留插槽:

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发

这里有一个小问题,如图所示, 小程序中 插槽是不能设置默认值的 那么我们怎么去解决呢?

使用 css中的 :empty

微信小程序 | 小程序组件化开发

JavaScript
// 代码展示
//   插槽代码
<view class="my-slot">
  <view class="header">Header</view>
  <view class="content">
    <!-- <view>哈哈哈哈</view> -->
    <!-- 预留插槽 -->
    <!-- 在小程序中,插槽是不支持默认值的 -->
    <slot>哈哈哈哈</slot>
  </view>
  <!-- 我如果想要我没有写插槽 也有一个默认值怎么办呢? 自己动手  我得让我这个 哈哈哈 在有插入东西时不显示
  没有插入东西的时候 显示 css中实现 -->
  <view class="default">哈哈哈哈</view>
  <view class="footer">Footer</view>
</view>
//  index.wxml中代码
<!-- 1.单个插槽的使用 -->
<my-slot>
  <button>我是按钮</button>
</my-slot>
<my-slot>
  <!-- 插入图片 -->
  <image src="/assets/tabbar/home.png" mode="widthFix"></image>
</my-slot>
<my-slot></my-slot>
<my-slot></my-slot>
// css中代码
.default {
  display: none;
}
/* 可以使用兄弟选择器 */
/* :empty 表示 当前元素内容为空的 */
.content:empty + .default {
  display: block;
}

多个插槽的使用

  • 有时候为了让组件更加的灵活,我们需要定义多个插槽:

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发

behaviors

  • behaviors 是用于组件间代码共享的特性,类似于一些编程语言中的  mixins
  • 每个 behavior 可以包含一组属性、数据、生命周期函数和方法
  • 组件引用它时,它的属性、数据和方法会被合并到组件中,生命周期函数也会在对应时机被调用
  • 每个组件可以引用多个 behavior behavior 也可以引用其它 behavior

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发

组件的生命周期

  • 组件的生命周期,值 组件自身的一些函数,这些函数在特殊的时间点或遇到一些特殊的框架事件时被触发.
  • 最重要的生命周期是 created attached detached 包含一个组件实例生命周期流程的最主要时间点
  • 小程序基础库版本 2.2.3 起,组件的的生命周期也可以在 lifetimes 字段内进行声明(这是推荐的方式,其优先级最高)

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发 

组件所在页面的生命周期

  • 有一些特殊的生命周期,它们并非与组件有很强的关联,但有时组件需要获知,以便组件内部处理
  • 样的生命周期称为“组件所在页面的生命周期”,在 pageLifetimes 定义段中定义
  • 可用的生命周期包括:

微信小程序 | 小程序组件化开发

微信小程序 | 小程序组件化开发  

六、Component构造器

微信小程序 | 小程序组件化开发

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。