找回密码
 立即注册
首页 业界区 业界 五分钟一百行代码,手写一个vue项目全局通用的toast提示 ...

五分钟一百行代码,手写一个vue项目全局通用的toast提示组件

墨佳美 4 天前
前言:

我们已经分享过如何快速实现自己需要的全局弹框组件;
在开发 Vue 项目时,特别是H5页面的项目,还有一个组件是我们非常常用的,它相对弹框来说没有那么大,并且不需要手动关闭在需要更简洁的提示用户一些信息时非常常用,它就是 toast 提示组件;
接下来我们会带着大家手写一个全局的 toast 提示组件,当你在项目任何地方需要使用时,都可直接调用。
查看往期文章:
十五分钟两百行代码,手写一个vue项目全局通用的弹框
第一步:新建文件夹及主要文件

Vue项目中,一般来说我们公用组件是放在 src/components,所以我们直接在src/components/toast下新建如下两个文件:

  • index.vue:该文件是 toast 组件的内容,跟我们写普通 vue 组件一样,包含 toast 的结构、样式以及基础逻辑;
  • index.js:注册 index.vue 组件为全局组件。因为该组件我们不需要手动关闭,并且涉及到添加元素和自动删除元素,所以该文件会有一些元素层面上的操作和逻辑,相对上期的弹框组件的 index.js 的文件来说会相对复杂些,我们下边会逐行讲解,当然也会提供完整代码,请往下看。
第二步:书写组件内容

index.vue组件内容如下:


  • 结构 + js 代码
  1. <template>
  2.   <transition name="appear">
  3.     <section  v-if="show">
  4.       
  5.     </section>
  6.   </transition>
  7. </template>
复制代码
代码说明:

  • 我们这里用到了 Vue 的 transition 组件,用于包裹需要动画效果的元素。name="appear" 指定了使用名为 "appear" 的过渡效果;

    • 详情参考 Vue 官网:https://cn.vuejs.org/guide/built-ins/transition.html

  • 这句代码是我们toast的主要内容,通过 v-html + msg 来动态属性来插入,msg在index.js 中修改;
  • methods:定义组件的方法。

    • open():异步方法,用于显示 Toast。如果已显示,则直接返回;否则设置 show 为 true 并调用 close() 方法等待其完成。
    • close():返回一个 Promise,该 Promise 在 time 毫秒后解决,同时将 show 设置为 false,从而隐藏 Toast。


  • 样式
  1. [/code][size=5]第三步:注册成全局组件[/size]
  2. [code]import { createApp } from 'vue';
  3. import ToastComponents from './index.vue';
  4. const LayerToastId = 'layer-Toast-wrapper';
  5. let Toast = async function (msg, time) {
  6.   time = time || 2000;
  7.   let ToastEl = document.getElementById(LayerToastId);
  8.   // 如果DOM中含有这个元素 不执行
  9.   if (ToastEl) {
  10.     return;
  11.   }
  12.   const div = document.createElement('div');
  13.   div.setAttribute('id', LayerToastId)
  14.   document.body.appendChild(div);
  15.   let layerToastEl = createApp(ToastComponents).mount('#' + LayerToastId);
  16.   // 修改组件中的data的值
  17.   layerToastEl.msg = msg;
  18.   layerToastEl.time = time;
  19.   // 执行组件中的方法 等待关闭后返回promise
  20.   let hasClosed = await layerToastEl.open();
  21.   // 当Toast提示关闭后再删除外层元素 时间最好与css动画一致
  22.   if (hasClosed) {
  23.     setTimeout(() => {
  24.       document.body.removeChild(div);
  25.     }, 400);
  26.   }
  27. };
  28. export default {
  29.   install (app) {
  30.     // 通过this.$toast访问
  31.     app.config.globalProperties.$toast = Toast;
  32.   }
  33. }
