自研vite5+vue3+pinia+arco网页版os管理桌面Vue3-WebOS

经过了半个多月爆肝式开发，我的原创新作vue3-webos桌面版os管理系统正式完结了。

vue3-webos使用vite5.x构建项目模板，全部采用vue3 setup语法糖编码开发。

使用技术

• 编辑器：Vscode
• 技术框架：vite5.3+vue3.4+vue-router4+pinia2
• UI组件库：arco-design^2.55.3 (字节vue3组件库)
• 状态管理：pinia^2.1.7
• 图表插件：echarts^5.5.1
• 拖拽功能：sortablejs^1.15.2
• 富文本编辑器：wangeditor^4.7.15
• 模拟数据：mockjs^1.1.0
• 样式处理：sass^1.77.8

特性

1. 桌面和Dock菜单支持自定义JSON配置
2. 内置windows和macos两种桌面模式
3. 桌面菜单和dock菜单支持可拖拽排序
4. 支持自定义桌面主题皮肤、虚化毛玻璃UI质感
5. 全新os式后台管理系统解决方案

项目结构

配置主入口

在main.js中引入组件库，路由及状态管理。

/**
 * 主入口配置main.js
 * @author andy
 */

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

// 引入arco.design组件库
import ArcoDesign from '@arco-design/web-vue'
import '@arco-design/web-vue/dist/arco.css'
// 额外引入图标库
import ArcoIcon from '@arco-design/web-vue/es/icon'
import VEPlus from 've-plus'
import 've-plus/dist/ve-plus.css'

// 引入路由及状态管理
import Router from './router'
import Pinia from './pinia'

const app = createApp(App)

app
.use(ArcoDesign)
.use(ArcoIcon)
.use(VEPlus)
.use(Router)
.use(Pinia)
.mount('#app')

vite批量导入路由配置

vite.js提供了import.meta.glob来批处理文件。

/**
 * 路由管理Router
 * @author andy
 */

import { createRouter, createWebHashHistory } from 'vue-router'
import { authState } from '@/pinia/modules/auth'

import Layout from '@/layouts/index.vue'

// 批量导入路由
const modules = import.meta.glob('./modules/*.js', { eager: true })
console.log(modules)
const patchRouters = Object.keys(modules).map(key => modules[key].default).flat()
console.log(patchRouters)

const routes = [
  {
    path: '/',
    redirect: '/desktop',
  },
  ...patchRouters,
  // 错误模块
  {
    path: '/:pathMatch(.*)*',
    redirect: '/404',
    component: Layout,
    meta: {
      title: '404error',
    },
    children: [
      {
        path: '404',
        component: () => import('@/views/error/404.vue'),
      }
    ]
  },
]

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

// 全局路由钩子拦截
router.beforeEach((to, from) => {
  const authstate = authState()
  // 登录验证
  if(to?.meta?.requireAuth && !authstate.authorization) {
    console.log('你还未登录!')
    return {
      path: '/login'
    }
  }
})

vue3-os桌面布局

支持macos和windows两种桌面主题。

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

  // 引入布局模板
  import MacosLayout from './template/macos.vue'
  import WindowsLayout from './template/windows.vue'

  const appstate = appState()

  const DeskLayout = {
    macos: MacosLayout,
    windows: WindowsLayout
  }
</script>

<template>
  <div
    class="vu__container desktop flexbox flex-alignc flex-justifyc"
    :style="{'--themeSkin': appstate.config.skin}"
    @contextmenu.prevent
  >
    <component :is="DeskLayout[appstate.config.layout]" />
  </div>
</template>

<template>
  <div class="vu__layout flexbox flex-col">
    <div class="vu__layout-header">
      <Toolbar />
    </div>
    <div class="vu__layout-body flex1 flexbox">
      <Desk />
    </div>
    <div class="vu__layout-footer">
      <Dock />
    </div>
    <!-- 悬浮球(辅助触控) -->
    <Touch />
  </div>
</template>

vue3-osx栅格布局引擎

采用全新自研的可拖拽自定义桌面图标布局引擎。

桌面图标支持自定义大小、圆角、间距、背景色/颜色等功能。

// 自定义变量(桌面图标)
const deskVariable = ref({
  '--icon-radius': '8px', // 圆角
  '--icon-size': '60px', // 图标尺寸(设置rpx自定义手机设备)
  '--icon-gap-col': '30px', // 水平间距
  '--icon-gap-row': '30px', // 垂直间距
  '--icon-labelSize': '12px', // 标签文字大小
  '--icon-labelColor': '#fff', // 标签颜色
  '--icon-fit': 'contain', // 图标自适应模式
})

桌面图标还支持配置children二级菜单。以弹窗形式展示二级菜单列表。

const deskMenuList = [
  {
    pid: 20240507001,
    list: [
      {imgico: markRaw(Today), size: '2x2'},
      {imgico: markRaw(Weather), size: '2x2'},
      ...
    ]
  },
  {
    pid: 20240509002,
    list: [
      {label: 'Appstore', imgico: '/static/mac/appstore.png'},
      ...
    ]
  },
  {
    pid: 20240510001,
    list: [
      {label: 'Github', imgico: '/static/svg/github.svg', link: 'https://github.com/', background: '#607d8b',},
      ...
    ]
  },
  {
    uid: 'd141f210-207e-1e8e-9950-9deefac27e48',
    list: [
      {label: 'Vite^5.3.3', imgico: 'https://vitejs.dev/logo.svg', link: 'https://vitejs.dev/'},
      ...
      {
        label: '组件',
        children: [
          {label: '表格', imgico: '/static/svg/table.svg', path: '/components/table/all'},
          {label: '自定义表格', imgico: '/static/svg/table.svg', path: '/components/table/custom'},
          ...
        ]
      },
      {label: 'ChatGPT', imgico: '/static/svg/chatgpt.svg', link: 'https://openai.com/chatgpt/', background: '#15A17F',},
      {label: 'Bilibili', imgico: '/static/svg/bilibili.svg', link: 'https://www.bilibili.com/', background: '#ff6899',},
      {
        label: '个人中心',
        children: [
          {label: '主页', imgico: '/static/svg/my.svg', path: '/setting'},
          ...
        ]
      },
      {
        label: '设置',
        children: [
          {label: '网站设置', imgico: '/static/svg/settings.svg', path: '/setting/system/website'},
          {label: '邮件服务', imgico: '/static/mac/mail.png', path: '/setting/system/mail'},
        ]
      },
      {
        label: '公众号', imgico: markRaw(IconWechat), color: '#07c160',
        onClick: () => {
          ...
        }
      },
    ]
  }
]

Ok，到这里vue3+pinia+arco.design实战网页版os系统基本介绍结束了，涉及到的知识点还是蛮多的，限于篇幅就先分享到这里。希望以上分享对大家有所帮助！