Electron31-ViteAdmin桌面端后台|vite5.x+electron31+element-plus管理系统Exe

原创自研Vue3+Electron31+ElementPlus桌面端轻量级后台管理Exe系统。

基于最新前端技术栈Vite5.x、Vue3、Electron31、ElementPlus、Vue-I18n、Echarts实战开发桌面端高颜值后台管理模板。内置4种布局模板，支持i18n国际化、动态权限路由，实现了表格、表单、图表、列表、编辑器等常见的业务模块。

在这里插入图片描述

electron-viteadmin封装了多窗口管理，支持同时开启多个窗体。

在这里插入图片描述

运用技术

编辑器：vscode
框架技术：vite5.3+vue3.4+vue-router^4.4
跨平台框架：electron^31.3
组件库：element-plus^2.7.8
状态管理：pinia^2.2.0
国际化方案：vue-i18n@9
图表组件：echarts^5.5.1
markdown编辑器：md-editor-v3^4.18.0
模拟数据：mockjs^1.1.0
打包工具：electron-builder^24.13.3

在这里插入图片描述

项目框架结构

electron-vue3admin 整合vite5+electron技术，采用vue3 setup语法编码。

在这里插入图片描述

目前electron-vue3admin已经同步到我的原创作品集，欢迎下载使用。
自研Electron31+Vue3+ElementPlus桌面端后台管理系统

在这里插入图片描述

特性

最新前端技术栈electron31、vite5、vue3、elementPlus、vue-i18n、echarts
支持中英文/繁体国际化解决方案
支持动态权限路由、多页签缓存路由
封装多窗口管理器，内置4种通用布局模板、自由切换风格
整合通用的表格、表单、列表、图表、编辑器、错误处理等模块
高颜值UI界面、轻量级模块化、高定制性

在这里插入图片描述

electron主进程配置

import { app, BrowserWindow } from 'electron'

import { WindowManager } from '../src/windows/index.js'

// 忽略安全警告提示 Electron Security Warning (Insecure Content-Security-Policy)
process.env['ELECTRON_DISABLE_SECURITY_WARNINGS'] = true

const createWindow = () => {
  let win = new WindowManager()
  win.create({isMajor: true})
  // 系统托盘管理
  win.trayManager()
  // 监听ipcMain事件
  win.ipcManager()
}

app.whenReady().then(() => {
  createWindow()

  app.on('activate', () => {
    if(BrowserWindow.getAllWindows().length === 0) createWindow()
  })
})

app.on('window-all-closed', () => {
  if(process.platform !== 'darwin') app.quit()
})

vue3入口文件main.js

import { createApp } from 'vue'
import './style.scss'
import App from './App.vue'

import { launchApp } from '@/windows/actions'

// 引入路由和状态配置
import Router from './router'
import Pinia from './pinia'

// 引入插件配置
import Plugins from './plugins'

launchApp().then(config => {
  if(config) {
    console.log('窗口参数:', config)
    console.log('窗口id:', config?.id)

    // 全局存储窗口配置
    window.config = config
  }

  // 初始化app应用实例
  createApp(App)
  .use(Router)
  .use(Pinia)
  .use(Plugins)
  .mount('#app')
})

在这里插入图片描述

electron31-admin布局模板

在这里插入图片描述
提供了4种常用的布局模板。也可以根据需求定制化模板。

在这里插入图片描述

/**
 * 通用布局模板
 * @author Andy Q：282310962
*/

<script setup>
  import { appState } from '@/pinia/modules/app'

  // 引入布局模板
  import Classic from './template/classic/index.vue'
  import Columns from './template/columns/index.vue'
  import Vertical from './template/vertical/index.vue'
  import Horizontal from './template/horizontal/index.vue'

  const appstate = appState()

  const LayoutMap = {
    'classic': Classic,
    'columns': Columns,
    'vertical': Vertical,
    'horizontal': Horizontal
  }
</script>

<template>
  <div class="vuadmin__container" :style="{'--themeSkin': appstate.config.skin}">
    <component :is="LayoutMap[appstate.config.layout]" />
  </div>
</template>

electron+vue3国际化解决方案

在这里插入图片描述

采用vue-i18n国际化方案，支持中文/英文/繁体三种语言。

在这里插入图片描述

/**
 * 国际化配置
 * @author YXY
 */

import { createI18n } from 'vue-i18n'
import { appState } from '@/pinia/modules/app'

// 引入语言配置
import enUS from './en-US'
import zhCN from './zh-CN'
import zhTW from './zh-TW'

// 默认语言
export const langVal = 'zh-CN'

