Files
PDFReaderLite/docs/icon.md
T
2026-07-02 14:11:30 +08:00

7.2 KiB
Raw Blame History

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。
  • 统一处理图标路径。
  • 图标缺失时返回空图标或降级图标。
  • 后续支持深色模式图标切换。

图标来源建议

优先级:

  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 编辑逻辑。
  • 不新增大型业务功能。
  • 不为了图标牺牲中文可读性。