微信小程序自定义组件和通信的方法

 更新时间:2024年06月20日 11:05:28   作者:激洪  
开发中常见的组件主要分为公共组件和页面组件两种,因此注册组件的方式也分为两种全局注册和局部注册,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧

1、基本知识

开发中常见的组件主要分为 公共组件 和 页面组件 两种,因此注册组件的方式也分为两种:

  • 全局注册:在 app.json 文件中配置 usingComponents 节点进行引用声明,注册后可在任意组件使用
  • 局部注册:在页面.json 文件中配置 usingComponents 节点进行引用声明,只可在当前页面使用

在组件的 .js 中,需要调用 Component 方法创建自定义组件,Component 中有以下两个属性:

  • data 数据:组件的内部数据
  • methods 方法:在组件中事件处理程序需要写到
  • methods 中才可以其他……

2、Properties属性

属性 Properties 是指组件的对外属性,主要用来接收组件使用者传递给组件内部的数据,和 data 一同用于组件的模板渲染

Component({
   properties: {
     // 如果需要接收传递的属性,有两种方式:全写、简写
     label: String // 简写
     label: {
       // type 组件使用者传递的数据类型
       // 数据类型:String、Number、Boolean、Object、Array
       // 也可以设置为 null,表示不限制类型
       type: String,
       value: ''
     },
     // 文字显示位置
     position: {
       type: String,
       value: 'right'
     }
   }
})

3、slot插槽

在使用基础组件时,可以给组件传递子节点传递内容,从而将内容展示到页面中,自定义组件也可以接收子节点内容

只不过在组件模板中需要定义 <slot /> 节点,用于承载组件引用时提供的子节点

默认情况下,一个组件的 wxml 中只能有一个 slot 。需要使用多 slot 时,可以在组件 js 中声明启用。

同时需要给 slot 添加 name 来区分不同的 slot,给子节点内容添加 slot 属性来将节点插入到 对应的 slot

Component({
  options: {
    // 启用多 slot 支持
    multipleSlots: true
  }
})
<!-- 子组件 -->
<view>
  <slot name="slot-top" />
  <!-- slot 就是用来接收、承载子节点内容 -->
  <!-- slot 只是一个占位符,子节点内容会将 slot 进行替换 -->
  <!-- 默认插槽 -->
  <view><slot /></view>
  <slot name="slot-bottom" />
</view>
<custom01>
  <text slot="slot-top">我需要显示到顶部</text>
  <!-- 默认情况下,自定义组件的子节点内容不会进行展示 -->
  <!-- 如果想内容进行展示,需要再组件模板中定义 slot 节点 -->
  我是子节点内容
  <text slot="slot-bottom">我需要显示到低部</text>
</custom01>

4、组件样式隔离

默认情况下,自定义组件的样式只受到自定义组件 wxss 的影响。除非以下两种情况:

  • app.wxss页面. wxss 中使用了标签名(view)选择器(或一些其他特殊选择器)来直接指定样式,这些选择器会影响到页面和全部组件。通常情况下这是不推荐的做法。
  • 指定特殊的样式隔离选项 styleIsolation,支持以下取值:
  • isolated 表示启用样式隔离,在自定义组件内外,使用 class 指定的样式将不会相互影响(一般情况下的默认值);
  • apply-shared 表示页面 wxss 样式将影响到自定义组件,但自定义组件 wxss 中指定的样式不会影响页面;
  • shared 表示页面 wxss 样式将影响到自定义组件,自定义组件 wxss 中指定的样式也会影响页面和其他设置了 apply-shared 或 shared 的自定义组件。
Component({
  options: {
    styleIsolation: 'isolated'
  }
})

5、组件间通信

  • 父往子传值:Properties
  • 子往父传值:自定义事件、获取组件实例

5.1 自定义事件

  • 自定义组件触发事件时,需要使用 triggerEvent 方法发射一个自定义的事件
  • 自定义组件标签上通过 bind 方法监听发射的事件

子组件触发事件:

