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:
@@ -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",
|
||||
|
||||
@@ -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 的话,
|
||||
|
||||
@@ -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;
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user