funjia
|
bde3be8f99
|
fix(plugin): 顶栏「数量」输入框与旁边两格不对齐
用户报:数量输入框和旁边的输入框未对齐。
根因不是「差一条对齐样式」,是容器宽度写死:
.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。
|
2026-10-04 01:50:56 +08:00 |
|
funjia
|
21d293775d
|
feat(plugin): 产物自带样式 —— 第三方只取 entry 也能正常显示
第三方系统装完后样式全丢。复现出来的根因是产物形态:CSS 被抽成独立文件,
仓库契约要求消费方自己读 `style` 并注入 <link>(文档写了、官方参考消费方也照做了),
但第三方很容易只取 `entry`:插件能跑、页面却是白板(布局全靠 CSS)。
实测:只取 entry 时文档里插件样式表数量 0,.pt-panel 宽度从 356px 变成撑满的 1368px。
改法:vite.config.ts 新增 selfInjectStyles() 插件,在 generateBundle 阶段
把抽出的 CSS 内联进 JS,脚本一加载就注入 <style data-funjia-plugin=…>。
- 保留 style 字段与 CSS 文件不变:按文档注入的宿主照常工作;CSP 禁止内联样式时
那条路仍是唯一出路。
- 不重复注入:先检测有没有本插件的 <style data-funjia-plugin=…>,
或 href 指向本样式文件的 <link>,有就跳过。
- 走 generateBundle 而非「写完盘再改」:后者注入发生在 vite 打印体积之后,
日志 98KB / 索引 109KB 对不上账。
- 拿不到 CSS 资源时 this.warn 显式报出,不静默少注入。
- verify.mjs 加断言盯着它(产物必须含注入器)。
验证:第三方最小消费方 4 项断言全过;宿主路径 4 项全过(CSS 恰好一份、无重复注入);
对已发布产物跑 13 项打印断言全过。产物已发布为 funjia.print-tag@1.0.3。
注意:本工程从此不再等同于 funjia-plugin-starter 的默认产物形态 ——
其他插件若也会被第三方接入,值得把这套 self-inject 搬过去。
|
2026-10-04 01:32:14 +08:00 |
|
funjia
|
a049492864
|
docs: 补上虚线边框的判定规则(边框 = 这一格纸上有东西)
|
2026-10-04 01:14:25 +08:00 |
|
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 |
|
funjia
|
b8842d5947
|
docs: 打印行为说明对齐(@page 边距为 0 的原因、Firefox 需手动关页眉、Ctrl+P 同样生效)
|
2026-10-04 00:32:23 +08:00 |
|
funjia
|
85f7f9abb4
|
fix: 打印不再输出浏览器页眉与序号(原 Web 版 + 插件版都修)
用户反馈:打印时页眉带日期时间,序号 1–44 也被印出来。两处根因如下。
1. 浏览器页眉(左上角日期时间 + 标题)
@page 边距非 0 时,浏览器会在「页边距那块空白」里画它自己的页眉页脚。
CSS 里没有关掉它的开关 —— 把边距清零、让那块空白消失,是 Chromium/Edge 上
唯一可靠的做法(Firefox 的页眉页脚是打印对话框里的独立选项,CSS 管不了)。
代价:标签纸在纸上的位置不能再靠 @page margin 给,改由 .page / .pt-paper 的
left / top 控制 —— 物理结果与之前完全一致,顶栏「上下/左右边距」的含义
变成「标签纸离纸边的距离」。
2. 序号角标与空格虚线引导照样打印
visibility 是**可被子元素覆盖的继承属性**。原来只隐 `.id` / `.pt-cell__idx`,
父元素确实隐了,但下面那条让标签纸整体可见的 `.page * { visibility: visible }`
会**直接命中里面的 <span>1</span>** 把它又显出来 —— 序号照样印在纸上,
而这条规则看上去毫无问题。现在所有「打印时不该出现」的选择器一律写成
`.x, .x *` 两段;插件版还要求它们排在 `.pt-paper *` 之后
(同特异性 + 同 !important 时后写的赢,写前面等于没写、还不报错)。
顺带修掉双击「隐藏(不打印)」的格子内容仍被打印的问题。
顺带加固:
- Ctrl+P 也走同一套样式 —— 加 beforeprint 监听(原来只有点插件按钮才注入)。
- 撤销样式改用 node.remove():对已脱离的节点调 removeChild 会抛 NotFoundError,
把整段注入打断在半路,症状是「这次打印什么都没生效」。
验证(Playwright + 本机 Edge,走真实打印管线):
- 插件版 13 项断言通过;原 Web 版 12 项断言通过。
- 两版都生成 PDF(displayHeaderFooter: true)并用浏览器 PDF 视图渲染确认:
页眉无日期时间、无序号、双击隐藏的格子留白、有内容的格子正常打印。
- 插件产物已升版本发布为 funjia.print-tag@1.0.1。
|
2026-10-04 00:32:03 +08:00 |
|
funjia
|
d95ec56e32
|
docs(plugin): README 对齐——mock 的 SN 校验位算法已镜像真后端,补 source 字段说明
|
2026-10-04 00:01:45 +08:00 |
|
funjia
|
0cbff3ccd5
|
feat(plugin): 发放 SN 带 source;插件 id 收敛到 src/meta.ts
- 新增 src/meta.ts 作为 PLUGIN_ID 的唯一字面量来源(index.ts 与页面共用)。
这个 id 同时出现在 config、自注册 manifest、菜单/路由/命令 id 前缀、
发放请求的 source 四处,任何一处抄错都是难查的静默故障。
- 发放请求加 source: funjia.print-tag(页面与 print-tag:issue-sn 命令都加)。
后端 callerMeta 明确建议插件填自己的 ID,否则 SN 台账里一律记成 pc,
分不清是插件发的还是别的入口发的。已在预览里验证落到台账。
- preview/mock-api.ts 的 SN 部分改为逐位镜像真后端(库存管理系统
backend/src/api/sn-code/):校验位算法与字符表照抄,SN 形状/正则/补位口径一致。
实测 mock 产出的 SN 全部能通过真后端校验位算法 —— 本地调通的码切到真后端不会失效。
最终验收:typecheck 通过;插件自检 0 error;仓库 verify-repository 32 passed / 0 failed;
repo-doctor 0 error 0 warning;源码模式与产物模式预览均跑通且无控制台报错。
|
2026-10-04 00:01:26 +08:00 |
|
funjia
|
7c986fd5c5
|
perf(plugin): 条码/二维码 SVG 加参数指纹缓存
页面每次重渲染都会重新构造标签上下文对象,TagShell 的 computed 随之失效 ——
44 格的二维码每次都要重拼 2 万多个 <rect>,点一下格子就可能卡半秒。
按「参数指纹」缓存字符串即可(同一个 SN + 同一套参数,SVG 必然一模一样),
FIFO 上限 400 条避免无限增长。顺带把缓存块挪到文件前部(原在声明之后,读起来别扭)。
已用真实模块做过端到端验证(esbuild 打包 src/codes.ts 后跑 node):
- qrSvg 的真实 SVG 反解回矩阵 → jsQR 解码,6/6 与原串一致;
- code128Svg 的真实 rect 还原成游程序列 → 与 code128Bits 逐段一致(A / 16 位 SN / 12 位 SN);
- 缓存:同参数命中、换参数/换文本不串味、显式默认值与省略命中同一份。
产物已重新发布到插件仓库(同版本 1.0.0 覆盖,该版本尚未交付)。
|
2026-10-03 23:53:56 +08:00 |
|
funjia
|
ef41d98838
|
feat: 新增 plugin/ 插件化形态(funjia.print-tag)+ 可选 SN 条码/二维码
把本工程的标签排版能力改造成 FunjiaUI 远端插件,放进 plugin/ 子目录,
与原独立 Web 版并存(两者功能一致,模板/版面/打印行为逐项对齐)。
- 入口从 createApp().mount() 改为 activate(ctx) + ctx.addRoute,注册 1 菜单 / 1 路由 / 2 命令
- 11 个模板的渲染收敛成 SpecTag,差异集中到 templates/registry.ts(字段/选项/默认值原样保留)
- 店铺名 / 电话从写死改为可配置,记忆在插件私有存储
- 内置二维码图片改为打包 data URL —— 远端插件没有自己的 public/
- 去掉 @headlessui/vue(换原生 select)与 Tailwind,样式类名统一 pt- 前缀避免污染宿主
- 可选接入宿主 api::sn-code:按 SN 生成真 Code 128 条码与可扫二维码;
关闭时(默认)完全保持原静态二维码行为。领码优先贴到已排版的格子,不够才新建
- 新增 commands: print-tag:issue-sn / print-tag:render-svg(后者纯本地出图,供其它插件复用)
- code128.ts 实现真 Code 128 Set B(含校验位);二维码走 qrcode-generator(真 QR)
- 自带本地预览器(preview/mock-api.ts 补了 /api/sn-codes mock)与 deploy / verify 脚本
- verify.mjs 修掉一处误报:源码边界判据改为「解析后是否逃出工程根」,
而不是「说明符是否以 .. 开头」(后者会把 src/components/X.vue → ../codes 误判为越界)
已发布到插件仓库:funjia.print-tag@1.0.0
|
2026-10-03 23:48:32 +08:00 |
|