<!-- 在子组件中 -->
<button type="primary" plain bindtap="sendData">传递数据</button>
// 在子组件中
Component({
  // 组件的初始数据
  data: {
    num: 666
  },
  // 组件的方法列表
  methods: {
    // 将数据传递给父组件
    sendData () {
      // 如果需要将数据传递给父组件
      // 需要使用 triggerEvent 发射自定义事件
      // 第二个参数,是携带的参数
      this.triggerEvent('myevent', this.data.num)
    }
  }
})

父页面(组件)监听事件:

<!-- 在父页面(组件)中 -->
<view>{{ num }}</view>
<!-- 需要在自定义组件标签上通过 bind 方法绑定自定义事件,同时绑定事件处理函数 -->
<custom05 bind:myevent="getData" />
// 在父页面(组件)中
Page({
  data: {
    num: ''
  },
  getData (event) {
    // 可以通过事件对象.detail 获取子组件传递给父组件的数据
    // console.log(event)
    this.setData({
      num: event.detail
    })
  }
})

5.2 获取组件实例

可在父组件里调用 this.selectComponent() ,获取子组件的实例对象,就可以直接拿到子组件的任意数据和方法。

调用时需要传入一个匹配选择器 selector,如:this.selectComponent(".my-component")

到此这篇关于微信小程序自定义组件和通信的文章就介绍到这了,更多相关微信小程序组件和通信内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • javascript htmlencode函数(ff兼容版) 主要是编辑器中反转html代码

    javascript htmlencode函数(ff兼容版) 主要是编辑器中反转html代码

    非常不错的htmlencode 方法,比用正则实现的更好,而且效率高,推荐使用第一种方法。
    2009-06-06
  • JavaScript检测浏览器是否支持CSS变量代码实例

    JavaScript检测浏览器是否支持CSS变量代码实例

    这篇文章主要介绍了JavaScript检测浏览器是否支持CSS变量代码实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-04-04
  • JavaScript中创建对象的7种模式详解

    JavaScript中创建对象的7种模式详解

    本文主要介绍了JavaScript中创建对象的7种模式,具有很好的参考价值,下面跟着小编一起来看下吧
    2017-02-02
  • JavaScript编写实现飞机大战

    JavaScript编写实现飞机大战

    这篇文章主要为大家详细介绍了JavaScript编写实现飞机大战,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-05-05
  • zTree插件下拉树使用入门教程

    zTree插件下拉树使用入门教程

    这篇文章主要为大家详细介绍了zTree插件下拉树使用入门教程,感兴趣的小伙伴们可以参考一下
    2016-04-04
  • webpack 从指定入口文件中提取公共文件的方法

    webpack 从指定入口文件中提取公共文件的方法

    这篇文章主要介绍了webpack 从指定入口文件中提取公共文件的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-11-11
  • TypeScript路径别名的配置指南

    TypeScript路径别名的配置指南

    TypeScript 提供了路径别名的功能,方便开发者在大型项目中更高效地引用模块,减少相对路径的冗长与复杂,本文将详细介绍如何配置路径别名,如何结合 Vite 和 Node 环境进行别名设置,帮助开发者在项目开发中更为便捷地组织代码,需要的朋友可以参考下
    2025-03-03
  • 基于JS实现文字转语音即文本朗读

    基于JS实现文字转语音即文本朗读

    这篇文章主要为大家详细介绍了JavaScript如何利用SpeechSynthesis实现文字转语音即文本朗读的功能,感兴趣的小伙伴可以跟随小编一起学习一下
    2023-10-10
  • 如何计算Web动画帧率FPS

    如何计算Web动画帧率FPS

    我们知道,动画其实是由一帧一帧的图像构成的。有Web动画那么就会存在该动画在播放运行时的帧率。而帧率在不同设备不同情况下又是不一样的。有的时候,一些复杂或者重要动画,需要实时监控它们的帧率,从而更好的优化它们,本文就是介绍Web动画帧率(FPS)计算方法。
    2021-05-05
  • JavaScript把数组作为堆栈使用的方法

    JavaScript把数组作为堆栈使用的方法

    这篇文章主要介绍了JavaScript把数组作为堆栈使用的方法,实例分析了javascript操作数组的技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-03-03

最新评论