小程序自定义组件简介

         首先说下自定义组件使用的好处,如果页面内的某一模块被很多页面重复使用,就可以将这一模块抽离出来封装成自定义组件,方便多个页面进行引用。这样将复杂的页面拆分成多个低耦合的模块,有助于代码维护。

        小程序的自定义组件跟普通的page一样,也是由wxml、wxss、json,js组成。新建一个名为components的文件夹,新建的自定义组件统一放在这个文件夹下。

json:

如果要使用自定义组件,要将json文件中component设置为true,如果要在组件中引用其他的自定义组件,可在usingComponents中定义。

{

  "component": true,

  "usingComponents": {

  }

}

wxml:

        组件模板的写法与page相同。组件模板与组件数据结合后生成的节点树,将被插入到组件的引用位置上。

1 如果业务需要对自定义组件A进行扩展,可在模板A中插入节点。默认情况下,一个组件的wxml中只能有一个slot。需要使用多slot时,可以在组件js中声明启用options: {multipleSlots: true },以不同的 name 来区分。

<view >

  <view>李雪琴你好,我是吴亦凡,别管我在哪,你看这灯多亮</view>

<slot name="shiliujie"></slot>

</view>

在组件A的JS中设置multipleSlots为true。

Component({

  options: {

    multipleSlots: true // 开启slot

  }

})

在page页面中引用A组件,定义<slot>

<!-- 引用组件的页面模版 -->

<view>

  <my-component>

      <text slot="shiliujie">李雪琴你好,我是石榴姐,你吃饭没呢</text>

  </my-component>

</view>

2 page可以向其包含的子组件传递数据。自定义的<my-component>组件的属性 propA 和 propB 接收页面传递来的数据。可以在page下的js中通过 setData 来改变绑定的数据。

小程序开发文档提示:这样的数据绑定只能传递 JSON 兼容数据。基础库版本2.0.9开始,还可以在数据中包含函数(但这些函数不能在wxml中直接调用,只能传递给子组件)。

<!-- 引用组件的页面模版 -->

<view>

  <my-component prop-a="{{dataFieldA}}" prop-b="{{dataFieldB}}">

      <text slot="shiliujie">李雪琴你好,我是石榴姐,你吃饭没呢</text>

  </my-component>

</view>

Js:

    这里定义了组件的事件。

Component({

  /**

   * 组件的生命周期(优先级最高)

   */

  lifetimes: {

    created(){

      //在组件实例刚刚被创建时执行,此时还不能调用setData,只用于给组件this添加一些自定义属性字段。

    },

    attached() {

       // 在组件实例进入页面节点树时执行。在组件完全初始化完毕、进入页面节点树后被触发。此时this.data 已被初始化为组件的当前值。这个生命周期很有用,绝大多数初始化工作可以在这个时机进行。

    },

    ready(){

      //在组件在视图层布局完成后执行

    },

    moved(){

      //在组件实例被移动到节点树另一个位置时执行

    },

    detached() {

      // 在组件实例被从页面节点树移除时执行。退出一个页面时,如果组件还在页面节点树中,则detached被触发。

    },

    error(){

      //每当组件方法抛出错误时执行(参数:Object Error)

    }

  },

   /**

   * 组件所在页面的生命周期(与组件没有很强的关联,但有时组件需要获知,以便组件内部处理)

   */

  pageLifetimes: {

    show() {

      // 组件所在的页面被展示时执行

    },

    hide() {

      // 组件所在的页面被隐藏时执行

    },

    resize(size) {

      // 组件所在的页面尺寸变化时执行(参数:Object Size)

    }

  },

   /**

   * 组件相关选项设置(例如slot节点的开启在这里设置)

   */

  options: {


  },

  /**

   * 组件的属性列表

   */

  properties: {

    myProperty: { // 属性名

      type: String, // 类型(必填),目前接受的类型包括:String, Number, Boolean, Object, Array, null(表示任意类型)

      value: '', // 属性初始值(可选),如果未指定则会根据类型选择一个

      observer(newVal, oldVal, changedPath) {

        // 属性被改变时执行的函数(可选),通常 newVal 就是新设置的数据, oldVal 是旧数

        // 新版本基础库不推荐使用这个字段,而是使用 Component 构造器的 observer 字段代替(这样会有更强的功能和更好的性能)

      }

    }

  },


  /**

   * 组件的初始数据

   */

  data: {


  },


  /**

   * 组件的方法列表

   */

  methods: {

//组件中的变量要传递到page可以通过事件触发this.triggerEvent()来执行

  },

  /**

   * 数据监听器,监听和响应任何属性和数据字段的变化

   */

  observers: {

    'numberA, numberB': function (numberA, numberB) {

      // 在 numberA 或者 numberB 被设置时,执行这个函数

      this.setData({

        sum: numberA + numberB

      })

    }

  },

  /**

   * 组件间关系定义

   */

  relations: {

    './custom-li': {

      type: 'child', // 目标组件的相对关系,可选的值为 parent、child、ancestor 、descendant

      linked(target) {

        // 关系生命周期函数,当关系被建立在页面节点树中时触发,触发时机在组件attached生命周期之后

      },

      linkChanged(target) {

        // 关系生命周期函数,当关系在页面节点树中发生改变时触发,触发时机在组件moved生命周期之后

      },

      unlinked(target) {

        // 关系生命周期函数,当关系脱离页面节点树时触发,触发时机在组件detached生命周期之后

      }

      //target:如果这一项被设置,则它表示关联的目标节点所应具有的behavior,所有拥有这一behavior的组件节点都会被关联

    }

  }


})


使用组件:

    在page中使用已定义的组件,首先要在json文件中声明。

"usingComponents": {

    "people-select": "/components/people-select"

  }

在wxml中进行组件的引用。

<view>

<people-select showModel="{{showModel}}" bindpeopleselect="onShow"></ people-select>

</view>


以上内容都是看小程序文档总结的,如果有不懂的地方,写一个小demo差不多就能理解了。

附开发文档:https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/

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

推荐阅读更多精彩内容