7.2 KiB
7.2 KiB
PDFReaderLite 0.2.4 图标方案
版本目标
0.2.4 定位为“图标与工具栏可读性增强版”,只做视觉和交互一致性优化,不改核心 PDF 功能。
目标:
- 为所有按钮补充统一风格图标。
- 提升顶部工具栏、右侧工具面板、状态栏按钮的可读性。
- 保持中文界面和 Acrobat 常用操作习惯。
- 图标缺失时不影响软件使用。
设计原则
- 图标风格统一:线性、简洁、单色为主。
- 常用按钮可使用“图标 + 短文字”,低频按钮优先使用“图标 + tooltip”。
- 选中状态使用蓝色强调,禁用状态降低透明度。
- 浅色和深色模式都要清晰可见。
- 工具栏图标建议
16px或18px,右侧工具面板建议18px。 - 不使用过度彩色、复杂拟物图标,避免界面显得凌乱。
- 所有图标资源集中管理,不在业务代码里分散硬编码路径。
资源结构建议
resources/
icons/
icon_software_multisize.ico
icon_pdf_multisize.ico
actions/
file-open.svg
file-save.svg
file-save-as.svg
...
建议新增统一图标注册模块:
pdfreaderlite/ui/icons.py
职责:
- 根据图标名称返回
QIcon。 - 统一处理图标路径。
- 图标缺失时返回空图标或降级图标。
- 后续支持深色模式图标切换。
图标来源建议
优先级:
- PySide6 / Qt 内置标准图标。
- 一套许可证清晰的开源 SVG 图标库。
- 必要时自绘少量项目专属 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。 - 统一处理资源路径。
- 缺失图标时安全降级。
第三步:补齐核心区域图标
优先级:
- 顶部工具栏。
- 状态栏视图控制。
- 右侧模式面板。
- 页面管理窗口。
- 右键菜单。
- 低频设置类按钮。
第四步:统一 tooltip 和按钮展示方式
规则:
- 所有图标按钮必须有中文 tooltip。
- 高频操作可保留短文字。
- 低频按钮可只显示图标,但 tooltip 必须清楚。
- 禁用功能必须变灰,不支持的右键菜单项也要变灰或隐藏。
第五步:适配深色模式
检查内容:
- 图标在浅色背景可见。
- 图标在深色背景可见。
- 选中、悬停、禁用状态有明显差异。
- 不出现图标和文字重叠。
第六步:验收与回归
验收清单:
- 所有按钮均有图标或明确说明“不需要图标”。
- 所有图标按钮均有中文 tooltip。
- 顶部工具栏没有明显拥挤、错位、重叠。
- 右侧工具面板图标风格一致。
- 深色模式下图标可读。
- 打包后图标资源完整。
- 图标缺失不会导致程序启动失败。
建议新增测试:
- 图标资源存在性检查。
- 图标注册表缺失降级检查。
- 打包后资源路径检查。
不在 0.2.4 范围内
- 不重做整体 UI 布局。
- 不引入复杂 Ribbon。
- 不改核心 PDF 编辑逻辑。
- 不新增大型业务功能。
- 不为了图标牺牲中文可读性。