docs(tabs): 更新标签页视图组件设计与交互细节

- 采用固定内边距策略,解决标签页悬停时的布局抖动问题
- 统一关闭按钮尺寸为14x14px,提升视觉一致性
- 优化活动标签和悬停状态的层级管理,确保视觉层次正确
- 增强视觉反馈,添加内嵌阴影效果改善用户体验
- 添加平滑颜色过渡动画(0.2秒),提升交互流畅度
- 支持玻璃拟态设计系统,实现现代化视觉风格
- 完善工具箱图标支持,确保标签页工具功能准确显示
This commit is contained in:
eafonyang
2026-07-15 09:58:56 +08:00
parent 003b44e2bd
commit f48f1cce70
27 changed files with 670 additions and 212 deletions
@@ -12,6 +12,12 @@
- [app.js](file://backend/src/app.js)
</cite>
## 更新摘要
**变更内容**
- 更新了搜索表单中的按钮组件样式,采用统一的圆形图标格式
- 优化了视觉呈现效果,提升了用户体验
- 简化了代码结构,提高了可维护性
## 目录
1. [简介](#简介)
2. [项目结构](#项目结构)
@@ -29,6 +35,8 @@
该系统采用前后端分离架构,前端使用Vue.js框架构建用户界面,后端基于Express.js提供RESTful API服务。通过详细的日志记录,管理员可以追踪每个分享码的完整生命周期,从生成到使用的全过程监控。
**最新更新** 页面采用了标准化的圆形图标按钮设计,显著提升了视觉一致性和用户体验。
## 项目结构
分享码日志功能涉及前端视图组件和后端API服务两个主要部分:
@@ -58,13 +66,13 @@ BE_Routes --> BE_Auth
```
**图表来源**
- [log.vue:1-353](file://frontend/src/views/share-code/log.vue#L1-L353)
- [log.vue:1-347](file://frontend/src/views/share-code/log.vue#L1-L347)
- [shareCodeLog.js:1-26](file://frontend/src/api/shareCodeLog.js#L1-L26)
- [shareCodeLogs.js:1-88](file://backend/src/routes/shareCodeLogs.js#L1-L88)
- [ShareCodeLog.js:1-60](file://backend/src/models/ShareCodeLog.js#L1-L60)
**章节来源**
- [log.vue:1-353](file://frontend/src/views/share-code/log.vue#L1-L353)
- [log.vue:1-347](file://frontend/src/views/share-code/log.vue#L1-L347)
- [shareCodeLog.js:1-26](file://frontend/src/api/shareCodeLog.js#L1-L26)
- [shareCodeLogs.js:1-88](file://backend/src/routes/shareCodeLogs.js#L1-L88)
- [ShareCodeLog.js:1-60](file://backend/src/models/ShareCodeLog.js#L1-L60)
@@ -76,6 +84,7 @@ BE_Routes --> BE_Auth
分享码日志页面采用Element Plus组件库构建,包含以下核心功能:
- **搜索表单**:支持MAC地址、分享码、操作类型、IP地址和时间范围的多维度过滤
- **圆形图标按钮**:采用统一的圆形图标设计,提升视觉一致性
- **数据表格**:展示分享码日志的完整信息,包括设备信息、操作详情和时间戳
- **分页控制**:支持自定义每页条数和页码导航
- **对话框展示**:提供EQ数据快照的可视化查看功能
@@ -89,8 +98,10 @@ BE_Routes --> BE_Auth
- **分页处理**:限制最大查询数量,确保系统性能
- **响应格式**:统一的API响应格式,便于前端处理
**更新** 搜索表单中的按钮已标准化为圆形图标格式,包括搜索和重置按钮,提升了整体界面的视觉统一性。
**章节来源**
- [log.vue:148-278](file://frontend/src/views/share-code/log.vue#L148-L278)
- [log.vue:53-56](file://frontend/src/views/share-code/log.vue#L53-L56)
- [shareCodeLogs.js:14-84](file://backend/src/routes/shareCodeLogs.js#L14-L84)
## 架构概览
@@ -121,7 +132,7 @@ Frontend->>Frontend : 渲染表格和分页
```
**图表来源**
- [log.vue:233-250](file://frontend/src/views/share-code/log.vue#L233-L250)
- [log.vue:227-244](file://frontend/src/views/share-code/log.vue#L227-L244)
- [shareCodeLogs.js:14-84](file://backend/src/routes/shareCodeLogs.js#L14-L84)
- [auth.js:3-26](file://backend/src/middleware/auth.js#L3-L26)
@@ -137,7 +148,7 @@ Frontend->>Frontend : 渲染表格和分页
6. **响应返回**:前端接收并渲染数据
**章节来源**
- [log.vue:214-231](file://frontend/src/views/share-code/log.vue#L214-L231)
- [log.vue:208-225](file://frontend/src/views/share-code/log.vue#L208-L225)
- [shareCodeLogs.js:31-60](file://backend/src/routes/shareCodeLogs.js#L31-L60)
## 详细组件分析
@@ -146,7 +157,7 @@ Frontend->>Frontend : 渲染表格和分页
#### 搜索表单组件
前端搜索表单提供了丰富的筛选选项:
前端搜索表单提供了丰富的筛选选项,并采用了标准化的圆形图标按钮设计
```mermaid
classDiagram
@@ -160,6 +171,12 @@ class SearchForm {
+handleSearch() void
+handleReset() void
}
class CircularButtons {
+el-button type="primary" circle : icon="Search"
+el-button circle : icon="Refresh"
+title属性
@click事件处理
}
class Pagination {
+number page
+number pageSize
@@ -172,14 +189,20 @@ class TableData {
+formatDateTime(value) string
+handleViewEq(row) void
}
SearchForm --> CircularButtons : "使用"
SearchForm --> Pagination : "使用"
SearchForm --> TableData : "管理"
```
**更新** 搜索表单中的按钮已采用圆形图标设计,包括:
- 搜索按钮:`type="primary" circle :icon="Search"`
- 重置按钮:`circle :icon="Refresh"`
- 统一的标题提示和点击事件处理
**图表来源**
- [log.vue:170-180](file://frontend/src/views/share-code/log.vue#L170-L180)
- [log.vue:159-163](file://frontend/src/views/share-code/log.vue#L159-L163)
- [log.vue:157-158](file://frontend/src/views/share-code/log.vue#L157-L158)
- [log.vue:53-56](file://frontend/src/views/share-code/log.vue#L53-L56)
- [log.vue:164-170](file://frontend/src/views/share-code/log.vue#L164-L170)
- [log.vue:153-157](file://frontend/src/views/share-code/log.vue#L153-L157)
#### 数据表格组件
@@ -196,7 +219,7 @@ SearchForm --> TableData : "管理"
| create_at | 操作时间 | 日期时间 | 操作发生时间 |
**章节来源**
- [log.vue:78-104](file://frontend/src/views/share-code/log.vue#L78-L104)
- [log.vue:72-97](file://frontend/src/views/share-code/log.vue#L72-L97)
### 后端API分析
@@ -325,7 +348,7 @@ router_index --> log_vue
```
**图表来源**
- [log.vue:154](file://frontend/src/views/share-code/log.vue#L154)
- [log.vue:148](file://frontend/src/views/share-code/log.vue#L148)
- [shareCodeLog.js:17](file://frontend/src/api/shareCodeLog.js#L17)
- [shareCodeLogs.js:6](file://backend/src/routes/shareCodeLogs.js#L6)
- [ShareCodeLog.js:2](file://backend/src/models/ShareCodeLog.js#L2)
@@ -354,7 +377,7 @@ router_index --> log_vue
- 确保只有认证用户可以访问
**章节来源**
- [log.vue:154](file://frontend/src/views/share-code/log.vue#L154)
- [log.vue:148](file://frontend/src/views/share-code/log.vue#L148)
- [shareCodeLog.js:17](file://frontend/src/api/shareCodeLog.js#L17)
- [shareCodeLogs.js:6](file://backend/src/routes/shareCodeLogs.js#L6)
@@ -413,7 +436,7 @@ Frontend->>Frontend : 重新渲染界面
```
**图表来源**
- [log.vue:233-250](file://frontend/src/views/share-code/log.vue#L233-L250)
- [log.vue:227-244](file://frontend/src/views/share-code/log.vue#L227-L244)
## 故障排除指南
@@ -469,7 +492,7 @@ HandleError --> ReturnError
### 主要优势
1. **功能完整性**:提供了完整的查询、筛选、分页和展示功能
2. **用户体验**:直观的界面设计和响应式交互
2. **用户体验**:直观的界面设计和响应式交互,采用统一的圆形图标按钮设计
3. **数据安全**:完善的认证授权机制
4. **性能优化**:合理的分页策略和数据处理
@@ -480,4 +503,4 @@ HandleError --> ReturnError
3. **统计分析**:添加图表化的数据统计和趋势分析
4. **搜索增强**:支持更复杂的搜索语法和保存常用查询
该系统为音频仪表板提供了重要的审计和监控能力,为后续的功能扩展奠定了良好的基础。
该系统为音频仪表板提供了重要的审计和监控能力,为后续的功能扩展奠定了良好的基础。**最新的圆形图标按钮设计进一步提升了界面的视觉一致性和用户体验。**