[微信小程序]自定义组件

好记性不如烂笔头

组件开发,让代码看起来更加整洁,代码复用性更高,能够减少维护成本,可以让我们少写很多代码。
所以,备忘一下小程序的组件开发流程。

1. 创建组件

使用微信开发者工具可以很方便的创建组件,如图所示,微信开发者工具会为我们自动生成组件相关的文件,组件名称可以随便起,建议最好统一,方便调用,我习惯统一为index


2. 设置组件

在组件的wxml文件中创建一个示例view。

<view class="container"></view>

在组件的wxss文件中设置属性,方便查看。

.container {
  width: 200rpx;
  height: 200rpx;
  background-color: red;
}

3. 调用组件

在要调用组件的页面的json文件中配置组件
c-one是我给这个组件自定义的名称,这个名称可以随便定义,建议最好统一风格,这样有利于代码维护

{
  "usingComponents": {
    "c-one": "/components/one/index"
  }
}

在调用组件的页面的wxml文件中使用配置好的组件

<c-one />

效果就出来了

4. 组件的属性

当然,组件不可能就这么简单,它还有组件的属性和组件的方法等
组件的属性一般定义在组件的js文件中的properties里,这里的属性都是对外公开的,外界是可以调用的,如定义一个text属性,并在组件的wxml文件中绑定
type属性的类型
value属性的初始值(可选)
observer属性值改变的监听方法(可选)

Component({
  /**
   * 组件的属性列表
   */
  properties: {
    text: {
      type: Number,
      value: 1,
      observer: function() {

      }
    }
  }
})
<view class="container">{{text}}</view>

在调用组件的页面就可以通过组件的属性对其进行赋值

<c-one text="{{999}}" />

组件的属性值改变的监听方法接收三个参数
newVal改变后的值
oldVal改变前的值
changedPath改变路径

properties: {
    text: {
      type: Number,
      observer: function(newVal, oldVal, changedPath) {
    
      }
}

该监听方法还可以使用字符串方法定义

properties: {
    text: {
      type: Number,
      observer: 'myFunction'
    }
},

methods: {
    myFunction: function() {

    }
}

5.组件的事件

如果需要在页面监听组件的事件怎么办,那就需要把组件的事件传递到外部,供调用组件的页面监听,在调用组件的页面获取到组件的事件,并获取到事件携带的信息
如,给组件添加一个点击方法,点击后把组件的当前属性值+1,并在调用组件的页面获取到组件事件和组件改变后的属性值,如下所示

组件的wxml文件

<view bind:tap="onTap" class="container">{{text}}</view>

组件的js文件

定义info是获取组件的属性值,并+1
通过this.triggerEvent('', {}, {})可以把组件的事件传递给外界
其中接收的第一个参数为事件的传递名称,可以随意定义,外界就是通过这个名称来监听事件的
第二个参数为要传递的属性,通过key-value的方式传递,外界通过事件的detail.key来获取key对应的值
第三个参数一般不进行设置,使用系统默认就行

methods: {
    onTap: function() {
      const info = this.properties.text + 1
      this.triggerEvent('tapping', {
        info: info
      }, {})
    }
  }

这样就完成了组件的事件传递

调用组件的页面的wxml文件中,监听组件的事件,其中bind:tapping就是组件中this.triggerEvent('', {}, {})中的自定义的方法名
设置text标签用来展示获取到的值,

<c-one bind:tapping="onTapping" text="{{999}}" />
<text>{{info}}</text>

调用组件的页面的js文件中,实现监听方法

onTapping: function(event) {
    const info = event.detail.info
    this.setData({
      info: info
    })
  }

点击后的效果

6. 组件的生命周期

组件和页面一样,也有自己的生命周期,常用的是attached,组件加载时会调用该生命周期方法,我们可以在此方法中对组件的数据进行初始化

attached: function(event) {
    // 组件加载
}

7. 组件的通用行为behaviors

① 创建js文件,定义属性、数据或方法
② 在组件中导入创建的js文件,在Component中声明behaviors
③ 组件就可以使用这些属性和方法

如,创建一个testBeh.js文件,定义一个公用属性和公用方法

const testBeh = Behavior({
  properties: {
    title: String
  },
  methods: {
    test: function() {

    }
  }
})

export { testBeh }

在组件中声明behaviors

import {
 testBeh
} from '../behaviors/testBeh.js'

Component({

  behaviors: [testBeh],
  /**
   * 组件的属性列表
   */
  properties: {

  },

  /**
   * 组件的初始数据
   */
  data: {

  },

  attached: function() {
    // 调用通用属性
    const title = this.properties.title
    // 调用通用方法
    this.test()
  },

  /**
   * 组件的方法列表
   */
  methods: {
    
  }
})

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容