Vue3.0网页版聊天|Vue3.x+ElementPlus仿微信/QQ界面|vue3聊天实例

一、项目简介

基于vue3.x+vuex+vue-router+element-plus+v3layer+v3scroll等技术构建的仿微信web桌面端聊天实战项目Vue3-Webchat。基本上实现发送消息+emoj表情、图片/视频查看、链接预览、粘贴截图/拖拽发送图片、红包/朋友圈等功能。

二、使用技术

• 编码器：Vscode
• 技术框架：Vue3.0.5+Vuex4+VueRouter@4
• UI组件库：Element-Plus (饿了么桌面端vue3组件库)
• 弹窗组件：V3Layer（基于vue3.x自定义对话框组件）
• 滚动条组件：V3Scroll（基于vue3.x自定义虚拟美化滚动条组件）
• 字体图标：阿里iconfont图标库

三、项目结构目录

◆ 一览效果

◆ vue3.x封装自定义弹窗组件

为了整体效果一致性，项目中用到的所有弹窗功能均是自定义组件v3layer来实现。

V3Layer 基于vue3.0开发的pc端自定义弹窗组件，支持拖拽(自定义拖拽区)、缩放、最大化、全屏、置顶弹框等功能。

由于之前有过一篇详细的介绍分享，感兴趣的话可以去看下哈。

https://www.cnblogs.com/xiaoyan2017/p/14221729.html

其实v3layer弹窗是在原先的vue2版本中演变而来，专门为vue3项目而开发的，并且在功能及效果上和v2版的保持一致。

vue2.x pc端自定义全局弹窗组件|vue2桌面端对话框组件

◆ vue3.x自定义美化模拟滚动条

为了使得项目中页面滚动条更加精致，这里采用了自定义模拟滚动条vscroll组件来替代原生滚动条。

V3Scroll 基于vue3.0开发的小巧模拟滚动条组件。支持自定义滚动条大小、颜色、层级及自动隐藏等功能。

并且支持实时监测DOM尺寸改变来动态更新滚动条。

https://www.cnblogs.com/xiaoyan2017/p/14242983.html

◆ vue3.x聊天主面板

项目整体分为右上按钮、侧边栏、中间区、主体内容区三个模块。

<div :class="['vui__wrapper', store.state.isWinMaximize&&'maximize']">
  <div class="vui__board flexbox">
    <div class="flex1 flexbox">
      <!-- 顶部按钮(最大、最小、关闭) -->
      <WinBar v-if="!route.meta.hideWinBar" />

      <!-- 侧边栏 -->
      <SideBar v-if="!route.meta.hideSideBar" class="nt__sidebar flexbox flex-col" />

      <!-- 中间栏 -->
      <Middle v-show="!route.meta.hideMiddle" />

      <!-- 主内容区 -->
      <router-view class="nt__mainbox flex1 flexbox flex-col"></router-view>
    </div>
  </div>
</div>

◆ 引入|注册公共组件

// 引入饿了么vue3组件库
import ElementPlus from 'element-plus'
import 'element-plus/lib/theme-chalk/index.css'

// 引入vue3.x弹窗组件
import V3Layer from '../components/v3layer'

// 引入vue3.x滚动条组件
import V3Scroll from '@components/v3scroll'

// 引入公共组件
import WinBar from '../layouts/winbar.vue'
import SideBar from '../layouts/sidebar'
import Middle from '../layouts/middle'

import Utils from './utils'

const Plugins = app => {
    app.use(ElementPlus)
    app.use(V3Layer)
    app.use(V3Scroll)

    // 注册公共组件
    app.component('WinBar', WinBar)
    app.component('SideBar', SideBar)
    app.component('Middle', Middle)

    app.provide('utils', Utils)
}

项目中背景整体采用虚化毛玻璃效果。通过 svg filter 来实现。

<!-- //虚化背景（毛玻璃） -->
<div class="vui__bgblur">
  <svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="100%" height="100%" class="blur-svg" viewBox="0 0 1920 875" preserveAspectRatio="none">
    <filter id="blur_mkvvpnf"><feGaussianBlur in="SourceGraphic" stdDeviation="50"></feGaussianBlur></filter>
    <image :xlink:href="store.state.skin" x="0" y="0" width="100%" height="100%" externalResourcesRequired="true" xmlns:xlink="http://www.w3.org/1999/xlink" style="filter:url(#blur_mkvvpnf)" preserveAspectRatio="none"></image>
  </svg>
  <div class="blur-cover"></div>
</div>

◆ vue3.x表单验证/登录状态拦截

vue3中实现表单验证+60s倒计时操作。

