企业开办网站,凡科建站官网,互联网创新创业大赛项目计划书,No酒店网站建设一、组件设计
组件就是把图形、非图形的各种逻辑均抽象为一个统一的概念#xff08;组件#xff09;来实现开发的模式
现在有一个场景#xff0c;点击新增与编辑都弹框出来进行填写#xff0c;功能上大同小异#xff0c;可能只是标题内容或者是显示的主体内容稍微不同
…
一、组件设计
组件就是把图形、非图形的各种逻辑均抽象为一个统一的概念组件来实现开发的模式
现在有一个场景点击新增与编辑都弹框出来进行填写功能上大同小异可能只是标题内容或者是显示的主体内容稍微不同
这时候就没必要写两个组件只需要根据传入的参数不同组件显示不同内容即可
这样下次开发相同界面程序时就可以写更少的代码意义着更高的开发效率更少的 Bug 和更少的程序体积
二、需求分析
实现一个Modal组件首先确定需要完成的内容
遮罩层标题内容主体内容确定和取消按钮
主体内容需要灵活所以可以是字符串也可以是一段 html 代码
特点是它们在当前vue实例之外独立存在通常挂载于body之上
除了通过引入import的形式我们还可通过API的形式进行组件的调用
还可以包括配置全局样式、国际化、与typeScript结合
三、实现流程
首先看看大致流程
目录结构组件内容实现 API 形式事件处理其他完善
目录结构
Modal组件相关的目录结构
├── plugins
│ └── modal
│ ├── Content.tsx // 维护 Modal 的内容用于 h 函数和 jsx 语法
│ ├── Modal.vue // 基础组件
│ ├── config.ts // 全局默认配置
│ ├── index.ts // 入口
│ ├── locale // 国际化相关
│ │ ├── index.ts
│ │ └── lang
│ │ ├── en-US.ts
│ │ ├── zh-CN.ts
│ │ └── zh-TW.ts
│ └── modal.type.ts // ts类型声明相关因为 Modal 会被 app.use(Modal) 调用作为一个插件所以都放在plugins目录下
组件内容
首先实现modal.vue的主体显示内容大致如下
Teleport tobody :disabled!isTeleportdiv v-ifmodelValue classmodaldivclassmask:stylestyleclickmaskClose !loading handleCancel()/divdiv classmodal__maindiv classmodal__title line line--bspan{{ title || t(r.title) }}/spanspanv-ifclose:titlet(r.close)classcloseclick!loading handleCancel()✕/span/divdiv classmodal__contentContent v-iftypeof content function :rendercontent /slot v-else{{ content }}/slot/divdiv classmodal__btns line line--tbutton :disabledloading clickhandleConfirmspan classloading v-ifloading ❍ /span{{ t(r.confirm) }}/buttonbutton click!loading handleCancel(){{ t(r.cancel) }}/button/div/div/div
/Teleport最外层上通过Vue3 Teleport 内置组件进行包裹其相当于传送门将里面的内容传送至body之上
并且从DOM结构上来看把modal该有的内容遮罩层、标题、内容、底部按钮都实现了
关于主体内容
div classmodal__contentContent v-iftypeof contentfunction:rendercontent /slot v-else{{content}}/slot
/div可以看到根据传入content的类型不同对应显示不同得到内容
最常见的则是通过调用字符串和默认插槽的形式
// 默认插槽
Modal v-modelshowtitle演示 slotdivhello world~/div
/Modal// 字符串
Modal v-modelshowtitle演示 contentcontenthello world~ /通过 API 形式调用Modal组件的时候content可以使用下面两种
h 函数
$modal.show({title: 演示 h 函数,content(h) {return h(div,{style: color:red;,onClick: ($event: Event) console.log(clicked, $event.target)},hello world ~);}
});JSX
$modal.show({title: 演示 jsx 语法,content() {return (divonClick{($event: Event) console.log(clicked, $event.target)}hello world ~/div);}
});实现 API 形式
那么组件如何实现API形式调用Modal组件呢
在Vue2中我们可以借助Vue实例以及Vue.extend的方式获得组件实例然后挂载到body上
import Modal from ./Modal.vue;
const ComponentClass Vue.extend(Modal);
const instance new ComponentClass({ el: document.createElement(div) });
document.body.appendChild(instance.$el);虽然Vue3移除了Vue.extend方法但可以通过createVNode实现
import Modal from ./Modal.vue;
const container document.createElement(div);
const vnode createVNode(Modal);
render(vnode, container);
const instance vnode.component;
document.body.appendChild(container);在Vue2中可以通过this的形式调用全局 API
export default {install(vue) {vue.prototype.$create create}
}而在 Vue3 的 setup 中已经没有 this 概念了需要调用app.config.globalProperties挂载到全局
export default {install(app) {app.config.globalProperties.$create create}
}事件处理
下面再看看看Modal组件内部是如何处理「确定」「取消」事件的既然是Vue3当然采用Compositon API 形式
// Modal.vue
setup(props, ctx) {let instance getCurrentInstance(); // 获得当前组件实例onBeforeMount(() {instance._hub {on-cancel: () {},on-confirm: () {}};});const handleConfirm () {ctx.emit(on-confirm);instance._hub[on-confirm]();};const handleCancel () {ctx.emit(on-cancel);ctx.emit(update:modelValue, false);instance._hub[on-cancel]();};return {handleConfirm,handleCancel};
}在上面代码中可以看得到除了使用传统emit的形式使父组件监听还可通过_hub属性中添加 on-cancelon-confirm方法实现在API中进行监听
app.config.globalProperties.$modal {show({}) {/* 监听 确定、取消 事件 */}
}下面再来目睹下_hub是如何实现
// index.ts
app.config.globalProperties.$modal {show({/* 其他选项 */onConfirm,onCancel}) {/* ... */const { props, _hub } instance;const _closeModal () {props.modelValue false;container.parentNode!.removeChild(container);};// 往 _hub 新增事件的具体实现Object.assign(_hub, {async on-confirm() {if (onConfirm) {const fn onConfirm();// 当方法返回为 Promiseif (fn fn.then) {try {props.loading true;await fn;props.loading false;_closeModal();} catch (err) {// 发生错误时不关闭弹框console.error(err);props.loading false;}} else {_closeModal();}} else {_closeModal();}},on-cancel() {onCancel onCancel();_closeModal();}});
}
};其他完善
关于组件实现国际化、与typsScript结合大家可以根据自身情况在此基础上进行更改
参考文献
https://segmentfault.com/a/1190000038928664
