fix: 虚线边框改为「纸上有东西才画」(原 Web 版 + 插件版都改)

用户口径:**没内容时不要打印虚线,有内容时要打印**。
原来只有「空格」满足这条,另有两种状态违反:

- 双击「隐藏(不打印)」的格子:纸上什么都没有,虚线照印;
- 模板选了但内容全空(最典型是 CustomTag 把所有行的文字都清空):
  纸上什么都没有,虚线照印 —— 在纸上看它和空格一模一样。

改成把规则统一成一句话:**边框 = 这一格纸上真的会印出东西**。

- 空格 / 双击隐藏:由格子状态直接判定(LabelCell 新增 blank-on-paper
  类,由页面算好传进来 —— 只有页面知道模板的内容规则);
- 模板内容全空:交给模板自己判。两块代码各自在模板注册表里声明
  `hasContent`(插件在 templates/registry.ts,原 Web 版在 Main.vue 的
  templates 数组里)。

为什么不能让模板「什么都不声明」靠通用扫描:CustomTag 的行是
`{ text, size, bold, color }`,通用扫描扫到 `color: '#000000'` 就认为有内容了,
于是文字全清空的标签仍被判定成有内容。所以 Error / CustomTag 显式声明
hasContent;未声明的模板退回通用兜底 —— 兜底刻意偏「宽松」:多印一个空框
看得见、好排查;把有内容的标签判成空的,用户会以为东西丢了。

另外规格类模板标记 `alwaysPrints`:它们带左侧固定信息区(店铺名 / 电话 /
内置二维码图片),那部分不来自 config,所以「字段被清空」的规格标签仍有内容、
边框必须留 —— 否则用户清空字段后会发现边框莫名其妙没了。

验证(Playwright + 本机 Edge,真实打印管线):
- 插件版 5 项边框断言 + 上一轮的 13 项打印断言,全过;
- 原 Web 版 5 项边框断言全过;
- 两版都生成 PDF 用浏览器 PDF 视图渲染确认纸面:只有真正有内容的格子
  留下边框与内容,隐藏格 / 内容全空格在纸上是空白。
