基于vite2.x+electron12+element plus中后台管理系统

一款轻量级前端后台管理框架ElectronViteAdmin。

项目基于最新前端技术栈 vite2+electron12+vue3+vuex+element-plus+vue-i18n+echarts 搭建开发，所有的请求都使用Mock.js模拟数据。支持动态权限控制、整合i18n国际化解决方案。

技术框架

• 编码器：VScode
• vue3技术：vite2.1.5+vue3.0+vuex4+vue-router@4
• 跨端框架：electron^12.0.4
• 打包工具：vue-cli-plugin-electron-builder
• 组件库：element-plus (饿了么vue3桌面端组件库)
• 表格拖拽：sortablejs^1.13.0
• 图表组件：echarts^5.1.1
• 国际化：vue-i18n^9.1.6
• 模拟数据：mockjs^1.1.0

特性

• 支持PC及平板自适应布局
• 支持组件式+指令式两种权限认证方式
• 支持中英文/繁体国际化方案
• 支持表格拖拽排序、全屏、树形表格等功能
• 支持多主题换肤切换

项目结构

主入口main.js配置

/**
 * 渲染进程主入口
 * @author XiaoYan
 */
 
import { createApp } from 'vue'
import App from './App.vue'
import Router from './router'
import Store from './store'
 
// 引入公共配置
import gPlugins from './plugins'
 
import { winCfg, loadWin } from './windows/actions'
 
loadWin().then(config => {
    winCfg.window = config
    createApp(App)
    .use(Router)
    .use(Store)
    .use(gPlugins)
    .mount('#app')
})
复制代码

主路由配置Vue-router

/**
 * 路由配置 Router util
 * @author XiaoYan
 */
 
import { createRouter, createWebHashHistory } from "vue-router"
 
import { ElLoading } from "element-plus"
import { loginWin } from "@/windows/actions"
 
import store from '@/store'
 
// 导入公共模板/路由配置
import mainLayout from "@/layouts/main"
import authLayout from "@/layouts/auth"
import mainRoutes from "@/layouts/main/routes.js"
import authRoutes from "@/layouts/auth/routes.js"
 
const RoutesLs = [
    // 主页面模块
    {
        path: '/',
        redirect: '/home/index',
        component: mainLayout,
        children: mainRoutes,
    },
    // 验证模块
    {
        path: '/auth',
        redirect: '/auth/login',
        component: authLayout,
        children: authRoutes,
    },
    // 错误模块
    {
        path: '/:pathMatch(.*)*',
        component: () => import('@/views/error/404.vue'),
        meta: {
            title: 'app__global-page-notfound',
        }
    }
]
 
const router = createRouter({
    history: createWebHashHistory(),
    routes: RoutesLs,
})

let loadingIns
router.beforeEach((to, from, next) => {
    // 开启加载提示
    loadingIns = ElLoading.service({
        lock: true,
        text: 'Loading...',
        spinner: 'el-icon-loading',
        background: 'rgba(19, 209, 122, .1)'
    })
 
    // 判断当前路由状态
    const isLogined = store.state.isLogin
    if(to.meta.auth) {
        if(isLogined) {
            next()
        }else {
            loginWin()
            loadingIns.close()
        }
    }else {
        next()
    }
})
 
router.afterEach(() => {
    loadingIns.close()
})
复制代码

Electron+Vite2.x 仿mac导航栏

<!-- //仿Mac导航条 -->
<template>
    <WinBar zIndex="1000">
        <template #wbtn>
            <MsgMenu />
            <Lang />
            <a class="wbtn" @click="handleSkinWin"><i class="iconfont icon-huanfu"></i></a>
            <Setting />
            <a class="wbtn" @click="handleRefresh"><i class="iconfont el-icon-refresh"></i></a>
            <a class="wbtn" :class="{'on': isAlwaysOnTop}" :title="isAlwaysOnTop ? '取消置顶' : '置顶'" @click="handleAlwaysTop"><i class="iconfont icon-ding"></i></a>
            <Avatar @logout="handleLogout" />
        </template>
    </WinBar>
</template>
复制代码

Vite2.x+Echarts动态化图标Hook

/**
 * 动态化图表Hook
 * @author XiaoYan
 */
 
import { onMounted, onBeforeUnmount, ref } from "vue"
import * as echarts from "echarts"
import elementResizeDetectorMaker from "element-resize-detector"
import utils from "@/utils"
 
