详解钉钉小程序组件之自定义模态框（弹窗封装实现）

背景

开发钉钉小程序中需要用到模态框 文档里也没有 自己搞一个…
效果大概长这个样

点击指定按钮，弹出模态框，里面的内容可以自定义，可以是简单的文字提示，也可以输入框等复杂布局。操作完点击取消或确定关闭。

开始封装

上图所示文件内容放入项目即可 （路径自己高兴着来）

modal.js
内容不多 但都是精华

1. /**
2. * 自定义modal浮层
3. * 使用方法：
4. * <modal show="{{showModal}}" height='80%' onCancel="modalCancel" onSubmit='modalSubmit'>
5. <view>你自己需要展示的内容</view>
6. </modal>
7.  
8. 属性说明：
9. show： 控制modal显示与隐藏
10. height：modal的高度
11. onCancel：点击取消按钮的回调函数
12. onSubmit：点击确定按钮的回调函数
13.  
14. */
15.  
16. Component({
17.  
18. /**
19. * 组件的属性列表
20. */
21. props: {
22. // modal的默认高度
23. height: '60%',
24.  
25. //是否显示modal
26. show: false,
27.  
28. // submit()
29. onSubmit:(data) => console.log(data),
30.  
31. // onCancel()
32. onCancel:(data) => console.log(data),
33. },
34.  
35. /**
36. * 组件的初始数据
37. */
38. data: {
39.  
40. },
41.  
42. /**
43. * 组件的方法列表
44. */
45. methods: {
46. clickMask() {
47. // this.setData({show: false})
48. },
49.  
50. cancel(e) {
51. // this.setData({ show: false });
52. this.props.onCancel(e);
53. },
54.  
55. submit(e) {
56. // this.setData({ show: false });
57. this.props.onSubmit(e);
58. }
59. }
60. })

代码使用 props 属性设置属性默认值， 调用的时候传递指定值即可

modal.json
这就是个申明 啥也不是

1. {
2. "component": true,
3. "usingComponents": {}
4. }

开发者需要在 .json 文件中指明自定义组件的依赖

modal.acss
这玩意我一个写后端的调了半天才勉强看得下去 求大佬改版发我

1. .mask{
2. position: absolute;
3. top: 0;
4. bottom: 0;
5. width: 100%;
6. height: 100%;
7. display: flex;
8. justify-content: center;
9. align-items: center;
10. background-color: rgba(0,0,0,0.4);
11. z-index: 9999;
12. }
13.  
14. .modal-content{
15. flex-direction: column;
16. width: 90%;
17. /* height: 80%; */
18. position: fixed;
19. top: 10%;
20. left: 5%;
21. background-color: #fff;
22. border-radius: 10rpx;
23. }
24.  
25. .modal-btn-wrapper{
26. display: flex;
27. flex-direction: row;
28. height: 100rpx;
29. line-height: 100rpx;
30. background-color: #fff;
31. border-radius: 10rpx;
32. border-top: 2rpx solid rgba(7,17,27,0.1);
33. }
34.  
35. .cancel-btn, .confirm-btn{
36. flex: 1;
37. height: 100rpx;
38. line-height: 100rpx;
39. text-align: center;
40. font-size: 32rpx;
41. }
42.  
43. .cancel-btn{
44. border-right: 2rpx solid rgba(7,17,27,0.1);
45. }
46.  
47. .main-content{
48. flex: 1;
49. height: 100%;
50. overflow-y: hidden;
51. }

modal.axml
敲重点 slot 标签

可以将 slot 理解为槽位，default slot就是默认槽位，如果调用者在组件标签之间不传递 axml，则最终会将默认槽位渲染出来。而如果调用者在组件标签之间传递有 axml，则使用其替代默认槽位，进而组装出最终的 axml 以供渲染。

简而言之 你在调用的时候所编辑的axml都被塞进slot里面了

1. <view class='mask' a:if='{{show}}' onTap='clickMask'>
2. <view class='modal-content' style='height:{{height}}'>
3. <scroll-view scroll-y class='main-content'>
4. <slot></slot>
5. </scroll-view>
6. <view class='modal-btn-wrapper'>
7. <view class='cancel-btn' style='color:rgba(7,17,27,0.6)' onTap='cancel'>取消</view>
8. <view class='confirm-btn' style='color:#13b5f5' onTap='submit'>确定</view>
9. </view>
10. </view>
11. </view>

使用
这个相对简单鸟

page/xx/page.json
首先申明我要调用这个组件 标签名我就叫modal 路径自己别搞错就好

1. {
2. "usingComponents": {
3. "modal": "/page/components/modal/modal"
4. }
5. }
6.  

page/xx/page.axml
就是这样 喵~

1. <modal show="{{showSearchModal}}" height='80%' onCancel="searchModalCancel"onSubmit='searchModalSubmit'>
2. <view>你自己的布局</view>
3. </modal>

page/xx/page.js
这个你就写你自己的逻辑就没毛病了

1. let app = getApp();
2. Page({
3. data: {
4. showSearchModal: false,
5. },
6.  
7. onLoad() {
8. },
9.  
10. searchModalCancel(){
11. this.setData({
12. showSearchModal: false,
13. });
14. dd.alert({
15. title: '提示',
16. content: '用户点击了取消',
17. });
18. },
19.  
20. searchModalSubmit(){
21. this.setData({
22. showSearchModal: false,
23. });
24. dd.alert({
25. title: '提示',
26. content: '用户点击了提交',
27. buttonText: '我知道了',
28. });
29. },
30. });

小结
激动的心，颤抖的手。。。
总之先阅读官方文档
钉钉开放平台 => 前端API => 小程序 => 框架 => 自定义组件
https://ding-doc.dingtalk.com/doc#/dev/develop-custom-component

本案例相对简单，业务复杂的需求看看文档基本都能实现。

关于微信小程序实现自定义modal弹窗封装的方法 ，可以点击查看。

总结

到此这篇关于钉钉小程序组件之自定义模态框（弹窗封装实现）的文章就介绍到这了,更多相关小程序组件自定义模态框内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！