@goodboy008/labelize-wasm

中文文档
1.12.0发布于 2026/11/12MIT AND BSD-3-ClauseTypeScriptES Module零依赖近 30 天下载 4680

标签化 ZPL/EPL/TSPL/CPCL/DPL 标签渲染器编译到WebAssembly-在浏览器,Node.js和捆绑器中将标签数据给PNG/PDF

中文使用文档
文档目录6 节
  1. 使用量
  2. Bundlers (网页包 5, Vite 带有 vite-plugin-wasm (中文(简体) )
  3. 节点.js( ·20)
  4. API 密码
  5. 释放资产
  6. 许可证

Labelize logo

@好男孩008/标签化-wasm

这个 标签 编入WebAssembly的ZPL/EPL/TSPL/CPCL/DPL标签引擎. 将 ZPL, ESL, TSPL/ TSC, CPCL 或 DPL 标签数据完全在浏览器、 Node.js 或您的 捆绑者——不需要服务器.

使用量

Bundlers (网页包 5, Vite 带有 vite-plugin-wasm(中文(简体) )

import { lz_render } from "@goodboy008/labelize-wasm";

const zpl = new TextEncoder().encode("^XA^FO50,50^A0N,40,40^FDHELLO WORLD^FS^XZ");
const png = lz_render(zpl, 102.0, 152.0, 8, false, false, false);
// png is a Uint8Array — pass it to an <img> via URL.createObjectURL

软件包是标准hem-bindgen捆绑器输出 : labelize_wasm.js 初始化 模块顶层的引擎和导出 lz_render 编号 : lz_render_lang 编号 : lz_playground_html。 。 。 .

节点.js( ·20)

import { lz_render } from "@goodboy008/labelize-wasm/init";

const zpl = Buffer.from("^XA^FO50,50^A0N,40,40^FDHELLO WORLD^FS^XZ", "ascii");
const png = lz_render(zpl, 102.0, 152.0, 8, false, false, false);

这个 /init 子路径将引擎从包件中即时化 .wasm 直接, 没有捆绑者支持或节点旗帜.

API 密码

lz_render(src, width_mm, height_mm, dpmm, antialias, want_pdf, is_epl) -> Uint8Array

段落含义
src原始标签字节( ZPL 或 ESL 当 is_epl = true(中文(简体) )
width_mm 编号 : height_mm以毫米计的标签帆布大小( 默认: 102 × 152)
dpmm每毫米点数( 默认 8)
antialias将渲染器灰色保持为 1- 位
want_pdf返回 PDF 而不是 PNG
is_epl解析输入为 IPL 而不是 ZPL

lz_render_lang(src, width_mm, height_mm, dpmm, antialias, want_pdf, lang) -> Uint8Array 这是 语言解释性变体: lang 实值 "zpl", (中文(简体) ), "epl", (中文(简体) ), "tspl", (中文(简体) ), "cpcl",或 "dpl" (TSPL/TSC和CPCL标签;标签本身) SIZE 在 TSPL 中不覆盖 width_mm编号 :height_mm 你通过 - 大小画布像任何其他 输入). 未知 lang 值返回到 ZPL .

import { lz_render_lang } from "@goodboy008/labelize-wasm/init";

const tspl = Buffer.from('SIZE 101.6 mm,152.4 mm\nCLS\nTEXT 40,40,"4",0,1,1,"HELLO WORLD"\nPRINT 1', "ascii");
const png = lz_render_lang(tspl, 101.6, 152.4, 8, false, false, "tspl");

丢出带有失败阶段的字符串前缀错误 : 1: 分析错误, 2: 渲染错误.

lz_validate(src, dpmm, lang) -> string 语法检查没有渲染,而且从未投出—— jSON报告载有结果,所以SDK呼叫者得到准确的解析错误而不是赤裸 抛出字符串 :

import { lz_validate } from "@goodboy008/labelize-wasm/init";

const report = JSON.parse(lz_validate(src, 8, "")); // "" = auto-detect the language
// { language: "zpl", ok: true,  labels: 1 }
// { language: "epl", ok: false, labels: 0, error: "Parse error: EPL X command requires 5 parameters, got 2" }

if (!report.ok) console.error(`[${report.language}] ${report.error}`);

lz_format(src, lang) -> Uint8Array 相当的打印来源: 每行一个命令, ^XA 区块缩进, CRLF 规范化。 二进制有效载荷^FD 数据, GW编号 :BITMAP 图形)通过 通过字节换字节,所以格式化的源使像素-等同:

import { lz_format } from "@goodboy008/labelize-wasm/init";

const pretty = new TextDecoder().decode(lz_format(src, "")); // "" = auto-detect

lz_encode(src, dpmm, threshold, lang) -> Uint8Array 转换已编码的图像 (PNG/JPEG/GIF/BMP)改为打印机代码. lang 必须是 "zpl" 或者说 "tspl" (对案件不敏感); 不支持的目标、无效的图像和无效的选项 1: 输入出错. 一个图像像素变成一个打印机点. 阈值默认由调用者提供: 128使128平面下复合光度为黑色;透明像素平面为白色. 编码输入尊重 EXIF 方向 。 图像限于16个米像素,32000 每个维度点和128个已解码数据的米B.

import { readFileSync, writeFileSync } from "node:fs";
import { lz_encode } from "@goodboy008/labelize-wasm/init";

const source = readFileSync("logo.png");
writeFileSync("logo.zpl", lz_encode(source, 8, 128, "zpl"));
writeFileSync("logo.tspl", lz_encode(source, 8, 128, "tspl")); // binary BITMAP payload

生成的 ZPL 在 Zebra 内部需要时使用多个图形字段 999999字节字段限制. 对于匹配的 ZPL 预览,请将画布设置为图像 宽度/ 高度除以 dpmm 以毫米计。 TSPL本身宣布这个尺寸.

lz_playground_html() -> string 返回标签游戏页面(与 HTTP 服务器 /) (中文(简体) ).

释放资产

GitHub 发布也附加 labelize-wasm-wasm32.zip 与生胶 + .wasm 文档, 用于无 npm 的直接使用。 见 wasm/build.sh 以重建引擎:

cd wasm && ./build.sh   # requires Rust wasm32 target + wasm-bindgen-cli

许可证

麻省理工学院和BSD-3级

版本与发布记录

@goodboy008/labelize-wasm 共发布 12 个版本,首次发布于 2026/08/23;过去 12 个月发布了 12 个版本。

版本发布日期距今
1.12.0latest2026/11/124 天前
1.11.02026/11/115 天前
1.10.02026/10/2819 天前
1.9.02026/10/2126 天前
1.8.12026/10/161 个月前
1.8.02026/10/131 个月前

关于 @goodboy008/labelize-wasm 的常见问题

@goodboy008/labelize-wasm 是什么?

标签化 ZPL/EPL/TSPL/CPCL/DPL 标签渲染器编译到WebAssembly-在浏览器,Node.js和捆绑器中将标签数据给PNG/PDF

如何安装 @goodboy008/labelize-wasm?

在项目目录运行 npm install @goodboy008/labelize-wasm,或使用 pnpm add / yarn add / bun add。

@goodboy008/labelize-wasm 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@goodboy008/labelize-wasm 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@goodboy008/labelize-wasm 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@goodboy008/labelize-wasm 可以商用吗?

@goodboy008/labelize-wasm 使用 MIT AND BSD-3-Clause 许可。声明的许可为 MIT AND BSD-3-Clause,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@goodboy008/labelize-wasm 的下载量有多少?

根据 npm 官方下载统计,@goodboy008/labelize-wasm 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,680 次,日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@goodboy008/labelize-wasm 还在维护吗?

最新版本 1.12.0 发布于 2026/11/12(4 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/08/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。