export default async (app) => {
  const appstate = appState()
  const lang = appstate.lang || langVal
  appstate.setLang(lang)

  const i18n = createI18n({
    legacy: false,
    locale: lang,
    messages: {
      'en': enUS,
      'zh-CN': zhCN,
      'zh-TW': zhTW
    }
  })
  
  app.use(i18n)
}

electron+vue3封装图表

在这里插入图片描述

/**
 * 动态图表Hook
 */

import { onMounted, onBeforeUnmount, ref } from 'vue'
import * as echarts from 'echarts'
import elementResizeDetectorMaker from 'element-resize-detector'

export function useEcharts(el, options) {
  let chartEl
  let chartRef = ref(null)
  let erd = elementResizeDetectorMaker()

  const resizeHandle = () => {
    chartEl && chartEl.resize()
  }

  onMounted(() => {
    if(el?.value) {
      chartEl = echarts.init(el.value)
      chartEl.setOption(options)
      chartRef.value = chartEl
    }
    erd.listenTo(el.value, resizeHandle)
  })

  onBeforeUnmount(() => {
    chartEl.dispose()
    erd.removeListener(el.value, resizeHandle)
  })

  return chartRef
}

vue3封装路由菜单

在这里插入图片描述

内置的4种布局模板，提供了4种不同形式的路由菜单。

<Menus :rootRouteEnable="false" />

<Menus rootRouteEnable :dark="true" />

<Menus mode="horizontal" :dark="true" />

<script setup>
  import { ref, computed } from 'vue'
  import { isObject, isArray, isImg } from '@/utils'
  import { appState } from '@/pinia/modules/app'
  import { useRoutes } from '@/hooks/useRoutes'

  const props = defineProps({
    // 菜单模式(vertical|horizontal)
    mode: { type: String, default: 'vertical' },
    // 是否开启一级路由菜单
    rootRouteEnable: { type: Boolean, default: true },
    // 是否暗黑模式
    dark: { type: Boolean }
  })

  import Submenu from './submenu.vue'

  // 引入主路由表
  import routes from '@/router/modules/main.js'

  const appstate = appState()
  const { route, getActiveRoute, getCurrentRootRoute, getTreeRoutes } = useRoutes()

  const activeRoute = computed(() => getActiveRoute(route))
  const rootRoute = computed(() => getCurrentRootRoute(route))
  const treeRoutes = computed(() => getTreeRoutes(routes))

  const filterRoutes = computed(() => {
    if(props.rootRouteEnable) {
      return treeRoutes.value
    }
    // 过滤一级路由菜单
    return treeRoutes.value.find(item => item.path === rootRoute.value && item.children)?.children
  })
</script>

<template>
  <div class="vu__menubar" :class="{'is-dark': dark, 'is-collapsed': mode == 'vertical' && appstate.config.collapsed}">
    <el-menu class="vu__menus" :default-active="activeRoute" :mode="mode" :collapse="appstate.config.collapsed">
      <Submenu
        v-for="route in filterRoutes"
        :key="route.path"
        :item="route"
        :rootRoute="rootRoute"
        :rootRouteEnable="rootRouteEnable"
      />
    </el-menu>
  </div>
</template>

vue3自定义多标签tab路由

在这里插入图片描述

<template>
  <div class="vu__tabview">
    <el-tabs
      v-model="activeTab"
      class="vu__tabview-tabs"
      @tab-change="changeTabs"
      @tab-remove="removeTab"
    >
    <el-tab-pane
      v-for="(item, index) in tabList"
      :key="index"
      :name="item.path"
      :closable="!item?.meta?.isAffix"
    >
      <template #label>
        <el-dropdown ref="dropdownRef" trigger="contextmenu" :id="item.path" @visible-change="handleDropdownChange($event, item.path)" @command="handleDropdownCommand($event, item)">
          <span class="vu__tabview-tabs__label">
            <span>{{$t(item?.meta?.title)}}</span>
          </span>
          <template #dropdown>
            <el-dropdown-menu>
              <el-dropdown-item command="refresh" :icon="Refresh">{{$t('tabview__contextmenu-refresh')}}</el-dropdown-item>
              <el-dropdown-item command="close" :icon="Close" :disabled="item.meta.isAffix">{{$t('tabview__contextmenu-close')}}</el-dropdown-item>
              <el-dropdown-item command="closeOther" :icon="Switch">{{$t('tabview__contextmenu-closeother')}}</el-dropdown-item>
              <el-dropdown-item command="closeLeft" :icon="DArrowLeft">{{$t('tabview__contextmenu-closeleft')}}</el-dropdown-item>
              <el-dropdown-item command="closeRight" :icon="DArrowRight">{{$t('tabview__contextmenu-closeright')}}</el-dropdown-item>
              <el-dropdown-item command="closeAll" :icon="CircleCloseFilled">{{$t('tabview__contextmenu-closeall')}}</el-dropdown-item>
            </el-dropdown-menu>
          </template>
        </el-dropdown>
      </template>
    </el-tab-pane>
    </el-tabs>
  </div>
