之前做小程序开发的时候,对于开发来说比较头疼的莫过于自定义组件了,当时官方对这方面的文档也只是寥寥几句,一笔带过而已,所以写起来真的是非常非常痛苦!!
好在微信小程序的库从 1.6.3 开始,官方对于自定义组件这一块有了比较大的变动,首先比较明显的感觉就是文档比以前全多了,有木有!(小程序文档),现在小程序支持简洁的组件化编程,可以将页面内的功能模块抽象成自定义组件,以便在不同的页面中复用,提高自己代码的可读性,降低自己维护代码的成本!
本篇文章就是手把手教你实现小程序中自定义组件,坐稳啦~
要做自定义组件,我们先定一个小目标,比如说我们在小程序中实现一下 WEUI 中的弹窗组件,基本效果图如下。
我们初始化一个小程序(本示例基础版本库为 1.7 ),删掉里面的示例代码,并新建一个 components
文件夹,用于存放我们以后开发中的所用组件,今天我们的目的是实现一个 弹框 组件,因此,我们在 components
组件中新建一个 Dialog
文件夹来存放我们的弹窗组件,在 Dialog
下右击新建 Component
并命名为 dialog
后,会生成对应的 json wxml wxss js
4个文件,也就是一个自定义组件的组成部分,此时你的项目结构应该如下图所示:
组件初始化工作准备完成,接下来就是组件的相关配置,首先我们需要声明自定义组件,也就是将 dialog.json
中 component
字段设为 true
:
{ "component": true, // 自定义组件声明 "usingComponents": {} // 可选项,用于引用别的组件 }
其次,我们需要在 dialog.wxml
文件中编写弹窗组件模版,在 dialog.wxss
文件中加入弹窗组件样式,它们的写法与页面的写法类似,我就不赘述,直接贴代码啦~
dialog.wxml
文件如下:
<!--components/Dialog/dialog.wxml--> <view class='wx_dialog_container' hidden="{{!isShow}}"> <view class='wx-mask'></view> <view class='wx-dialog'> <view class='wx-dialog-title'>{{ title }}</view> <view class='wx-dialog-content'>{{ content }}</view> <view class='wx-dialog-footer'> <view class='wx-dialog-btn' catchtap='_cancelEvent'>{{ cancelText }}</view> <view class='wx-dialog-btn' catchtap='_confirmEvent'>{{ confirmText }}</view> </view> </view> </view>
dialog.wxss
文件如下:
/* components/Dialog/dialog.wxss */ .wx-mask{ position: fixed; z-index: 1000; top: 0; right: 0; left: 0; bottom: 0; background: rgba(0, 0, 0, 0.3); } .wx-dialog{ position: fixed; z-index: 5000; width: 80%; max-width: 600rpx; top: 50%; left: 50%; -webkit-transform: translate(-50%, -50%); transform: translate(-50%, -50%); background-color: #FFFFFF; text-align: center; border-radius: 3px; overflow: hidden; } .wx-dialog-title{ font-size: 18px; padding: 15px 15px 5px; } .wx-dialog-content{ padding: 15px 15px 5px; min-height: 40px; font-size: 16px; line-height: 1.3; word-wrap: break-word; word-break: break-all; color: #999999; } .wx-dialog-footer{ display: flex; align-items: center; position: relative; line-height: 45px; font-size: 17px; } .wx-dialog-footer::before{ content: ''; position: absolute; left: 0; top: 0; right: 0; height: 1px; border-top: 1px solid #D5D5D6; color: #D5D5D6; -webkit-transform-origin: 0 0; transform-origin: 0 0; -webkit-transform: scaleY(0.5); transform: scaleY(0.5); } .wx-dialog-btn{ display: block; -webkit-flex: 1; flex: 1; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); position: relative; } .wx-dialog-footer .wx-dialog-btn:nth-of-type(1){ color: #353535; } .wx-dialog-footer .wx-dialog-btn:nth-of-type(2){ color: #3CC51F; } .wx-dialog-footer .wx-dialog-btn:nth-of-type(2):after{ content: " "; position: absolute; left: 0; top: 0; width: 1px; bottom: 0; border-left: 1px solid #D5D5D6; color: #D5D5D6; -webkit-transform-origin: 0 0; transform-origin: 0 0; -webkit-transform: scaleX(0.5); transform: scaleX(0.5); }
组件的结构和样式都有了,还缺少什么呢,没错,还缺 js
, 眼睛比较犀利的同学,可能已经发现了我们在 dialog.wxml
文件中的会有一些比如 {{ isShow }}
、 {{ title }}
这样的模版变量,还定义了 _cancelEvent
和 _confirmEvent
两个方法,其具体实现就是在 dialog.js
中。
dialog.js
是自定义组件的构造器,是使用小程序中 Component
构造器生成的,调用 Component
构造器时可以用来指定自定义组件的属性、数据、方法等,具体的细节可以参考一下官方的文档
下面我通过代码注释解释一下构造器中的一些属性的使用:
// components/Dialog/dialog.js Component({ options: { multipleSlots: true // 在组件定义时的选项中启用多slot支持 }, /** * 组件的属性列表 * 用于组件自定义设置 */ properties: { // 弹窗标题 title: { // 属性名 type: String, // 类型(必填),目前接受的类型包括:String, Number, Boolean, Object, Array, null(表示任意类型) value: '标题' // 属性初始值(可选),如果未指定则会根据类型选择一个 }, // 弹窗内容 content :{ type : String , value : '弹窗内容' }, // 弹窗取消按钮文字 cancelText :{ type : String , value : '取消' }, // 弹窗确认按钮文字 confirmText :{ type : String , value : '确定' } }, /** * 私有数据,组件的初始数据 * 可用于模版渲染 */ data: { // 弹窗显示控制 isShow:false }, /** * 组件的方法列表 * 更新属性和数据的方法与更新页面数据的方法类似 */ methods: { /* * 公有方法 */ //隐藏弹框 hideDialog(){ this.setData({ isShow: !this.data.isShow }) }, //展示弹框 showDialog(){ this.setData({ isShow: !this.data.isShow }) }, /* * 内部私有方法建议以下划线开头 * triggerEvent 用于触发事件 */ _cancelEvent(){ //触发取消回调 this.triggerEvent("cancelEvent") }, _confirmEvent(){ //触发成功回调 this.triggerEvent("confirmEvent"); } } })
截至目前为止,你应该完成了一个自定义弹窗组件的大部分,可是你保存后并没有发现任何变化,因为我们还需要在 index.wxml
文件中引入它!
首先需要在 index.json
中引入组件:
{ "usingComponents": { "dialog": "/components/Dialog/dialog" } }
然后我们在 index.wxml
中引入它,并增加我们自定义的一些值,如下
<!--index.wxml--> <view class="container"> <dialog id='dialog' title='我是标题' content='恭喜你,学会了小程序组件' cancelText='知道了' confirm='谢谢你' bind:cancelEvent="_cancelEvent" bind:confirmEvent="_confirmEvent"> </dialog> <button type="primary" bindtap="showDialog"> ClickMe! </button> </view>
嗯哪,还差最后一步, index.js
配置,没错,这个也很简单,我就复制粘贴了
//index.js //获取应用实例 const app = getApp() Page({ /** * 生命周期函数--监听页面初次渲染完成 */ onReady: function () { //获得dialog组件 this.dialog = this.selectComponent("#dialog"); }, showDialog(){ this.dialog.showDialog(); }, //取消事件 _cancelEvent(){ console.log('你点击了取消'); this.dialog.hideDialog(); }, //确认事件 _confirmEvent(){ console.log('你点击了确定'); this.dialog.hideDialog(); } })
到此!大功告成!
让我们测试一下试试看:
点击按钮之后呢,会出现如下效果:
点击取消或者确定按钮的话,我们在事件中设置了弹窗会关闭,并会打印出相应的信息,具体点击完应该怎么做,就看你们自己发挥了,我只能帮你到这里了~
现在,你已经基本掌握了小程序中的自定义组件开发技巧,怎么样,是不是很棒,应该给自己点个赞,打个call。 总体来说,小程序推出自定义组件后,感觉方便了很多,还没有 get 的小伙伴们,赶紧学习学习,以后多用组件化开发,就不会那么难受了,加油哦~
具体代码,我已经托管到 github 上了,欢迎 issue
~
2019-03-21 17:28:12 2668
2019-03-21 17:27:07 2949
2019-03-21 17:25:57 3047
2019-03-21 17:24:53 2953
2019-03-21 17:23:46 3022
公司正在筹划上市,为扩大市场占有率,将在近3个月内每日赠送6个免费服务名额。
今日仅剩下2个免费名额
关于微信小程序web-view组件内嵌h5的具体配置流程
目前, 微信 小程序 开发 呈现出 持续火热 的状态 ,越来越多的商家开始关注并开发自己的小程序, 但是,我们也看到,还有一部分的 商家 持观望的态度,不知道是...
微信小程序 对于许多企业的发展是有助力作用的,因此,现在 许多公司在小程序出现已经开始申请自己的账号,一些提前开始运营 微信小程序 的公司已经取得了不错的成绩,...
了解大连的微信公众号代运营价格,花最少钱干最多事
现在, 微信小程序 成为了企业在进行微信营销时又一个有效的方式,许多企业通过 微信小程序 开发的方式建立起微信上的营销覆盖网络,但是,有些企业在开发小程序之后,...
关于微信小程序web-view组件内嵌h5的具体配置流程
目前, 微信 小程序 开发 呈现出 持续火热 的状态 ,越来越多的商家开始关注并开发自己的小程序, 但是,我们也看到,还有一部分的 商家 持观望的态度,不知道是...
微信小程序 对于许多企业的发展是有助力作用的,因此,现在 许多公司在小程序出现已经开始申请自己的账号,一些提前开始运营 微信小程序 的公司已经取得了不错的成绩,...
了解大连的微信公众号代运营价格,花最少钱干最多事
现在, 微信小程序 成为了企业在进行微信营销时又一个有效的方式,许多企业通过 微信小程序 开发的方式建立起微信上的营销覆盖网络,但是,有些企业在开发小程序之后,...
拿巨推传媒的首页标题来做个分析:巨推传媒 - 微信代运营公司_公众号托管_小程序开发_微信服务号订阅号推广价格|费用|方案_巨推传媒! 简单的解析一下:巨推传媒...
我们分2种客户讲这个问题,先进种是当前有头条号未注册抖音账号。 这里值得注意的是:我们巨推传媒是抖音认证全国一级代理商,但我们并不是服务所有抖音用户,我们只服务...
转化率这个词,在 SEM推广 中是比较常见的。一般客户询问效果都会问转化怎么样,我们在看推广数据的时候也会去研究转化率。转化率对于SEM推广来说,就是较终效果评...
中秋快来了,大部分品牌已经开始准备了。中秋节这个大热点应该怎么追呢?小编给大家准备了各大品牌的营销文案,供大家借鉴寻找灵感。
很多人都会觉得做数据分析很难,但是通过不断地学习与练习,再加上技能和方法的掌握,你一定会发现数据分析其实并不难! 很多刚入门SEM的小伙伴都觉得数据分析很难,尤...
如何通过策划一场活动为公众号吸粉?本文作者以自己团队运营的一场活动为例,分享了拉新、转化、促活等实用的运营经验。 对于公众号运营者来说,策划活动是拉新、转化、活...
不需要我们注册多个平台了,功能模版也会比较多的,像比如微信人家这个平台,有许多适合小伙伴做公众号吸粉和粉丝互动的活动模版,所以小编今天和大家分享下如何使用微信小
内容营销的关键在何处?文案大咖手把手教你写营销爆款!"/> 9刘玮冬运营手记|万字长文,手把手教你用H5拉动APP下载
小编推荐:由于H5的塑造多样性以及对于微信平台的高度适配,故在去年和前年,各种屌炸天的微信H5创意炸遍你的朋友圈,不仅很好的成为了品牌们传播的秀场,更是成为企业...
10刘玮冬运营手记|万字长文,手把手教你用H5拉动APP下载
小编推荐:由于H5的塑造多样性以及对于微信平台的高度适配,故在去年和前年,各种屌炸天的微信H5创意炸遍你的朋友圈,不仅很好的成为了品牌们传播的秀场,更是成为企业...