Skip to content
系列教程 · 第 04 篇

基于 VbenAdmin 的界面体验

主题、布局、国际化、偏好设置与列表交互:管理界面实际提供了什么。

更新于 2026-11-17MIT 开源

基于 VbenAdmin 的界面体验 ​

管理界面基于 VbenAdmin(Vue 3 + TypeScript + Vite + Ant Design Vue)。这部分不是简单的“套一层皮”,而是把主题、布局、国际化、列表交互这些通用能力直接带进了调度系统。

1. 技术栈与打包方式 ​

项目说明
前端框架Vue 3 + TypeScript
UI 组件Ant Design Vue
管理框架VbenAdmin
构建工具Vite
打包方式构建产物嵌入 RCL 的 wwwroot,随 NuGet 包发布

这意味着使用者无需单独部署前端,安装包后访问 /quartz-ui 即可;需要改界面时,则要修改 src/Chet.QuartzNet.Web 并重新构建。

2. 主题与外观 ​

2.1 明暗模式 ​

支持三种模式:

  • 浅色:默认;
  • 深色:适合夜间或低光环境;
  • 跟随系统:随操作系统切换。

深色模式下,分析页图表配色与热力图空格子已单独适配。

2.2 主题色 ​

可在偏好设置中调整主色,导航、按钮、标签、图表配色会同步变化。

登录界面

3. 布局 ​

VbenAdmin 提供多种布局,可在运行时切换:

布局特点
侧边导航默认,左侧菜单 + 顶部栏
混合导航顶部一级菜单 + 侧边子菜单
顶部导航菜单全部在顶部
双列菜单侧边两列,适合菜单较多的系统
全屏内容隐藏菜单,只保留内容区

同时可调整:

  • 菜单折叠与宽度;
  • 顶部栏是否固定、是否显示面包屑;
  • 标签页是否启用、是否可拖拽;
  • 内容区宽度与内边距;
  • 页脚固定与版权信息。

分析页

4. 偏好设置 ​

点击右上角设置按钮打开偏好面板,常用项包括:

分类能力
外观明暗模式、主题色、圆角、紧凑模式
布局上述布局切换、侧边栏与顶栏行为
通用水印、页面切换动画、色弱模式、灰色模式
快捷键全局搜索、锁屏、退出登录的开关
国际化中文 / English

水印适合内网或演示环境,可配置内容与透明度;页面切换动画在低性能设备上可以关闭。

5. 中英文切换 ​

界面文案通过 i18n 管理,覆盖分析、作业、日志、通知、系统设置等页面。切换语言后无需刷新,表格列头与搜索表单标签会同步更新。

多语言切换

英文界面

6. 快捷键 ​

默认启用的全局快捷键包括全局搜索、锁屏与退出登录,可在「偏好设置 → 快捷键」中查看当前组合并单独关闭。

7. 列表与表单交互 ​

这部分是日常使用中感受最明显的:

  • 服务端分页与排序:作业、日志、通知列表基于 vxe-table,数据量大时不在前端堆积;
  • 搜索条件持久化:刷新或切换页面后保留筛选条件;
  • 列设置持久化:自定义显示列与列宽会被记住;
  • 操作列悬停展开:减少一次点击;
  • 可拖拽弹窗:作业编辑、日志详情等弹窗支持拖动;
  • 二次确认:启用/禁用、批量操作、清空日志、迁移等敏感操作都会确认。

作业管理

8. 响应式与限制 ​

  • 桌面端为完整布局,窄屏下菜单折叠为抽屉;
  • 页面以管理后台为主,未提供独立移动端 App;
  • 前端是预构建产物,修改样式或页面需要重新构建并替换包内静态资源;
  • 浏览器需支持现代 ES 特性,不支持 IE。

9. 二次开发提示 ​

如果需要改前端:

text
src/Chet.QuartzNet.Web/            # VbenAdmin 工程
├── apps/web-antd/src/views/quartz # 分析、作业、日志、通知、系统设置
├── packages/                       # 通用能力
└── internal/                       # 构建配置

构建后把产物同步到 src/Chet.QuartzNet.UI/wwwroot,再重新打包 NuGet。仅改后端配置时不需要动前端。

相关阅读 ​

让 Quartz.Net 调度,从未如此简单