export default function useChart(refs, options) {
    let chartInst
    let chartRef = ref(null)
    let erd = elementResizeDetectorMaker()
 
    const handleResize = utils.debounce(() => {
        chartInst.resize()
    }, 100)
 
    onMounted(() => {
        if(refs.value) {
            chartInst = echarts.init(refs.value)
            chartInst.setOption(options)
            chartRef.value = chartInst
        }
        // window.addEventListener('resize', handleResize)
        erd.listenTo(refs.value, handleResize)
    })
 
    onBeforeUnmount(() => {
        chartInst.dispose()
        // window.removeEventListener('resize', handleResize)
        erd.removeListener(refs.value, handleResize)
    })
 
    return chartRef
}
复制代码

使用element-resize-detector来监听窗口及内容区尺寸变化。

主模块布局

<!-- //Main主模块模板 -->
<template>
    <div class="vadmin__wrapper" :style="{'--themeSkin': store.state.skin}">
        <div v-if="!route.meta.isNewin" class="vadmin__layouts-main flexbox flex-col">
            <!-- //顶部导航 -->
            <div class="layout__topbar">
                <TopNav />
            </div>
            
            <div class="layout__workpanel flex1 flexbox">
                <!-- //侧边栏 -->
                <div v-show="rootRouteEnable" class="panel__leftlayer">
                    <SideMenu :routes="mainRoutes" :rootRoute="rootRoute" />
                </div>
 
                <!-- //中间栏 -->
                <div class="panel__middlelayer" :class="{'collapsed': collapsed}">
                    <RouteMenu 
                        :routes="getAllRoutes" 
                        :rootRoute="rootRoute" 
                        :defaultActive="defaultActive" 
                        :rootRouteEnable="rootRouteEnable" 
                    />
                </div>
 
                <!-- //右边栏 -->
                <div class="panel__rightlayer flex1 flexbox flex-col">
                    <!-- 面包屑导航 -->
                    <BreadCrumb />
                    
                    <!-- 主内容区 -->
                    <v3-scroll autohide>
                        <div class="lay__container">
                            <!-- //路由权限控制 -->
                            <permission :roles="route.meta.roles">
                                <template #tooltips>
                                    <Forbidden />
                                </template>
                                <router-view></router-view>
                            </permission>
                        </div>
                    </v3-scroll>
                </div>
            </div>
        </div>
        <router-view v-else class="vadmin__layouts-main flexbox flex-col"></router-view>
    </div>
</template>
复制代码

国际化方案vue-i18n

目前vue-i18n已经支持了vue3项目。

npm i vue-i18n@next

/**
 * @desc	vue-i18n国际化配置文件
 * @Time	andy by 2021-05
 * @Author      Q：282310962  wx：xy190310
 */
 
import { createI18n } from 'vue-i18n'
import Storage from '@/utils/storage'
 
// 默认设置
export const langKey = 'lang'
export const langVal = 'zh-CN'
 
/**
 * 引入element-plus国际化包
 */
import enUS from 'element-plus/lib/locale/lang/en'
import zhCN from 'element-plus/lib/locale/lang/zh-cn'
import zhTW from 'element-plus/lib/locale/lang/zh-tw'
export const ElPlusLang = {
    'en-US': enUS,
    'zh-CN': zhCN,
    'zh-TW': zhTW
}
 
/**
 * 初始化多语言
 */
export const $messages = importLang()
export const $lang = getLang()
const i18n = createI18n({
    legacy: false,
    locale: $lang,
    messages: $messages
})
 
/**
 * 自动导入语言配置
 */
export function importLang() {
    const localeModule = {}
    try {
        // 导入 @/layouts 文件夹下包含子目录locale中的xxx.js文件
        const layoutsCtx = require.context('@/layouts', true, /[/\\]locale[/\\]([a-z]{2})-?([A-Z]{2})?\.js$/)
        layoutsCtx.keys().map(path => {
            const pathCtx = layoutsCtx(path)
            if(pathCtx.default) {
                const pathName = path.replace(/(.*\/)*([^.]+).*/ig, '$2')
                if(localeModule[pathName]) {
                    localeModule[pathName] = {
                        ...localeModule[pathName], ...pathCtx.default
                    }
                }else {
                    localeModule[pathName] = pathCtx.default
                }
            }
        })
    } catch (error) {
        console.log(error)
    }
 
    return localeModule
}
 
/**
 * 存储设置语言
 * @param lang 语言类型 zh-CN | zh-TW | en-US
 */
export function setLang(lang, reload = false) {
    if(getLang() !== lang) {
        Storage.set(langKey, lang || '')
        // 设置全局语言
        i18n.global.locale.value = lang
 
        if(reload) {
            window.location.reload()
        }
    }
}
 
/**
 * 获取语言
 */
export function getLang() {
    const lang = Storage.get(langKey)
    return lang || langVal
}
复制代码

OK，基于vite.js+electron跨端中后台管理系统就分享到这里。

欢迎大家一起交流分享前端热门技术及最新实例项目。

juejin.cn/post/694428…