复制代码
到这里,我们的弹框组件就完成了。下边我们对一些比较重要的代码做个解释:

  • let Toast = async function 这里表示Toast消息,我们把它注册成一个异步函数,因为内部需要使用到定时器控制定时移除消息容器;
  • let layerToastEl = createApp(ToastComponents).mount('#' + LayerToastId);

    • 这句代码的意思是:把我们引入的 index.vue 文件创建成一个 Vue 的应用实例,并挂载到新创建的 div 上。

  • 以下是 index.js 文件的逐行解释:
  1. // 引入 Vue 的 createApp 函数,用于创建 Vue 应用实例
  2. import { createApp } from 'vue';
  3. // 引入 Toast 组件
  4. import ToastComponents from './index.vue';
  5. // 定义一个常量,用于存储 Toast 组件的容器元素的 ID
  6. const LayerToastId = 'layer-Toast-wrapper';
  7. // 定义一个异步函数 Toast,用于显示 Toast 消息
  8. let Toast = async function (msg, time) {
  9.   // 如果未指定显示时间,默认为 2000 毫秒
  10.   time = time || 2000;
  11.   // 获取页面上是否已存在 Toast 容器元素
  12.   let ToastEl = document.getElementById(LayerToastId);
  13.   // 如果已存在,不执行后续代码,直接返回
  14.   if (ToastEl) {
  15.     return;
  16.   }
  17.   // 创建一个 div 元素,用作 Toast 组件的容器
  18.   const div = document.createElement('div');
  19.   // 为该 div 设置 ID
  20.   div.setAttribute('id', LayerToastId)
  21.   // 将创建的 div 添加到 body 中
  22.   document.body.appendChild(div);
  23.   // 创建一个 Vue 应用实例,并挂载到新创建的 div 上
  24.   let layerToastEl = createApp(ToastComponents).mount('#' + LayerToastId);
  25.   // 设置 Toast 组件的消息内容和显示时间
  26.   layerToastEl.msg = msg;
  27.   layerToastEl.time = time;
  28.   // 调用 Toast 组件的 open 方法,显示 Toast 并等待其关闭
  29.   let hasClosed = await layerToastEl.open();
  30.   // 当 Toast 关闭后,延迟 400 毫秒后移除 Toast 容器元素
  31.   // 这里的 400 毫秒延时可以与 CSS 动画的时间相匹配,确保动画播放完成
  32.   if (hasClosed) {
  33.     setTimeout(() => {
  34.       document.body.removeChild(div);
  35.     }, 400);
  36.   }
  37. };
  38. // 导出一个对象,包含 install 方法,用于在 Vue 应用中安装这个 Toast 功能
  39. export default {
  40.   install (app) {
  41.     // 将 Toast 函数添加到 Vue 应用的全局属性中,使其可以通过 this.$toast 在任何组件中访问
  42.     app.config.globalProperties.$toast = Toast;
  43.   }
  44. }
复制代码
项目中使用弹框

使用就非常简单便利了,主要有以下几种用法:

  • Vue2 中使用:
  1. // Vue2 中简单使用
  2. this.$toast("Toast提示在Vue2项目中的简单使用"));
  3. // Vue2中需要在提示后有进一步操作:可以任何你想的逻辑,包括发接口、页面处理等。
  4. await this.$toast("Toast提示在Vue2项目中使用后有后续逻辑", 3000);
  5. handleFunction(); // 这里的函数代表提示后的逻辑代码
复制代码

  • Vue3 中使用:
  1. // 在 Vue3 中使用时需要先引入app
  2. import { app } from "@/main";
  3. // Vue3 中简单使用
  4. app.config.globalProperties.$toast("Toast提示在Vue3项目中的简单使用", 3000);
  5. // Vue2中需要在提示后有进一步操作:可以任何你想的逻辑,包括发接口、页面处理等。
  6. app.config.globalProperties.$toast("Toast提示在Vue3项目中使用后有后续逻辑");
  7. handleFunction(); // 这里的函数代表提示后的逻辑代码
复制代码
说明:

  • 我们可以在使用时传入合适的显示停留时间,如果为传入,则按默认的 2000 毫秒显示;
  • 在 Vue3 中,你也可以把 $toast 重新保存一下,后续不用每次都写很长的 app.config....
  1. import { app } from "@/main";
  2. const toast = app.config.globalProperties.$toast
  3. toast("简便地使用toast提示");
复制代码
toast 图片示例

1.gif

说明:在停留 2000 毫秒(或者我们设置的停留时间)之后会自动关闭。
写在后面

这是一个比较基础和通用的黑色半透明提示消息,这边示例的代码是比较全的,对细节要求不大的小伙伴可以直接抄作业;
背景颜色、字体、布局等这些细节,因为每个业务场景不同,大家可以根据自己的需要适当调整;
通过修改结构和样式代码,你可以让消息的样式变得更加丰富或者更符合你的业务需求;
消息组件我们一样是使用固定单位的,如果小伙伴的项目需要使用响应式大小,直接对应替换大小单位(rem、vw)即可;
对你有帮助的话给作者点点关注吧,你的支持是我不断更新的动力!Peace and love~~

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
您需要登录后才可以回帖 登录 | 立即注册