- 插件产物已升版本发布为 funjia.print-tag@1.0.2。
This commit is contained in:
2026-10-04 01:14:04 +08:00
parent b8842d5947
commit b78d104728
6 changed files with 225 additions and 19 deletions
+72 -12
View File
@@ -89,7 +89,8 @@
<main class="sheet">
<div class="page">
<LabelCell v-for="(slot, i) in slots" :key="i" :index="i" :item="slot"
:selected="selectedIndex === i" @select="onCellSelect(i)" @toggle-hide="toggleHidden(i)">
:selected="selectedIndex === i" :blank-on-paper="isBlankOnPaper(slot)"
@select="onCellSelect(i)" @toggle-hide="toggleHidden(i)">
<component :is="templateMap.get(slot.name)" v-if="slot.name" :config="slot.config" />
</LabelCell>
</div>
@@ -123,72 +124,89 @@ import LabelCell from './LabelCell.vue';
const clone = (obj) => JSON.parse(JSON.stringify(obj));
// 模板注册表:新增模板只需在数组中加一项
//
// `alwaysPrints` / `hasContent` 只服务一件事:**决定打印时给不给格子画虚线边框**
// (规则见下面 isBlankOnPaper 的注释)。新增模板时建议一并写清楚,漏写会走通用兜底。
const templates = [
{
label: 'I5_10400F_16G_256G_1060',
component: I5_10400F_16G_256G_1060,
formSchema: formSchema_I510400F,
formData: initialValues_I510400F
formData: initialValues_I510400F,
// 带左侧固定信息区(店铺名 / 电话 / 二维码),字段全空也仍有墨
alwaysPrints: true
},
{
label: 'I5_10400F_16G_256G_2060',
component: I5_10400F_16G_512G_2060,
formSchema: formSchema_I510400F2060,
formData: initialValues_I510400F2060
formData: initialValues_I510400F2060,
alwaysPrints: true
},
{
label: 'I5_9400F_16G_256G_1060',
component: I5_9400F_16G_256G_1060,
formSchema: formSchema_I59400F,
formData: initialValues_I59400F
formData: initialValues_I59400F,
alwaysPrints: true
},
{
label: 'I5_4590_8G_120G',
component: I5_4590_8G_120G,
formSchema: formSchema_I54590,
formData: initialValues_I54590
formData: initialValues_I54590,
alwaysPrints: true
},
{
label: 'I3_4130_8G_120G',
component: I3_4130_8G_120G,
formSchema: formSchema_I34130,
formData: initialValues_I34130
formData: initialValues_I34130,
alwaysPrints: true
},
{
label: 'G3260_8G_120G',
component: G3260_8G_120G,
formSchema: formSchema_G3260,
formData: initialValues_G3260
formData: initialValues_G3260,
alwaysPrints: true
},
{
label: '24寸一体机_I5_3代_8G_256G',
component: All_in_one_24_8G_256G,
formSchema: formSchema_24AllInOne,
formData: initialValues_24AllInOne
formData: initialValues_24AllInOne,
alwaysPrints: true
},
{
label: '22寸一体机_4G_120G',
component: All_in_one_22_4G_120G,
formSchema: formSchema_22AllInOne,
formData: initialValues_22AllInOne
formData: initialValues_22AllInOne,
alwaysPrints: true
},
{
label: 'HardDisk',
component: HardDisk,
formSchema: formSchema_HardDisk,
formData: initialValues_HardDisk
formData: initialValues_HardDisk,
alwaysPrints: true
},
{
label: 'Error',
component: Error,
formSchema: formSchema_Error,
formData: initialValues_Error
formData: initialValues_Error,
// 只显示标题 / 说明 / 时间,三个都空就是纸上没东西
hasContent: (c) => [c?.title, c?.reason, c?.time].some((v) => String(v ?? '').trim() !== '')
},
{
label: 'CustomTag',
component: CustomTag,
formSchema: formSchema_CustomTag,
formData: initialValues_CustomTag
formData: initialValues_CustomTag,
// 只有「文字非空的那些行」会显示,颜色 / 字号不算内容
hasContent: (c) => (c?.lines || []).some((line) => String(line?.text ?? '').trim() !== '')
}
];
@@ -197,6 +215,48 @@ const people = reactive(
templates.map(({ label, formSchema, formData }) => ({ label, formSchema, formData }))
);
const templateMap = new Map(templates.map(({ label, component }) => [label, component]));
const templateByLabel = new Map(templates.map((t) => [t.label, t]));
/**
* 通用兜底:扫一遍 config,只要有**非空白的字符串**就认为有内容,数组逐项下钻。
*
* 只在模板没声明 `hasContent` 时用。它偏宽松 —— 像 CustomTag 的 `color: '#000000'`
* 会被算成内容,所以有意义的模板请自己声明 `hasContent`。
* 偏向「宽松」是故意的:多印一个空框看得见、好排查;把有内容的标签判成空的,
* 用户会以为东西丢了。
*/
const hasVisibleContent = (value) => {
if (typeof value === 'string') return value.trim() !== '';
if (Array.isArray(value)) return value.some(hasVisibleContent);
if (value && typeof value === 'object') return Object.values(value).some(hasVisibleContent);
return false; // 数字 / 布尔不需要「填」,否则 size: 4 会被误判
};
/**
* 这一格**打印出来纸上会不会有东西**。
*
* 用途只有一个:决定要不要画那圈虚线边框。规则一句话 ——
* **边框代表「这一格纸上有东西」**,所以纸上什么都没有的格子不该有边框:
*
* | 情况 | 纸上 | 边框 |
* | --- | --- | --- |
* | 空格(没选模板) | 无 | 不画 |
* | 双击隐藏 | 无 | 不画 |
* | 模板选了但内容全空(如自定义文字所有行都空) | 无 | 不画 |
* | 有内容 | 有 | 画 |
*
* 前两种按状态就能判(name / hidden),第三种要看模板:规格类模板**即使字段全空,
* 左侧固定信息区(店铺名 / 电话 / 内置二维码)照印**,所以直接短路成「有内容」——
* 否则用户把字段清空后会发现边框莫名其妙没了。
*/
const isBlankOnPaper = (slot) => {
if (!slot?.name) return true; // 空格
if (slot.hidden) return true; // 双击隐藏:内容不打印,纸上看和空格一样
const tpl = templateByLabel.get(slot.name);
if (tpl?.alwaysPrints) return false;
const hasContent = tpl?.hasContent || hasVisibleContent;
return !hasContent(slot.config || {});
};
// ---------- 固定 44 个格子(每格可单独编辑) ----------
const TOTAL = 44;