<script>
import { reactive, toRefs, inject, getCurrentInstance } from 'vue'
export default {
    components: {},
    setup() {
        const { ctx } = getCurrentInstance()
        const v3layer = inject('v3layer')
        const utils = inject('utils')

        const formObj = reactive({})
        const data = reactive({
            vcodeText: '获取验证码',
            disabled: false,
            time: 0,
        })

        const VTips = (content) => {
            v3layer({
                content: content, layerStyle: 'background:#ff5151;color:#fff;', time: 2
            })
        }

        const handleSubmit = () => {
            if(!formObj.tel){
                VTips('手机号不能为空！')
            }else if(!utils.checkTel(formObj.tel)){
                VTips('手机号格式不正确！')
            }else if(!formObj.pwd){
                VTips('密码不能为空！')
            }else if(!formObj.vcode){
                VTips('验证码不能为空！')
            }else{
                ctx.$store.commit('SET_TOKEN', utils.setToken());
                ctx.$store.commit('SET_USER', formObj.tel);

                // ...
            }
        }

        // 60s倒计时
        const handleVcode = () => {
            if(!formObj.tel) {
                VTips('手机号不能为空！')
            }else if(!utils.checkTel(formObj.tel)) {
                VTips('手机号格式不正确！')
            }else {
                data.time = 60
                data.disabled = true
                countDown()
            }
        }
        const countDown = () => {
            if(data.time > 0) {
                data.vcodeText = '获取验证码('+ data.time +')'
                data.time--
                setTimeout(countDown, 1000)
            }else{
                data.vcodeText = '获取验证码'
                data.time = 0
                data.disabled = false
            }
        }

        return {
            formObj,
            ...toRefs(data),
            handleSubmit,
            handleVcode
        }
    }
}
</script>

vue3路由钩子实现全局登录状态拦截判断。

import { createRouter, createWebHistory } from 'vue-router'

import store from '../store'

import V3Layer from '@components/v3layer'

const routesLS = [
    // 登录|注册
    {
        name: 'login', path: '/login',
        component: () => import('../views/auth/login.vue'),
        meta: { hideWinBar: true, hideSideBar: true, hideMiddle: true }
    },

    // ...
]

const router = createRouter({
    history: createWebHistory(),
    routes: routesLS,
})

// 全局钩子拦截登录状态
router.beforeEach((to, from, next) => {
    const token = store.state.token

    // 判断当前路由地址是否需要登录权限
    if(to.meta.requireAuth) {
        if(token) {
            next()
        }else {
            // 未登录授权
            V3Layer({
                content: '还未登录授权！', position: 'top', time: 2,
                onEnd: () => {
                    next({ path: '/login' })
                }
            })
        }
    }else {
        next()
    }
})

◆ vue3.x聊天模块

聊天编辑器模块继续采用分离公共调用方式。支持多行文本、文字+emoj表情混排、光标处插入表情、粘贴截图发送等功能。

/**
 * @Desc     vue3.x仿微信桌面端聊天
 * @Time     andy by 2021-01
 * @About    Q：282310962  wx：xy190310
 */
<script>
import { onMounted, ref, reactive, toRefs, watch, nextTick, inject } from 'vue'
import { useRoute } from 'vue-router'

import Editor from './editor.vue'
import SendRedPacket from './redPacket.vue'
import GroupSet from './groupInfo.vue'

// ...

