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 覆盖,该版本尚未交付)。
This commit is contained in:
@@ -24,6 +24,38 @@
|
||||
|
||||
import qrcode from "qrcode-generator";
|
||||
|
||||
/* ================================================================== */
|
||||
/* 出图缓存 */
|
||||
/* ================================================================== */
|
||||
|
||||
/**
|
||||
* 为什么要缓存。
|
||||
*
|
||||
* 页面每次重渲染都会重新构造「标签上下文」对象(`labelContext(slot)`),
|
||||
* 子组件的 computed 跟着失效、重算 —— 也就是**每一格都会重新拼一遍 SVG**。
|
||||
* 一个 25×25 的二维码是 600 多个 `<rect>`,44 格就是 2 万多个节点;
|
||||
* 用户点一下格子、改一下数量,浏览器就得重新解析一遍这些字符串,
|
||||
* 表现为「点一下卡半秒」。
|
||||
*
|
||||
* 而真正变化的东西很少:同一个 SN、同一套参数,出来的 SVG 必然一模一样。
|
||||
* 所以按「参数指纹」缓存字符串。用 FIFO 封顶,避免长时间换参数导致无限增长。
|
||||
*/
|
||||
const CACHE_LIMIT = 400;
|
||||
const svgCache = new Map<string, string>();
|
||||
|
||||
function cached(key: string, build: () => string): string {
|
||||
const hit = svgCache.get(key);
|
||||
if (hit !== undefined) return hit;
|
||||
const svg = build();
|
||||
if (svgCache.size >= CACHE_LIMIT) {
|
||||
// Map 保持插入顺序,删最老的那个即可
|
||||
const oldest = svgCache.keys().next().value;
|
||||
if (oldest !== undefined) svgCache.delete(oldest);
|
||||
}
|
||||
svgCache.set(key, svg);
|
||||
return svg;
|
||||
}
|
||||
|
||||
/* ================================================================== */
|
||||
/* Code 128 Set B */
|
||||
/* ================================================================== */
|
||||
@@ -139,6 +171,14 @@ export const LABEL_BARCODE_STRIP_MM = code128HeightMm(LABEL_BARCODE_OPTS);
|
||||
* (`ZP-260928-0001-R` 是 16 位,短码只有 12 位),固定模块宽度会时宽时窄。
|
||||
*/
|
||||
export function code128Svg(text: string, opts: BarcodeOptions = {}): string {
|
||||
// 指纹按**解析后的默认值**拼,避免 `{}` 与显式默认值产生两份缓存
|
||||
const key =
|
||||
`b|${text}|${opts.widthMm ?? 46}|${opts.heightMm ?? 7}|` +
|
||||
`${opts.showText !== false}|${opts.textMm ?? 1.9}`;
|
||||
return cached(key, () => buildCode128Svg(text, opts));
|
||||
}
|
||||
|
||||
function buildCode128Svg(text: string, opts: BarcodeOptions = {}): string {
|
||||
const widthMm = opts.widthMm ?? 46;
|
||||
const heightMm = opts.heightMm ?? 7;
|
||||
const showText = opts.showText !== false;
|
||||
@@ -239,6 +279,11 @@ export interface QrOptions {
|
||||
* 二维码会自己跟着缩,不需要在 JS 里重复算一遍布局。
|
||||
*/
|
||||
export function qrSvg(text: string, opts: QrOptions = {}): string {
|
||||
const key = `q|${text}|${opts.ec ?? "M"}|${opts.quiet ?? 4}|${opts.dark ?? "#000"}`;
|
||||
return cached(key, () => buildQrSvg(text, opts));
|
||||
}
|
||||
|
||||
function buildQrSvg(text: string, opts: QrOptions = {}): string {
|
||||
const quiet = opts.quiet ?? 4;
|
||||
const dark = opts.dark ?? "#000";
|
||||
|
||||
|
||||
Reference in New Issue
Block a user