259 lines
7.2 KiB
Markdown
259 lines
7.2 KiB
Markdown
# PDFReaderLite 0.2.4 图标方案
|
||
|
||
## 版本目标
|
||
|
||
`0.2.4` 定位为“图标与工具栏可读性增强版”,只做视觉和交互一致性优化,不改核心 PDF 功能。
|
||
|
||
目标:
|
||
|
||
- 为所有按钮补充统一风格图标。
|
||
- 提升顶部工具栏、右侧工具面板、状态栏按钮的可读性。
|
||
- 保持中文界面和 Acrobat 常用操作习惯。
|
||
- 图标缺失时不影响软件使用。
|
||
|
||
## 设计原则
|
||
|
||
- 图标风格统一:线性、简洁、单色为主。
|
||
- 常用按钮可使用“图标 + 短文字”,低频按钮优先使用“图标 + tooltip”。
|
||
- 选中状态使用蓝色强调,禁用状态降低透明度。
|
||
- 浅色和深色模式都要清晰可见。
|
||
- 工具栏图标建议 `16px` 或 `18px`,右侧工具面板建议 `18px`。
|
||
- 不使用过度彩色、复杂拟物图标,避免界面显得凌乱。
|
||
- 所有图标资源集中管理,不在业务代码里分散硬编码路径。
|
||
|
||
## 资源结构建议
|
||
|
||
```text
|
||
resources/
|
||
icons/
|
||
icon_software_multisize.ico
|
||
icon_pdf_multisize.ico
|
||
actions/
|
||
file-open.svg
|
||
file-save.svg
|
||
file-save-as.svg
|
||
...
|
||
```
|
||
|
||
建议新增统一图标注册模块:
|
||
|
||
```text
|
||
pdfreaderlite/ui/icons.py
|
||
```
|
||
|
||
职责:
|
||
|
||
- 根据图标名称返回 `QIcon`。
|
||
- 统一处理图标路径。
|
||
- 图标缺失时返回空图标或降级图标。
|
||
- 后续支持深色模式图标切换。
|
||
|
||
## 图标来源建议
|
||
|
||
优先级:
|
||
|
||
1. PySide6 / Qt 内置标准图标。
|
||
2. 一套许可证清晰的开源 SVG 图标库。
|
||
3. 必要时自绘少量项目专属 SVG。
|
||
|
||
候选风格:
|
||
|
||
- Lucide 风格:线条清晰,适合工具软件。
|
||
- Material Symbols 风格:覆盖面广,容易找到对应动作。
|
||
- Remix Icon 风格:中文软件里辨识度也较好。
|
||
|
||
注意事项:
|
||
|
||
- 选定图标库后,在文档中记录许可证和来源。
|
||
- 不混用多套视觉差异明显的图标。
|
||
- 不使用来源不明的网络图标。
|
||
|
||
当前已落地方案:
|
||
|
||
- 首批图标为 PDFReaderLite 项目自绘 SVG。
|
||
- 风格参考 Lucide 的线性工具图标语言,但不直接复制第三方图标文件。
|
||
- 统一使用 `24x24` 画布、`fill="none"`、`stroke="currentColor"`、`stroke-width="2"`、圆角端点和圆角连接。
|
||
- 文件位置:`resources/icons/actions/`。
|
||
|
||
## 按钮图标规划
|
||
|
||
### 文件类
|
||
|
||
| 按钮 | 建议图标 | 备注 |
|
||
| --- | --- | --- |
|
||
| 打开 | 文件夹 | 高频,保留文字 |
|
||
| 保存 | 软盘 | 高频,保留文字 |
|
||
| 另存为 | 软盘 + 铅笔/箭头 | 需要区别于保存 |
|
||
| 打印 | 打印机 | 菜单和工具栏一致 |
|
||
| 最近文件 | 时钟 | 菜单项可选 |
|
||
| 文档信息 | 信息圆圈 | 右侧工具面板 |
|
||
|
||
### 导航与视图
|
||
|
||
| 按钮 | 建议图标 | 备注 |
|
||
| --- | --- | --- |
|
||
| 指针 | 鼠标箭头 | 与手形互斥 |
|
||
| 手形 | 手掌 | 默认状态 |
|
||
| 阅读 | 眼睛/书本 | 右侧模式按钮 |
|
||
| 缩小 | 减号放大镜 | 状态栏 |
|
||
| 放大 | 加号放大镜 | 状态栏 |
|
||
| 适应宽度 | 左右箭头 | 状态栏 |
|
||
| 适应页面 | 页面框 | 状态栏 |
|
||
| 上一页 | 左箭头 | 如后续恢复按钮使用 |
|
||
| 下一页 | 右箭头 | 如后续恢复按钮使用 |
|
||
| 页码输入 | 页面 + 数字 | 输入框不强制加图标 |
|
||
|
||
### 注释
|
||
|
||
| 按钮 | 建议图标 | 备注 |
|
||
| --- | --- | --- |
|
||
| 注释 | 气泡列表 | 顶部模式按钮 |
|
||
| 高亮 | 荧光笔 | 支持多色菜单 |
|
||
| 下划线 | 带下划线的 U | |
|
||
| 删除线 | 带横线的 S | |
|
||
| 批注 | 对话气泡 | |
|
||
| 自由画笔 | 笔 | |
|
||
| 矩形 | 矩形框 | |
|
||
| 圆形 | 圆圈 | |
|
||
| 线条 | 斜线 | |
|
||
| 箭头 | 箭头线 | |
|
||
| 注释列表 | 列表 + 气泡 | |
|
||
| 注释属性 | 滑杆/调节 | |
|
||
|
||
### 编辑 PDF
|
||
|
||
| 按钮 | 建议图标 | 备注 |
|
||
| --- | --- | --- |
|
||
| 编辑 PDF | 页面 + 铅笔 | 顶部模式按钮 |
|
||
| 添加文本 | T | |
|
||
| 插入图片 | 图片框 | |
|
||
| 遮盖 | 黑色矩形/遮罩 | 需提示不是永久擦除 |
|
||
| 图片签名 | 图片 + 笔 | |
|
||
| 点击放置签名 | 签字笔 | |
|
||
| 手写签名 | 手写线条 | |
|
||
| 复制 | 双页 | 右键菜单也可用 |
|
||
| 粘贴 | 剪贴板 | 右键菜单也可用 |
|
||
| 删除 | 垃圾桶 | |
|
||
| 置顶 | 图层 + 上箭头 | |
|
||
| 置底 | 图层 + 下箭头 | |
|
||
| 上移一层 | 图层上移 | |
|
||
| 下移一层 | 图层下移 | |
|
||
| 对齐 | 对齐线条 | 根据方向细分 |
|
||
| 分布 | 等距线条 | 根据方向细分 |
|
||
|
||
### 页面
|
||
|
||
| 按钮 | 建议图标 | 备注 |
|
||
| --- | --- | --- |
|
||
| 页面 | 页面信息圆圈 | 顶部模式按钮 |
|
||
| 旋转 | 旋转箭头 | |
|
||
| 删除页 | 页面 + 垃圾桶 | |
|
||
| 移动页面 | 页面 + 箭头 | |
|
||
| 页面管理 | 页面网格 | |
|
||
| 插入空白页 | 页面 + 加号 | |
|
||
| 插入 PDF | PDF + 加号 | |
|
||
| 提取页面 | 页面 + 外箭头 | |
|
||
| 拆分 PDF | 分割线 | |
|
||
| 合并 PDF | 合并箭头 | |
|
||
|
||
### 工具与导出
|
||
|
||
| 按钮 | 建议图标 | 备注 |
|
||
| --- | --- | --- |
|
||
| 工具 | 工具箱 | 顶部模式按钮 |
|
||
| 导出当前页图片 | 图片 + 外箭头 | |
|
||
| 批量导出图片 | 多图片 + 外箭头 | |
|
||
| 图片转 PDF | 图片 + PDF | |
|
||
| 填写表单 | 表单/勾选框 | |
|
||
| 加密另存为 | 锁 | |
|
||
| 移除密码另存为 | 解锁 | |
|
||
| 注册 PDF 文件关联 | 链条 | |
|
||
| 打开系统默认应用设置 | 设置齿轮 | |
|
||
| 打开日志目录 | 文件夹 + 文档 | |
|
||
| 深色模式 | 月亮 | |
|
||
|
||
## 实施计划
|
||
|
||
### 第一步:整理按钮清单
|
||
|
||
输出一份完整按钮清单,至少包含:
|
||
|
||
- 顶部工具栏按钮。
|
||
- 状态栏按钮。
|
||
- 右侧工具面板按钮。
|
||
- 右键菜单动作。
|
||
- 页面管理窗口按钮。
|
||
- 签名、表单、属性面板中的按钮。
|
||
|
||
分类结果:
|
||
|
||
- 已有图标。
|
||
- 需要新增图标。
|
||
- 可复用图标。
|
||
- 不需要图标,只保留文字。
|
||
- 可考虑合并或调整命名的按钮。
|
||
|
||
### 第二步:建立图标注册表
|
||
|
||
新增 `pdfreaderlite/ui/icons.py`:
|
||
|
||
- 定义图标名称常量。
|
||
- 提供 `icon(name: str) -> QIcon`。
|
||
- 统一处理资源路径。
|
||
- 缺失图标时安全降级。
|
||
|
||
### 第三步:补齐核心区域图标
|
||
|
||
优先级:
|
||
|
||
1. 顶部工具栏。
|
||
2. 状态栏视图控制。
|
||
3. 右侧模式面板。
|
||
4. 页面管理窗口。
|
||
5. 右键菜单。
|
||
6. 低频设置类按钮。
|
||
|
||
### 第四步:统一 tooltip 和按钮展示方式
|
||
|
||
规则:
|
||
|
||
- 所有图标按钮必须有中文 tooltip。
|
||
- 高频操作可保留短文字。
|
||
- 低频按钮可只显示图标,但 tooltip 必须清楚。
|
||
- 禁用功能必须变灰,不支持的右键菜单项也要变灰或隐藏。
|
||
|
||
### 第五步:适配深色模式
|
||
|
||
检查内容:
|
||
|
||
- 图标在浅色背景可见。
|
||
- 图标在深色背景可见。
|
||
- 选中、悬停、禁用状态有明显差异。
|
||
- 不出现图标和文字重叠。
|
||
|
||
### 第六步:验收与回归
|
||
|
||
验收清单:
|
||
|
||
- 所有按钮均有图标或明确说明“不需要图标”。
|
||
- 所有图标按钮均有中文 tooltip。
|
||
- 顶部工具栏没有明显拥挤、错位、重叠。
|
||
- 右侧工具面板图标风格一致。
|
||
- 深色模式下图标可读。
|
||
- 打包后图标资源完整。
|
||
- 图标缺失不会导致程序启动失败。
|
||
|
||
建议新增测试:
|
||
|
||
- 图标资源存在性检查。
|
||
- 图标注册表缺失降级检查。
|
||
- 打包后资源路径检查。
|
||
|
||
## 不在 0.2.4 范围内
|
||
|
||
- 不重做整体 UI 布局。
|
||
- 不引入复杂 Ribbon。
|
||
- 不改核心 PDF 编辑逻辑。
|
||
- 不新增大型业务功能。
|
||
- 不为了图标牺牲中文可读性。
|