export default {
    components: {
        Editor,
        SendRedPacket,
        GroupSet
    },
    setup() {
        const scrollRef = ref(null)
        const editorRef = ref(null)

        const route = useRoute()

        const v3layer = inject('v3layer')

        const data = reactive({
            editorText: '',

            showEmojView: false,

            isSubmitDisabled: true,

            // ...
        })

        // ...

        // 获取群组信息
        const getGroupJSON = () => {
            msgJSON.map((item) => {
                if(item.cid == route.query.id) {
                    data.groupLs = item
                }
            })
            // 定位消息到底部
            nextTick(() => {
                imgLoaded(scrollRef)
            })
        }

        // ...

        /**
         * 编辑器粘贴事件
         * @param img 返回粘贴图片地址
        */
        const handleEditorPaste = (img) => {
            let msgLs = data.groupLs.msglist
            let len = msgLs.length
            // 消息队列
            let arrLS = {
                // ...
            }
            msgLs = msgLs.concat(arrLS)
            data.groupLs.msglist = msgLs

            nextTick(() => { imgLoaded(scrollRef) })
        }

        // 点击表情
        const handleEmojClicked = (e) => {
            let faceimg = e.target.cloneNode(true)
            editorRef.value.insertHtmlAtCursor(faceimg)
            data.showEmojView = false
        }

        // 点击表情gif
        const handleEmojGifClicked = (path) => {
            let msgLs = data.groupLs.msglist
            let len = msgLs.length
            // 消息队列
            let arrLS = {
                // ...
            }
            msgLs = msgLs.concat(arrLS)
            data.groupLs.msglist = msgLs
            data.showEmojView = false

            nextTick(() => { imgLoaded(scrollRef) })
        }

        /* ---------- { 选择功能模块 } ---------- */
        // 选择视频
        const handleChooseVideo = () => {
            let msgLs = data.groupLs.msglist
            let len = msgLs.length
            // 消息队列
            let arrLS = {
                // ...
            }

            let file = pickVideoRef.value.files[0]
            if(!file) return
            let size = Math.floor(file.size / 1024)
            if(size > 5*1024) {
                v3layer({content: '请选择5MB以内的视频！'})
                return false
            }
            // 获取视频地址
            let videoUrl
            if(window.createObjectURL != undefined) {
                videoUrl = window.createObjectURL(file)
            } else if (window.URL != undefined) {
                videoUrl = window.URL.createObjectURL(file)
            } else if (window.webkitURL != undefined) {
                videoUrl = window.webkitURL.createObjectURL(file)
            }

            let $video = document.createElement('video')
            $video.src = videoUrl
            // 截取视频第一帧为封面
            $video.addEventListener('loadeddata', function() {
                setTimeout(() => {
                    var canvas = document.createElement('canvas')
                    canvas.width = $video.videoWidth * .8
                    canvas.height = $video.videoHeight * .8
                    canvas.getContext('2d').drawImage($video, 0, 0, canvas.width, canvas.height)
                    arrLS.imgsrc = canvas.toDataURL('image/png')

                    arrLS.videosrc = videoUrl
                    msgLs = msgLs.concat(arrLS)
                    data.groupLs.msglist = msgLs

                    nextTick(() => { imgLoaded(scrollRef) })
                }, 16);
            })
        }

        /* ---------- { 拖拽功能模块 } ---------- */
        const handleDragEnter = (e) => {
            e.stopPropagation()
            e.preventDefault()
        }
        const handleDragOver = (e) => {
            e.stopPropagation()
            e.preventDefault()
        }
        const handleDrop = (e) => {
            e.stopPropagation()
            e.preventDefault()
            // console.log(e.dataTransfer)

            handleFileList(e.dataTransfer)
        }
        // 获取拖拽文件列表
        const handleFileList = (filelist) => {
            let files = filelist.files
            if(files.length >= 2) {
                v3layer.message({icon: 'error', content: '暂时支持拖拽一张图片', shade: true, layerStyle: {background:'#ffefe6',color:'#ff3838'}})
                return false
            }
            for(let i = 0; i < files.length; i++) {
                if(files[i].type != '') {
                    handleFileAdd(files[i])
                }else {
                    v3layer.message({icon: 'error', content: '目前不支持文件夹拖拽功能', shade: true, layerStyle: {background:'#ffefe6',color:'#ff3838'}})
                }
            }
        }
        const handleFileAdd = (file) => {
            let msgLs = data.groupLs.msglist
            let len = msgLs.length
            // 消息队列
            let arrLS = {
                // ...
            }

            if(file.type.indexOf('image') == -1) {
                v3layer.message({icon: 'error', content: '目前不支持非图片拖拽功能', shade: true, layerStyle: {background:'#ffefe6',color:'#ff3838'}})
            }else {
                let reader = new FileReader()
                reader.readAsDataURL(file)
                reader.onload = function() {
                    let img = this.result

                    // ...
                }
            }
        }

        /* ---------- { 其他功能模块 } ---------- */
        // 提示信息
        const handleTipsLayer = (e) => {
            let pos = [e.clientX+25, e.clientY-110]
            v3layer.popover({
                icon: 'info',
                title: 'Tips',
                content: '<div class="pb-10">编辑框支持<b class="bg-00e077 c-fff">拖拽</b>或<b class="bg-00e077 c-fff">截屏粘贴</b>发送图片！<br />支持自动<b class="bg-00e077 c-fff">链接</b>识别！</div>',
                follow: pos,
                shade: true,
                opacity: .2,
            })
        }

        // 红包弹窗
        const handleRedpacketLayer = (item) => {
            data.isShowRedPacket = true
            data.redPacketList = item
        }

        // ...

        return {
            ...toRefs(data),

            scrollRef,
            editorRef,

            handleMsgClicked,

            handleEmojView,
            handleEmojTab,

            handleEditorClick,
            handleEditorFocus,
            handleEditorBlur,
            handleEditorPaste,
            handleEmojClicked,

            // ...
        }
    }
}
</script>

Ok，以上就是使用Vue3+ElementPlus开发网页端仿微信/QQ界面聊天的分享。