bde3be8f99ac4c8d1945c12427875798091b9862
用户报:数量输入框和旁边的输入框未对齐。
根因不是「差一条对齐样式」,是容器宽度写死:
.pt-toolbar__group { width: 160px } —— 但「打印设置」那组是三个 104px 的输入框
(含 gap 需要 332px),flex 只能把每个压到 46.7px。于是标签「数量」(两个字)
是一行、「上下边距(cm)」折成两行,输入域顶部实测 285 / 301 / 301,差 16px。
改法:
- .pt-toolbar__group 不再写死宽度(flex: 0 0 auto,按内容撑开);
只有下拉那一组需要定宽,单独给它 .pt-toolbar__group--template(160px)。
- 顶栏的输入标签加 white-space: nowrap、输入框加 flex: 0 0 auto:
以后标签文字再长也只会溢出,不会折行把同组其它输入框的输入域顶下去。
- 输入框 104 → 96px、inputs gap 10 → 8、toolbar gap 18 → 16:
1440px 视口下顶栏原本只差 24.5px 就换行(toolbar 内容 931.2 vs 可用 906.7),
收一收保持单行。这三个框只输「3 / 0.89 / 0.8」这类短值,宽了没收益。
原独立 Web 版查过,**没有**这个问题:它的 .tool-group 本来就没写死宽度,
1680 / 1440 / 1280 三种视口实测输入域 top 全一致(都是 83),所以本次不动它。
verify.mjs 的体积判据也换掉了:本插件内联 CSS 后产物 109KB,原来是「>60KB 就怀疑
内联了 vue」,从此会一直误报。现在改认 Vue 运行时的**实现端**符号
(__v_isRef / effectScope / createBaseVNode / shallowReadonly,本插件产物里恒为 0)。
注意不能用 createElementBlock 当判据 —— 那是编译后的渲染函数在**调用**它
(本插件产物里出现 65 次),拿它判会把正常产物判成内联。已用 vue.global.js
当负样本验证过这条断言真能拦住;自检现在 0 error 0 warning。
验证(发布产物,Playwright + 本机 Edge):
- 顶栏三格输入域 top 全为 285(aligned=true),label 全为单行;
- 1680 / 1440 单行不换行,1280 依旧同排;
- 13 项打印断言 + 5 项边框断言回归通过;
- 第三方消费方 4 项、宿主路径 4 项全过(CSS 恰好一份)。
产物已发布为 funjia.print-tag@1.0.4。
标签打印系统(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 控制不了,需要在打印设置里手动取消勾选「页眉和页脚」。
使用步骤
-
安装依赖
npm install -
启动开发服务器
npm run dev浏览器打开终端提示的地址(默认 http://localhost:5173)。
-
批量排版同类标签
- 顶部“批量模板”下拉选择模板(如
HardDisk); - 在左侧「① 批量填充设置」中修改字段(可先点「保存模板配置」);
- 顶栏输入“数量”,点「批量添加」,标签会依次填入空格。
- 顶部“批量模板”下拉选择模板(如
-
单独排版某一张标签
- 单击目标格子,左侧出现「② 编辑第 N 格」;
- 选择“该格使用模板”,填写内容;
- 空格点「填入该格」,已有内容点「保存到该格」;
- 需要跳过该格打印:双击格子或点「隐藏(不打印)」。
-
自定义文字标签(CustomTag)
- 模板选
CustomTag(批量或单格均可); - 逐行输入文字,设置字号 / 颜色 / 加粗,用「+ 添加一行」增行;
- 保存并添加后,格子内按行居中显示对应颜色与字号的文字。
- 模板选
-
调整打印边距并打印
- 顶栏修改“上下边距 / 左右边距”(cm);
- 点「打印」,在打印预览中确认后输出。
-
清空版面
- 点「清空全部」一次性恢复全部 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控制,屏幕上的一切编辑辅助元素均不进入打印。
Languages
TypeScript
43.5%
Vue
40.4%
JavaScript
8.9%
Shell
4.3%
CSS
2.3%
Other
0.6%