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
+1 -1
View File
@@ -1,7 +1,7 @@
{
"id": "funjia.print-tag",
"name": "标签打印",
"version": "1.0.1",
"version": "1.0.2",
"kind": "iife",
"artifact": "PrintTagBundle.iife.js",
"style": "PrintTagBundle.css",
+20
View File
@@ -6,6 +6,7 @@
'pt-cell--placeholder': !item?.name,
'pt-cell--selected': selected,
'pt-cell--hidden': !!item?.hidden,
'pt-cell--blank-on-paper': blankOnPaper,
}"
:title="!item?.name ? '空格:单击选中后可编辑' : item.hidden ? '已隐藏(双击恢复显示)' : '双击隐藏内容'"
@click="emit('select')"
@@ -32,6 +33,13 @@ defineProps({
index: { type: Number, required: true },
item: { type: Object, default: null },
selected: { type: Boolean, default: false },
/**
* 这一格**打印出来纸上不会有任何东西**(空格 / 双击隐藏 / 模板选了但内容全空)。
*
* 由页面算好传进来,而不是这里自己推:只有页面知道模板的内容规则
* (见 `PrintTagPage.vue` 的 `isBlankOnPaper`)。LabelCell 保持「只管外观」。
*/
blankOnPaper: { type: Boolean, default: false },
});
const emit = defineEmits(["select", "toggle-hide"]);
@@ -125,6 +133,18 @@ const emit = defineEmits(["select", "toggle-hide"]);
/* ====== 打印 ====== */
@media print {
/**
* 虚线边框的含义是「**这一格纸上有东西**」。所以:
*
* - 空格(`.pt-cell--placeholder`)不画 —— 下面第一条;
* - 双击隐藏、以及「模板选了但内容全空」(`.pt-cell--blank-on-paper`)同样不画 ——
* 这两种在纸上看和空格完全一样,印个空框出来纯属干扰。
* - 真正有内容的格子保留边框。
*/
.pt-cell--blank-on-paper {
border-color: transparent !important;
}
/**
* ⚠️ 选择器必须写成 `.x, .x *` 两段 —— 序号角标里的数字在一个 `<span>` 里,
* 而 `visibility` 是**可被子元素覆盖的继承属性**:只隐父 div 的话,
+41 -1
View File
@@ -207,6 +207,7 @@
:index="i"
:item="slot"
:selected="selectedIndex === i"
:blank-on-paper="isBlankOnPaper(slot)"
@select="onCellSelect(i)"
@toggle-hide="toggleHidden(i)"
>
@@ -234,7 +235,14 @@ import Input from "../components/Input.vue";
import Select from "../components/Select.vue";
import DynamicForm from "../components/DynamicForm.vue";
import LabelCell from "../components/LabelCell.vue";
import { TEMPLATE_COMPONENTS, TEMPLATE_FIELDS, TEMPLATE_OPTIONS } from "../templates/registry";
import {
TEMPLATE_HAS_CONTENT,
TEMPLATE_COMPONENTS,
TEMPLATE_FIELDS,
TEMPLATE_MAP,
TEMPLATE_OPTIONS,
hasVisibleContent,
} from "../templates/registry";
/* ================================================================== */
/* 宿主上下文 */
@@ -613,6 +621,33 @@ const onIssueOneSn = async () => {
}
};
/**
* 这一格**打印出来纸上会不会有东西**。
*
* 用途只有一个:决定要不要画那圈虚线边框。规则统一成一句话 ——
* **边框代表「这一格纸上有东西」**,所以纸上什么都没有的格子不该有边框:
*
* | 情况 | 纸上 | 边框 |
* | --- | --- | --- |
* | 空格(没选模板) | 无 | 不画 |
* | 双击隐藏 | 无 | 不画 |
* | 模板选了但内容全空(如 CustomTag 所有行都空) | 无 | 不画 |
* | 有内容 | 有 | 画 |
*
* 前两种是「按状态」判定的(`name` / `hidden`),第三种要看模板:
* **规格类模板即使字段全空,左侧固定信息区(店铺名 / 电话 / 内置二维码)照印**,
* 所以它们直接短路成「有内容」—— 否则用户把字段清空后会发现边框莫名其妙没了。
*/
const isBlankOnPaper = (slot: Slot): boolean => {
if (!slot.name) return true; // 空格
if (slot.hidden) return true; // 双击隐藏:内容不打印,纸上看和空格一样
const tpl = TEMPLATE_MAP.get(slot.name);
if (tpl?.alwaysPrints) return false; // 规格类一定有左侧固定信息区
// 模板自己说了算(见 TagTemplate.hasContent),没声明则走通用兜底
const hasContent = TEMPLATE_HAS_CONTENT.get(slot.name) ?? hasVisibleContent;
return !hasContent(slot.config ?? {});
};
/* ================================================================== */
/* 单格编辑 */
/* ================================================================== */
@@ -752,6 +787,11 @@ const applyPrintStyles = () => {
.pt-cell--placeholder, .pt-cell--placeholder *,
.pt-hide, .pt-hide * { visibility: hidden !important; }
/* 虚线边框 = 「这一格纸上有东西」。纸上什么都没有的格子(空格 / 双击隐藏 /
模板内容全空)不画边框 —— 纸上看它和空格一模一样,印个空框只是干扰。
判定见 isBlankOnPaper()。 */
.pt-cell--blank-on-paper { border-color: transparent !important; }
/* 标签纸钉在纸边偏移处:@page 边距已经是 0,位置只能自己给 */
.pt-paper {
position: absolute;
+70 -3
View File
@@ -48,8 +48,35 @@ export interface TagTemplate {
formData: Record<string, any>;
/** 仅 SpecTag 使用:右侧规格行按此顺序取值 */
fields?: string[];
/**
* 这个模板**即使字段全空,纸上也一定会印出东西**。
*
* 规格类模板走 `TagShell` 时会画左侧固定信息区(店铺名 / 电话 / 内置二维码图片),
* 那部分不来自 `config`,所以「config 是空的」并不等于「纸上没东西」。
*
* 这个标记只服务一件事:**决定要不要给格子印虚线边框**
* (规则见 `PrintTagPage.vue` 的 `isBlankOnPaper`)。漏标会让
* 「字段清空的规格标签」被当成空格、连边框一起丢掉。
*/
alwaysPrints?: boolean;
/**
* 这份 config 在纸上会不会留下东西。**省略时退回通用的 `hasVisibleContent`**。
*
* 为什么不能全靠通用判定:`CustomTag` 的行是 `{ text, size, bold, color }`,
* 通用判定扫到 `color: "#000000"` 就认为「有内容」了 —— 于是文字全清空的
* 标签仍被判成有内容、纸上印出一个空框。`size` 之类同理。
* **只有模板自己知道哪些字段是"给人看的"**,所以让它自己说。
*
* 新加模板时不写这个也不算错(会走通用判定),但那种判定偏宽松 ——
* 宁可多印一个框也不该把有内容的标签判成空的,这是刻意选的偏向。
*/
hasContent?: (config: Record<string, any>) => boolean;
}
/** 把若干字段当作「给人看的文字」来判断有没有内容 */
const anyTextFilled = (keys: string[]) => (config: Record<string, any>) =>
keys.some((key) => String(config?.[key] ?? "").trim() !== "");
/* ------------------------------------------------------------------ */
/* 复用的选项表 */
/* ------------------------------------------------------------------ */
@@ -96,8 +123,10 @@ const OS_OPTIONS = [
];
/** 台式机(带独显)三兄弟:CPU / 内存 / 硬盘 / 显卡 */
const desktopWithGpu = (cpu: string, memory: string, hardDisk: string, graphicsCard: string): Pick<TagTemplate, "formSchema" | "formData" | "fields"> => ({
const desktopWithGpu = (cpu: string, memory: string, hardDisk: string, graphicsCard: string): Pick<TagTemplate, "formSchema" | "formData" | "fields" | "alwaysPrints"> => ({
fields: ["cpu", "memory", "hardDisk", "graphicsCard"],
// 走 TagShell 且带左侧固定信息区 → 字段全空也仍有墨
alwaysPrints: true,
formSchema: {
formItems: [
{ type: "input", label: "CPU", key: "cpu", required: true },
@@ -110,8 +139,9 @@ const desktopWithGpu = (cpu: string, memory: string, hardDisk: string, graphicsC
});
/** 台式机(核显):CPU / 内存 / 硬盘 / 操作系统 */
const desktopWithOs = (cpu: string, memory: string, hardDisk: string, system: string): Pick<TagTemplate, "formSchema" | "formData" | "fields"> => ({
const desktopWithOs = (cpu: string, memory: string, hardDisk: string, system: string): Pick<TagTemplate, "formSchema" | "formData" | "fields" | "alwaysPrints"> => ({
fields: ["cpu", "memory", "hardDisk", "system"],
alwaysPrints: true,
formSchema: {
formItems: [
{ type: "input", label: "CPU", key: "cpu", required: true },
@@ -124,8 +154,9 @@ const desktopWithOs = (cpu: string, memory: string, hardDisk: string, system: st
});
/** 一体机:标题 / CPU / 内存 / 硬盘 */
const allInOne = (name: string, cpu: string, memory: string, hardDisk: string): Pick<TagTemplate, "formSchema" | "formData" | "fields"> => ({
const allInOne = (name: string, cpu: string, memory: string, hardDisk: string): Pick<TagTemplate, "formSchema" | "formData" | "fields" | "alwaysPrints"> => ({
fields: ["name", "cpu", "memory", "hardDisk"],
alwaysPrints: true,
formSchema: {
formItems: [
{ type: "input", label: "标题", key: "name", required: true },
@@ -186,6 +217,7 @@ export const TEMPLATES: TagTemplate[] = [
label: "HardDisk",
component: SpecTag,
fields: ["system", "partition", "hardDisk", "brand"],
alwaysPrints: true,
formSchema: {
formItems: [
{ type: "select", label: "系统", key: "system", options: [
@@ -221,6 +253,8 @@ export const TEMPLATES: TagTemplate[] = [
{
label: "Error",
component: ErrorTag,
// 只显示标题 / 说明 / 时间,三个都空就是纸上没东西
hasContent: anyTextFilled(["title", "reason", "time"]),
formSchema: {
formItems: [
{ type: "select", label: "标题", key: "title", options: [
@@ -238,6 +272,11 @@ export const TEMPLATES: TagTemplate[] = [
{
label: "CustomTag",
component: CustomTag,
// 只有「文字非空的那些行」会显示,颜色 / 字号不算内容
hasContent: (config) =>
((config?.lines ?? []) as Array<{ text?: string }>).some(
(line) => String(line?.text ?? "").trim() !== ""
),
formSchema: {
formItems: [
{
@@ -274,8 +313,36 @@ export const TEMPLATE_OPTIONS = TEMPLATES.map(({ label, formSchema, formData })
formData,
}));
/** 模板标识 → 模板定义(要查 `alwaysPrints` / `hasContent` 这类元信息时用它) */
export const TEMPLATE_MAP = new Map(TEMPLATES.map((t) => [t.label, t]));
/** 模板标识 → 渲染组件 */
export const TEMPLATE_COMPONENTS = new Map(TEMPLATES.map((t) => [t.label, t.component]));
/** 模板标识 → 右侧字段顺序 */
export const TEMPLATE_FIELDS = new Map(TEMPLATES.map((t) => [t.label, t.fields ?? []]));
/** 模板标识 → 判定「这份 config 在纸上有没有东西」的函数(已含通用兜底) */
export const TEMPLATE_HAS_CONTENT = new Map<string, (config: Record<string, any>) => boolean>(
TEMPLATES.map((t) => [t.label, t.hasContent ?? hasVisibleContent])
);
/**
* 通用兜底:扫一遍 config,只要有**非空白的字符串**就认为有内容,数组逐项下钻。
*
* 只在模板没声明 `hasContent` 时用。它偏宽松 —— 像 `CustomTag` 的
* `color: "#000000"`、`size: 4` 这种「不是给人看的」字段会被算成内容,
* 所以有意义的模板请自己声明 `hasContent`。
*
* 偏向「宽松」是**故意**的:多印一个空框看得见、好排查;
* 把有内容的标签判成空的,用户会以为东西丢了。
*/
export function hasVisibleContent(value: unknown): boolean {
if (typeof value === "string") return value.trim() !== "";
if (Array.isArray(value)) return value.some((item) => hasVisibleContent(item));
if (value && typeof value === "object") {
return Object.values(value as Record<string, unknown>).some((item) => hasVisibleContent(item));
}
// 数字 / 布尔不需要「填」,一律不算内容,否则 `size: 4` 会被误判
return false;
}