</template>

<script setup>
  import { onMounted, ref, computed, watch, nextTick } from 'vue'
  import { useRouter, useRoute } from 'vue-router'
  import { useI18n } from 'vue-i18n'
  import { Refresh, Close, Switch, DArrowLeft, DArrowRight, CircleCloseFilled } from '@element-plus/icons-vue'
  import { isObject, isImg } from '@/utils'
  import { useLink } from '@/hooks/useLink'
  import { appState } from '@/pinia/modules/app'
  
  const router = useRouter()
  const route = useRoute()
  const { jump } = useLink()
  const { locale } = useI18n()
  let { config: { keepAlive, tabRoutes, cacheRoutes }, updateConfig } = appState()

  const dropdownRef = ref()
  const activeTab = ref(route.path)
  const tabList = ref(tabRoutes)

  // 新增选项卡
  const addTab = () => {
    const index = tabList.value.findIndex(item => item?.path === activeTab.value)
    if(index == -1) {
      tabList.value.push({
        path: route?.path,
        name: route?.name,
        meta: {
          ...route?.meta,
        }
      })
    }
    updateConfig('tabRoutes', tabList.value)
    updateCacheRoutes()
  }

  // 删除选项卡
  const removeTab = (path) => {
    const index = tabList.value.findIndex(item => item?.path === path)
    if(index > -1) {
      tabList.value.splice(index, 1)
      updateTabs(tabList.value)
    }
  }

  // 删除左侧选项卡
  const removeLeftTab = (path) => {
    const index = tabList.value.findIndex(item => item?.path === path)
    if(index > -1) {
      tabList.value = tabList.value.filter((item, i) => item?.meta?.isAffix || i >= index)
      updateTabs(tabList.value)
    }
  }

  // 删除右侧选项卡
  const removeRightTab = (path) => {
    const index = tabList.value.findIndex(item => item?.path === path)
    if(index > -1) {
      tabList.value = tabList.value.filter((item, i) => item?.meta?.isAffix || i <= index)
      updateTabs(tabList.value)
    }
  }

  // 删除其它选项卡
  const removeOtherTab = (path) => {
    tabList.value = tabList.value.filter(item => item?.meta?.isAffix || item?.path === path)
    updateTabs(tabList.value)
  }

  // 删除全部
  const removeAllTab = (path) => {
    tabList.value = tabList.value.filter(item => item?.meta?.isAffix)
    updateTabs(tabList.value)
  }

  // 更新选项卡
  const updateTabs = (tabs) => {
    updateConfig('tabRoutes', tabs)
    updateCacheRoutes()
    const nextTab = tabs[tabs.length + 1] || tabs[tabs.length - 1]
    if(!nextTab) return
    jump(nextTab?.path)
  }

  // 更新keep-alive缓存
  const updateCacheRoutes = () => {
    let caches = tabList.value.filter(item => keepAlive || item?.meta?.isKeepAlive).map(item => item.name)
    updateConfig('cacheRoutes', caches)
  }

  // 清空keep-alive缓存
  const clearCacheRoutes = () => {
    updateConfig('cacheRoutes', [])
  }

  // 点击选项卡
  const changeTabs = (path) => {
    jump(path)
  }

  // 右键菜单更新
  const handleDropdownChange = (visible, name) => {
    // 控制每次只显示一个右键菜单
    if(!visible) return
    dropdownRef.value.forEach(item => {
      if(item.id === name) return
      item.handleClose()
    })
  }
  // 右键菜单命令
  const handleDropdownCommand = (cmd, item) => {
    const path = item?.path
    switch(cmd) {
      case 'refresh':
        router.go(0)
        break
      case 'close':
        removeTab(path)
        break
      case 'closeLeft':
        removeLeftTab(path)
        break
      case 'closeRight':
        removeRightTab(path)
        break
      case 'closeOther':
        removeOtherTab(path)
        break
      case 'closeAll':
        removeAllTab()
        break
    }
  }

  watch(() => route.path, () => {
    activeTab.value = route.path
    addTab()
  }, {
    immediate: true
  })
</script>