docs: 打印行为说明对齐(@page 边距为 0 的原因、Firefox 需手动关页眉、Ctrl+P 同样生效)

This commit is contained in:
2026-10-04 00:32:23 +08:00
parent 85f7f9abb4
commit b8842d5947
2 changed files with 19 additions and 4 deletions
+10 -3
View File
@@ -54,9 +54,16 @@
- 添加 / 删除行随时进行(最多 20 行)。
### 打印
- 可设置打印数量(批量添加用)与 **上下 / 左右边距 (cm)**;
- 点「打印」按设置动态注入 `@page` 边距并调用 `window.print()`;若运行环境提供 `window.electronAPI.silentPrint` 则走静默打印;
- 打印时只输出标签版面:工具栏、面板、序号角标、空格边框均不打印。
- 可设置打印数量(批量添加用)与 **上下 / 左右边距 (cm)** —— 含义是**标签纸离纸边的距离**;
- 点「打印」会临时注入打印样式并调用 `window.print()`;若运行环境提供 `window.electronAPI.silentPrint` 则走静默打印。
`Ctrl+P` 也走同一套样式(靠 `beforeprint` 监听),不点按钮直接打印同样干净;
- 打印时只输出标签版面:工具栏、面板、序号角标、空格虚线引导、双击隐藏的格子内容**都不打印**;
- **不留浏览器页眉页脚**(左上角日期时间 / 标题、底部 URL / 页码):做法是把 `@page` 边距设成 0
—— 浏览器只在「页边距那块空白」里画页眉页脚,边距没了它自然就不画。标签纸的位置改由
`.page` 的 `left` / `top` 控制,物理结果与用页边距时完全一致。
> ⚠️ 这套做法在 Chrome / Edge 上可靠。**Firefox 的页眉页脚是打印对话框里的独立选项**,
> CSS 控制不了,需要在打印设置里手动取消勾选「页眉和页脚」。
---
+9 -1
View File
@@ -155,7 +155,15 @@ PREVIEW_API_TARGET=http://127.0.0.1:1337 npm run dev
- **`--no-build` 之外的重建**:`dist/` 与 `node_modules/` 已被仓库根 `.gitignore` 忽略,不会进版本库。
- **print 样式是临时注入的**:打印时才插 `<style media="print">`,`afterprint` 时移除。
常驻的话,用户在宿主里打印**任何别的页面**都会得到一张白纸 —— 插件 CSS 分不清
「现在打印的是不是我的页面」。
「现在打印的是不是我的页面」。`beforeprint` 也在监听,所以 `Ctrl+P` 与宿主的打印入口
同样会走这套样式。
- **打印样式里有三处不能改的写法**(改之前先读 `PrintTagPage.vue` 里 `applyPrintStyles` 的注释):
① `@page { margin: 0 }` 是「不要浏览器页眉页脚」的唯一开关,标签纸位置由 `.pt-paper`
的 `left` / `top` 给;② 隐藏类必须写成 `.x, .x *` 两段(`visibility` 可被子元素覆盖,
只隐父元素的话里面的 `<span>1</span>` 会被 `.pt-paper *` 又显出来,序号照印);
③ 这些规则必须排在 `.pt-paper *` **之后**(同特异性 + 同 `!important` 时后写的赢)。
- **Firefox 上页眉页脚关不掉**:那是它打印对话框里的独立选项(「页眉和页脚」),
不是 CSS 能控制的东西;Chrome / Edge 上 `@page margin: 0` 即可。
- **`postcss.config.js` 不能删**:本工程住在有 Tailwind 的仓库里,Vite 的 PostCSS
配置查找会往上走,加载到那份 Tailwind 配置后构建直接失败。
- **预览器做不到的三件事**(没有真 FunjiaUI、`ctx.plugin.repository` 为空、无路由守卫)