微信小程序自定义组件——入门教程

前言

在做微信小程序开发的过程中,我认为组件式开发是必须要掌握的一种技能,官方是这样介绍的:

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

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

到目前为止,已经有很多优秀的微信小程序框架,并且里面封装了很多基础的且常用的组件,我建议初学者尽量多看看他们的源码,会有很大的帮助的。在这里我给大家介绍几款我认为比较优秀的ui框架。

1.mpvue(基于 Vue.js 的小程序开发框架,从底层支持 Vue.js 语法和构建工具体系。)

2.minui(基于规范的小程序 UI 组件库,自定义标签组件,简洁、易用、工具化)

3.vant-weapp(轻量、可靠的小程序 UI 组件库)

接下来大家跟着我的步骤一起来操作吧~~(我会带大家实现一个收藏功能)

官方并没有明确规定自定义组件的文件放在哪里,但是为了自己或团队的方便,我还是建议大家在根目录下创建一个components目录,用来存放所有组件。

项目结构

创建完目录后,我们再来看看一个组件需要哪几部分组成。

自定义组件类似于页面,一个自定义组件由 json wxml wxss js 4个文件组成。例如我们创建一个collection组件,在components目录下创建collection目录。


创建collection目录

右键点击collection目录,选择新建,再选择Components会出现如下输入框。


创建collection组件

在输入框内输入index后敲回车,会自动帮你创建好自定义组件所需要的文件。(关于index的命名大家可以随意起),这一点用起来非常方便。


collection组件目录结构

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

{

    "component": true

}

由于咱们是使用的自动创建方式,所以会自动帮我们声明好。如下:


collection/index.json

在自定义组件的 js 文件中,需要使用 Component() 来注册组件,并提供组件的属性定义、内部数据和自定义方法。

组件的属性值和内部数据将被用于组件 wxml 的渲染,其中,属性值是可由组件外部传入的。

代码示例:

collection/index.wxml

<view class='collection'>

    <image src='{{collected?"images/heart-fill.png":"images/heart.png"}}'></image>

</view>

collection/index.wxss

.collection {

    width:50rpx;

    height:50rpx;

}

.collection image {

    width:100%;

    height:100%;

}

collection/index.js

Component({

    properties: {

        // 这里定义了collected属性,属性值可以在组件使用时指定

        collected: { 

            type: Boolean,

            value: false

         }

    },

    data: {

        // 这里是一些组件内部数据

    },

    methods: {

        // 这里是一个自定义方法

        _onCollection: function() {

                let collected = this.properties.collected;

                this.setData({ collected: !collected })

                this.triggerEvent('collected', this.properties.collected);

        }

    }

})

由于咱们是使用的自动创建方式,所以会自动帮我们创建好Component构造器。关于Component构造器的使用大家可以查看官方文档,里面介绍的非常详细,我在这里就不再过多说明了。点击跳转

使用自定义组件

使用已注册的自定义组件前,首先要在页面的 json 文件中进行引用声明。此时需要提供每个自定义组件的标签名和对应的自定义组件文件路径,如我们在index目录下使用collection组件:

{    

    "usingComponents": {       

         "v-collection": "/components/collection/index"    

    }

}

注意:必须要使用双引号,单引号会报错。

其中“v-collection”大家可以自行命名。

这样,在页面的 wxml 中就可以像使用基础组件一样使用自定义组件。节点名即自定义组件的标签名,节点属性即传递给组件的属性值。

代码示例:

pages/index/index.wxml

<view>

    <!--以下是对一个自定义组件的使用>

    <v-collection collected='{{collected}}' bind:collected='onCollection' />

</view>

pages/index/index.js

Page({

    data: {

        collected: false

    },

    onCollection: function(event) {

        let collected = event.detail;

        let str = collected? '收藏成功':'取消收藏';

        console.log(str);

    }

})

组件有两种写法:<v-collection /><v-collection></v-collection>,大家可以自行选择

如果在组件内使用本地图片或图标的话,我建议大家在当前组件目录下创建一个images来存放组件所需的图标,便于日后的维护。

collection下的images目录

以上代码可以直接复制使用。

如有疑问欢迎大家下方留言。

附赠一个自己开发的小程序:(大部分功能全都是由组件构成)


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

推荐阅读更多精彩内容