react18-webchat網頁聊天實例|React Hooks+Arco Design仿微信桌面端

React18 Hooks+Arco-Design+Zustand仿微信客戶端聊天ReactWebchat。 react18-webchat基於react18+vite4.x+arco-design+zustand等技術開發的一款仿製微信網頁版聊天實戰項目。實現發送帶有emoj消息文本、圖片/視頻預 ...

React18 Hooks+Arco-Design+Zustand仿微信客戶端聊天ReactWebchat。

react18-webchat基於react18+vite4.x+arco-design+zustand等技術開發的一款仿製微信網頁版聊天實戰項目。實現發送帶有emoj消息文本、圖片/視頻預覽、紅包/朋友圈、局部模塊化刷新/美化滾動條等功能。

使用技術

編輯器：vscode
技術棧：react18+vite4+react-router-dom+zustand+sass
組件庫：@arco-design/web-react (位元組跳動react組件庫)
狀態管理：zustand^4.4.1
路由管理：react-router-dom^6.15.0
className拼合：clsx^2.0.0
對話框組件：rdialog (基於react18 hooks自定義桌面端彈窗組件)
預處理樣式：sass^1.66.1

項目目錄結構

使用vite4.x創建react18項目，目錄線性結構如下。

react-webchat 項目全部採用react18 hooks規範編碼開發，使用到的對話框及虛擬滾動條均是自研組件實現功能效果。

react18 hooks自定義對話框+美化滾動條

大家看到的彈窗及滾動條組件都是自定義組件實現功能場景。

// 引入對話框組件
import RDialog, { rdialog } from '@/components/rdialog'

// 組件式調用
<RDialog
    visible={confirmVisible}
    title="標題信息"
    content="對話框內容信息"
    closeable
    shadeClose={false}
    zIndex="2050"
    dragOut
    maxmin
    btns={[
        {text: '取消', click: () => setConfirmVisible(false)},
        {text: '確定', click: handleInfo}
    ]}
    onClose={()=>setConfirmVisible(false)}
/>

// 函數式調用
rdialog({
    title: '標題信息',
    content: '對話框內容信息',
    closeable: true,
    shadeClose: false,
    zIndex: 2050,
    dragOut: true,
    maxmin: true,
    btns: [
        {text: '取消', click: rdialog.close()},
        {text: '確定', click: handleInfo}
    ]
})

react-scrollbar美化系統滾動條調用非常簡單，需要包裹需要滾動的內容塊即可快速生成一個虛擬滾動條。

// 引入滾動條組件
import RScroll from '@/components/rscroll'

<RScroll autohide maxHeight={100}>
    包裹需要滾動的內容塊。。。
</RScroll>

main.jsx入口配置

import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App.jsx'
import '@arco-design/web-react/dist/css/arco.css'
import './style.scss'

ReactDOM.createRoot(document.getElementById('root')).render(<App />)

App.jsx配置

import { HashRouter } from 'react-router-dom'

// 引入useRoutes集中式路由配置文件
import Router from './router'

function App() {
    return (
        <>
            <HashRouter>
              <Router />
            </HashRouter>
        </>
    )
}

export default App

react18-router-dom配置

自定義路由占位模板，有點類似vue裡面的router-view占位。

// 路由占位模板(類似vue中router-view)
const RouterLayout = () => {
    const authState = authStore()
    return (
        <div className="rc__container flexbox flex-alignc flex-justifyc" style={{'--themeSkin': authState.skin}}>
            <div className="rc__layout flexbox flex-col">
                {/* <div className="rc__layout-header">頂部欄</div> */}
                <div className="rc__layout-body flex1 flexbox">
                    {/* 菜單欄 */}
                    <Menu />

                    {/* 中間欄 */}
                    <Aside />

                    {/* 主內容區 */}
                    <div className="rc__layout-main flex1 flexbox flex-col">
                        { lazyload(<Outlet />) }
                    </div>
                </div>
            </div>
        </div>
    )
}

路由配置文件

/**
 * react-router路由配置 by HS Q：282310962
*/

import { lazy, Suspense } from 'react'
import { useRoutes, Outlet, Navigate } from 'react-router-dom'
import { Spin } from '@arco-design/web-react'

import { authStore } from '@/store/auth'

// 引入路由頁面
import Login from '@views/auth/login'
import Register from '@views/auth/register'
const Index = lazy(() => import('@views/index'))
const Contact = lazy(() => import('@views/contact'))
const Uinfo = lazy(() => import('@views/contact/uinfo'))
const NewFriend = lazy(() => import('@views/contact/newfriend'))
const Chat = lazy(() => import('@views/chat/chat'))
const ChatInfo = lazy(() => import('@views/chat/info'))
const RedPacket = lazy(() => import('@views/chat/redpacket'))
const Fzone = lazy(() => import('@views/my/fzone'))
const Favorite = lazy(() => import('@views/my/favorite'))
const Setting = lazy(() => import('@views/my/setting'))
const Error = lazy(() => import('@views/404'))

