微信小程序之自定义组件的实现代码(附源码)
2018-08-02 11:02
1066 查看
最近在项目开发中,遇到好多雷同的页面样式,就想着可以将常用的功能模块封装成组件,方便在项目中使用和修改,下面就参照微信小程序的文档分步骤写一个微信小程序的组件。
附上效果图:
step1:创建文件并申明
与创建微信小程序的页面一样,一个自定义组件也需要json,wxml,wxss,js四个文件。
在项目根目录中创建文件夹,取名为:component,在该目录下继续创建文件夹successModal。
可以在开发工具中右键创建,选择component,默认自动会创建四个文件。如图:
在successModal.json文件中进行自定义组件声明,如:
在开发工具中右键新建选择component,默认自动会创建。
{ "component": true, "usingComponents": {} }
step2:编写组件模板代码
<!-- 这是自定义组件的内部WXML结构 success.wxml--> <view class='modal-section' wx:if="{{modalHidden}}"> <view class='modal-opaci' bindtap='modal_click_Hidden'></view> <view class='modal-cont'> <icon type='{{modalIcon}}' size='70'></icon> <text class='modal-titleTxt {{modalIcon}}'>{{modalTitle}}</text> <text class='success-msg'>{{modalDesc}}</text> </view> </view>
step3:编写样式文件
/* 这里的样式只应用于这个自定义组件 */ /*successModal.wxss*/ .modal-opaci { position: absolute; left: 0; top: 0; z-index: 100; height: 100%; width: 100%; background: black; opacity: 0.4; filter: alpha(opacity=40); } .modal-cont { position: fixed; top: 30%; left: 8.5%; z-index: 999; border-radius: 20rpx; padding: 40rpx 150rpx; background-color: #fff; text-align: center; } .modal-cont text { line-height: 90rpx; display: block; } .success { color: #09bb07; } .modal-titleTxt { font-size: 50rpx; font-weight: 700; } .warn { color: #f76260; }
step4:编写业务逻辑
在自定义组件的 js 文件中,需要使用 Component() 来注册组件,组件的属性值和内部数据将被用于组件 wxml 的渲染,其中,属性值是可由组件外部传入的。
//successModal.js Component({ /** * 组件的属性列表 */ properties: { //这里定义了modalHidden属性,属性值可以在组件使用时指定.写法为modal-hidden modalHidden: { type: Boolean, value: true }, modalIcon: { type: String, value: ' ', }, modalTitle: { type: String, value: ' ', }, modalDesc: { type: String, value: ' ', } }, /** * 组件的初始数据 */ data: { }, /** * 组件的方法列表 */ methods: { // 这里是自定义方法 modal_click_Hidden: function () { this.setData({ modalHidden: false, }) }, } })
step5:使用自定义组件
首先在需要使用的json文件中进行引用申明,然后需要提供每个自定义组件的标签名和对应的自定义组件文件路径。
//index.json { "usingComponents": { "modal-success": "../../component/successModal/successModal" //在这里写上页面中自定义的标签名和自定义组件的文件路径 }, "navigationBarTitleText": "首页" }
其次,在页面的wxml中使用自定义组件:在页面的 wxml 中就可以像使用基础组件一样使用自定义组件。节点名即自定义组件的标签名,节点属性即传递给组件的属性值。
<!--index.wxml--> <view class="container"> <view class="demoBtn" bindtap="bindViewTap"> <text>点击</text> </view> <!-- 调用modal组件 --> <modal-success modal-hidden="{{is_modal_Hidden}}" modal-icon="{{is_modal_icon}}" modal-title="{{is_modal_title}}" modal-desc="{{is_modal_desc}}" /> </view>
以上就是小程序自定义组件的demo,欢迎start。
github地址:https://github.com/ywyan/wx-component
注意点:
- 对于基础库的1.5.x版本, 1.5.7 也有部分自定义组件支持。
- 因为WXML节点标签名只能是小写字母、中划线和下划线的组合,所以自定义组件的标签名也只能包含这些字符。
- 自定义组件也是可以引用自定义组件的,引用方法类似于页面引用自定义组件的方式(使用 usingComponents 字段)。
- 自定义组件和使用自定义组件的页面所在项目根目录名不能以“wx-”为前缀,否则会报错。
- 旧版本的基础库不支持自定义组件,此时,引用自定义组件的节点会变为默认的空节点。
总结
以上所述是小编给大家介绍的微信小程序之自定义组件的实现代码,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对脚本之家网站的支持!
您可能感兴趣的文章:
相关文章推荐
- [微信小程序]实现一个自定义遮罩层组件(完整示例代码附效果图)
- 微信小程序自定义select下拉选项框组件的实现代码
- 开发 | 手把手教你实现微信小程序中的自定义组件
- 微信小程序自定义组件简单实现
- 微信小程序 倒计时组件实现代码
- button组件、 onShareAppMessage 方法实现 —— 自定义传参 —— 微信小程序
- 手把手教你实现微信小程序中的自定义组件
- [微信小程序]组件化开发,以一个自定义模块框组件当做示例(附完整示例代码和效果图)
- 微信小程序使用input组件实现密码框功能【附源码下载】
- 使用微信小程序自定义组件实现的tabs选项卡功能
- 微信小程序自定义组件的实现方法及自定义组件与页面间的数据传递问题
- 微信小程序 倒计时组件实现代码
- [微信小程序]组件化开发,以一个自定义模块框组件当做示例(附完整示例代码和效果图)
- 使用wxapp-img-loader自定义组件实现微信小程序图片预加载功能
- 微信小程序自定义多选事件的实现代码
- 微信小程序自定义toast实现方法详解【附demo源码下载】
- 微信小程序 倒计时组件实现代码
- 微信小程序 scroll-view组件实现列表页实例代码
- 微信小程序自定义组件实现tabs选项卡功能
- 微信小程序使用progress组件实现显示进度功能【附源码下载】