funjia b78d104728 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。
2026-10-04 01:14:04 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00
2025-08-15 09:45:45 +08:00

标签打印系统(Label Print System)

一个基于 Vue 3 + Vite + Tailwind CSS + Headless UI 的标签排版与打印工具。把一张 A4 标签纸按 4 列 × 11 行 = 44 格 排版,每格对应一枚实际标签,可批量排版、逐格编辑,并按打印边距输出。


两种形态

位置 形态 用途
仓库根目录(本 README 描述的部分) 独立 Web 应用 npm run dev 直接跑,适合快速改模板 / 试排版
plugin/ FunjiaUI 远端插件 funjia.print-tag 装进宿主(设备管理 → 标签打印),并支持可选接入 SN 码接口生成真条码 / 二维码

两个形态功能一致:44 格版面、11 个内置模板、批量填充、逐格编辑、打印边距全部保持原样。 插件形态额外把「店铺名 / 电话」做成可配置,并加了可选的 SN 码能力。 插件工程里也有一个自带 mock 后端的本地预览器,改代码不必每次都装进宿主。


功能简介

标签版面

  • 一张纸固定 44 格(4 × 11),每格尺寸 48.5mm × 25.4mm,版面宽 194mm;
  • 屏幕预览模拟真实标签纸,格子带序号角标(1–44),打印时不输出角标;
  • 空格显示为浅色虚线圈,有内容的格子显示内容边框。

内置标签模板

模板 说明
I5_10400F_16G_256G_1060 / I5_10400F_16G_512G_2060 / I5_9400F_16G_256G_1060 台式机配置标签(CPU / 内存 / 硬盘 / 显卡)
I5_4590_8G_120G / I3_4130_8G_120G / G3260_8G_120G 台式机配置标签(CPU / 内存 / 硬盘 / 系统)
22寸一体机_4G_120G / 24寸一体机_I5_3代_8G_256G 一体机标签(标题 / CPU / 内存 / 硬盘)
HardDisk 硬盘标签(系统 / 分区 / 硬盘 / 品牌)
Error 售后/故障标签(标题 / 说明 / 时间)
CustomTag 自定义文字标签:行数可自由增删

模板都包含左侧固定信息区(二维码图片、店铺名、电话)与右侧规格区。 二维码图片需放在站点根目录(如 public/qrcode.png)才会显示。

批量填充

  • 顶栏选择“批量模板”→ 在「① 批量填充设置」中配置内容 → 点「保存模板配置」→ 点「批量添加」;
  • “批量添加”会按设置的数量,从第一个空格开始依次填入模板副本,适合快速铺满同类标签。

逐格自定义编辑

  • 单击任意格子:在「② 编辑第 N 格」中为该格选择模板并单独填写内容(「填入该格」/「保存到该格」),每格内容相互独立;
  • 有内容的格子会自动带出它的模板与内容,便于直接修改;
  • 双击格子:隐藏 / 恢复该格内容(打印时该格留空但保留格子框),也可在编辑面板中用按钮操作;
  • 「删除该格」把格子恢复为空格,其余格子的位置不受影响。

CustomTag 自定义文字

  • 每行可输入一段文字(支持换行、自动居中折行显示);
  • 每行可单独设置:字号 (mm)、颜色(黑 / 深灰 / 红 / 橙 / 蓝 / 绿)、加粗;
  • 空行自动跳过不显示,也可以借此“临时停用”某一行;
  • 添加 / 删除行随时进行(最多 20 行)。

打印

  • 可设置打印数量(批量添加用)与 上下 / 左右边距 (cm) —— 含义是标签纸离纸边的距离;
  • 点「打印」会临时注入打印样式并调用 window.print();若运行环境提供 window.electronAPI.silentPrint 则走静默打印。 Ctrl+P 也走同一套样式(靠 beforeprint 监听),不点按钮直接打印同样干净;
  • 打印时只输出标签版面:工具栏、面板、序号角标、空格虚线引导、双击隐藏的格子内容都不打印;
  • 不留浏览器页眉页脚(左上角日期时间 / 标题、底部 URL / 页码):做法是把 @page 边距设成 0 —— 浏览器只在「页边距那块空白」里画页眉页脚,边距没了它自然就不画。标签纸的位置改由 .page 的 left / top 控制,物理结果与用页边距时完全一致。

⚠️ 这套做法在 Chrome / Edge 上可靠。Firefox 的页眉页脚是打印对话框里的独立选项, CSS 控制不了,需要在打印设置里手动取消勾选「页眉和页脚」。


使用步骤

  1. 安装依赖

    npm install
    
  2. 启动开发服务器

    npm run dev
    

    浏览器打开终端提示的地址(默认 http://localhost:5173)。

  3. 批量排版同类标签

    • 顶部“批量模板”下拉选择模板(如 HardDisk);
    • 在左侧「① 批量填充设置」中修改字段(可先点「保存模板配置」);
    • 顶栏输入“数量”,点「批量添加」,标签会依次填入空格。
  4. 单独排版某一张标签

    • 单击目标格子,左侧出现「② 编辑第 N 格」;
    • 选择“该格使用模板”,填写内容;
    • 空格点「填入该格」,已有内容点「保存到该格」;
    • 需要跳过该格打印:双击格子或点「隐藏(不打印)」。
  5. 自定义文字标签(CustomTag)

    • 模板选 CustomTag(批量或单格均可);
    • 逐行输入文字,设置字号 / 颜色 / 加粗,用「+ 添加一行」增行;
    • 保存并添加后,格子内按行居中显示对应颜色与字号的文字。
  6. 调整打印边距并打印

    • 顶栏修改“上下边距 / 左右边距”(cm);
    • 点「打印」,在打印预览中确认后输出。
  7. 清空版面

    • 点「清空全部」一次性恢复全部 44 格为空。

生产构建

npm run build   # 产物输出到 dist/
npm run preview # 本地预览构建产物

目录结构

src/
├─ main.js / App.vue / style.css      # 入口与全局样式
└─ components/
   ├─ Main.vue                        # 主页面:44 格模型、批量填充、单格编辑
   ├─ LabelCell.vue                   # 单个标签格外壳(角标/选中/占位/隐藏/打印)
   ├─ DynamicForm.vue                 # 通用动态表单(input/select/textarea/lines)
   ├─ Input/  Select/                 # 自绘输入框与下拉选择
   ├─ CustomTag.vue                   # 自定义文字模板(行数/字号/颜色/加粗)
   ├─ Error.vue …                     # 各规格标签内容模板(config 驱动)
   └─ (LabelShell.vue 已废弃移除)

技术要点

  • 每个格子是固定 44 个 LabelCell,与真实标签纸物理位置一一对应,打印时仅输出有内容的区域;
  • 模板通过“模板注册表”(templates 数组)统一注册,新增模板只需在 Main.vue 中加一项;
  • 数据一律深拷贝快照,保证批量与逐格之间互不干扰;
  • 打印样式使用 @page margin + @media print 控制,屏幕上的一切编辑辅助元素均不进入打印。
S
Description
No description provided
Readme
280 KiB
Languages
TypeScript 43.5%
Vue 40.4%
JavaScript 8.9%
Shell 4.3%
CSS 2.3%
Other 0.6%