vue3——自己封装消息提示功能组件

---

前言

消息提示的弹出框相信大家在浏览网页的时候经常见到，今天跟着本文的脚步一起来自己封装一个消息提示的全局组件吧~

---

一、为什么封装？

• 为了统一项目中提示信息的风格统一
• 项目是由多人合作开发，封装一次，其他人也可以使用

二、如何封装？

1. 封装

和之前文章一样的操作，将公共组件放至src/components下，新建my-message.vue组件

代码如下（示例）：

<template>
  <Transition name="down">
    <div class="my-message" :style="style[type]" v-show='isShow'>
      <!-- 上面绑定的是样式 -->
      <!-- 不同提示图标会变 -->
      <i class="iconfont" :class="[style[type].icon]"></i>
      <span class="text">{{text}}</span>
    </div>
  </Transition>
</template>
<script>
import { onMounted, ref } from 'vue'

export default {
  name: 'MyMessage',
  props: {
    text: {
      type: String,
      default: ''
    },
    type: {
      type: String,
      // warn 警告  error 错误  success 成功
      default: 'warn'
    }
  },
  setup () {
    // 定义一个对象，包含三种情况的样式，对象key就是类型字符串
    const style = {
      warn: {
        icon: 'icon-warning',
        color: '#E6A23C',
        backgroundColor: 'rgb(253, 246, 236)',
        borderColor: 'rgb(250, 236, 216)'
      },
      error: {
        icon: 'icon-shanchu',
        color: '#F56C6C',
        backgroundColor: 'rgb(254, 240, 240)',
        borderColor: 'rgb(253, 226, 226)'
      },
      success: {
        icon: 'icon-queren2',
        color: '#67C23A',
        backgroundColor: 'rgb(240, 249, 235)',
        borderColor: 'rgb(225, 243, 216)'
      }
    }
    // 控制动画
    const isShow = ref(false)
    // 组件模板渲染成功后触发
    onMounted(() => {
      isShow.value = true
    })
    return { style, isShow }
  }
}
</script>
<style scoped lang="less">
.down {
  &-enter {
    &-from {
      transform: translate3d(0, -75px, 0);
      opacity: 0;
    }
    &-active {
      transition: all 0.5s;
    }
    &-to {
      transform: none;
      opacity: 1;
    }
  }
}
.my-message {
  width: 300px;
  height: 50px;
  position: fixed;
  z-index: 9999;
  left: 50%;
  margin-left: -150px;
  top: 25px;
  line-height: 50px;
  padding: 0 25px;
  border: 1px solid #e4e4e4;
  background: #f5f5f5;
  color: #999;
  border-radius: 4px;
  i {
    margin-right: 10px;
    vertical-align: middle;
  }
  .text {
    vertical-align: middle;
  }
}
</style>

和my-message.vue平级目录下新建message.js文件
代码如下（示例）：

// 如下的方法需要渲染一个提示效果
import { createVNode, render } from 'vue'
import MyMessage from './my-message.vue'

// 动态创建一个DOM容器
const div = document.createElement('div')
div.setAttribute('class', 'my-meassage-container')
document.body.appendChild(div)

export default ({ text, type }) => {
  let timer = null
  // createVNode 用于创建一个虚拟节点
  // 参数一支持组件
  // 参数二表示传递给组件的选项
  const vnode = createVNode(MyMessage, { text, type })
  // 把虚拟的节点渲染到页面的DOM中即可
  // render函数的参数
  // 参数一：表示需要渲染的内容（虚拟节点）
  // 参数二：表示渲染的目标位置（DOM元素）
  render(vnode, div)

  // 希望提示信息显示1秒后消失
  clearTimeout(timer)
  timer = setTimeout(() => {
    // 清空div中的内容
    render(null, div)
  }, 1500)
}

// $message({ text: '登录失败', type: 'error'})

平级index.js文件中,在vue实例上新增一个实例方法
代码如下（示例）：

import Message from '@/components/message'
import MyMessage from '@/components/my-message.vue'

export default {
  install (app) {
    app.component(MyMessage.name, MyMessage)
	// 扩展一个实例方法
    app.config.globalProperties.$message = Message
  }
}

本组件使用到的字体图标是阿里CDN上的资源,在public/index.html文件中head里加入如下代码即可

<link rel="stylesheet" href="//at.alicdn.com/t/font_2143783_iq6z4ey5vu.css">

2. 使用

封装的消息提示组件共支持以下三种提醒效果

• 成功（success）
• 失败（error）
• 警告（warn）

在任意.vue结尾文件中使用
代码如下（示例）：

<template>
 <div>
 </div>
</template>

<script>
import { getCurrentInstance } from 'vue'
export default {
  name: 'App',
  setup () {
    const instance = getCurrentInstance()

    instance.proxy.$message({ text: '提示信息', type: 'success' })
  }

}
</script>

<style lang="less">

</style>

注：如需切换提示效果，将type的值切换为上述展示的值即可，text为需要提醒的文本

三、 效果演示

---

总结

notice