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
+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` 为空、无路由守卫)