Files
2026-07-02 14:11:30 +08:00

259 lines
7.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 编辑逻辑。
- 不新增大型业务功能。
- 不为了图标牺牲中文可读性。