import Menu from '@/layouts/menu'
import Aside from '@/layouts/aside'

// 載入提示
const SpinLoading = () => {
    return (
        <div className="rcLoading">
            <Spin size="20" tip='loading...' />
        </div>
    )
}

// 延遲載入
const lazyload = children => {
    // React 16.6 新增了<Suspense>組件,讓你可以“等待”目標代碼載入,並且可以直接指定一個載入的界面，讓它在用戶等待的時候顯示
    // 路由懶載入報錯：react-dom.development.js:19055 Uncaught Error: A component suspended while responding to synchronous input.
    // 懶載入的模式需要我們給他加上一層 Loading的提示載入組件
    return <Suspense fallback={<SpinLoading />}>{children}</Suspense>
}

// 路由鑒權驗證
const RouterAuth = ({ children }) => {
    const authState = authStore()

    return authState.isLogged ? (
        children
    ) : (
        <Navigate to="/login" replace={true} />
    )
}

export const routerConfig = [
    {
        path: '/',
        element: <RouterAuth><RouterLayout /></RouterAuth>,
        children: [
            // 首頁
            { index: true, element: <Index /> },

            // 通訊錄模塊
            { path: '/contact', element: <Contact /> },
            { path: '/uinfo', element: <Uinfo /> },
            { path: '/newfriend', element: <NewFriend /> },

            // 聊天模塊
            { path: '/chat', element: <Chat /> },
            { path: '/chatinfo', element: <ChatInfo /> },
            { path: '/redpacket', element: <RedPacket /> },

            // 我的模塊
            { path: '/fzone', element: <Fzone /> },
            { path: '/favorite', element: <Favorite /> },
            { path: '/setting', element: <Setting /> },

            // 404模塊 path="*"不能省略
            { path: '*', element: <Error /> }
        ]
    },
    // 登錄/註冊
    { path: '/login', element: <Login /> },
    { path: '/register', element: <Register /> }
]

const Router = () => useRoutes(routerConfig)

export default Router

react新狀態管理器Zustand

這次開發react項目沒有使用redux作為狀態管理，而是使用支持react18 hooks新一代狀態管理庫Zustand。

// NPM
npm install zustand

// Yarn
yarn add zustand

zustand提供了內置的persist本地持久化存儲管理。

/**
 * react18狀態管理庫Zustand
*/
import { create } from 'zustand'
import { persist, createJSONStorage } from 'zustand/middleware'

export const authStore = create(
    persist(
        (set, get) => ({
            isLogged: false,
            token: null,
            // 摺疊側邊欄
            collapse: false,
            // 個性換膚
            skin: null,
            // 登錄數據
            loggedData: (data) => set({isLogged: data.isLogged, token: data.token}),
            setCollapse: (v) => set({collapse: v}),
            setSkin: (v) => set({skin: v})
        }),
        {
            name: 'authState',
            // name: 'auth-store', // name of the item in the storage (must be unique)
            // storage: createJSONStorage(() => sessionStorage), // by default, 'localStorage'
        }
    )
)

react18-chat聊天模塊

聊天區域支持拖拽發送圖片、編輯框支持多行文本、游標處插入emoj表情符。

return (
    <div
        {...rest}
        ref={editorRef}
        className={clsx('editor', className)}
        contentEditable
        onClick={handleClick}
        onInput={handleInput}
        onFocus={handleFocus}
        onBlur={handleBlur}
        style={{'userSelect': 'text', 'WebkitUserSelect': 'text'}}
    />
)

獲取輸入游標位置

// 獲取游標最後位置
const getLastCursor = () => {
    let sel = window.getSelection()
    if(sel && sel.rangeCount > 0) {
        return sel.getRangeAt(0)
    }
}

游標處插入內容

// 游標處插入emoj表情符內容
const insertHtmlAtCursor = (html) => {
    let sel, range
    if(!editorRef.current.childNodes.length) {
        editorRef.current.focus()
    }

    if(window.getSelection) {
        // IE9及其它瀏覽器
        sel = window.getSelection()

        // ##註意：判斷最後游標位置
        if(lastCursor.current) {
            sel.removeAllRanges()
            sel.addRange(lastCursor.current)
        }

        if(sel.getRangeAt && sel.rangeCount) {
            range = sel.getRangeAt(0)
            range.deleteContents()
            let el = document.createElement('div')
            el.appendChild(html)
            var frag = document.createDocumentFragment(), node, lastNode
            while ((node = el.firstChild)) {
                lastNode = frag.appendChild(node)
            }
            range.insertNode(frag)
            if(lastNode) {
                range = range.cloneRange()
                range.setStartAfter(lastNode)
                range.collapse(true)
                sel.removeAllRanges()
                sel.addRange(range)
            }
        }
    } else if(document.selection && document.selection.type != 'Control') {
        // IE < 9
        document.selection.createRange().pasteHTML(html)
    }

    // 執行輸入操作
    handleInput()
}