@genrojs/builders

中文文档
0.7.0发布于 2026/10/20Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 4246

语法驱动的构建者:从JSON语法中打出源树,用于任何方言,并有可插接的渲染器.

中文使用文档
文档目录3 节
  1. 安装和验证
  2. 文档
  3. 明确指针后缀和生 HTML

天才建筑师

构建来自JSON语法的打出源树并渲染出静态的HTML,SVG或XML. 通用渲染器还支持由方言定义的对象输出. 这个包 没有 DOM 、 浏览器订阅、 服务器或数据库依赖性 .

版本 0.7.0 (简体中文) 目标npm和JSR与包0.11合同。 Python 等值以 记录差异食谱没有执行. 构建者宣布其源代码的 sourceBag 类 static _sourceClass (单位:千美元)源类别) (中文(简体) ).

import { HtmlBuilder } from '@genro/builders';

const page = new HtmlBuilder();
page.data.setItem('price', 1234.5);
const body = page.root.html().body();
body.h1('Hello');
body.div('^price', {format: '#,##0.00', locale: 'it-IT', mask: '€ %s'});
const html = page.render();

安装和验证

在两个登记册上公布了同样的一揽子计划:

  • 无 : npm install @genrojs/builders,然后从 @genrojs/builders· ;
  • JSR: (英语) npx jsr add @genro/builders (或 bunx jsr add,然后从 @genro/builders。 。 。 .

从本地取出, 运行 npm install --no-package-lock 财务报告和审定财务报表 npm test。 。 。 . 节点(Node.js 22或后期)和Bun是支持的服务器运行时间. 第三方 npm 依赖性使用没有上限的已验证最小版本. JSR进口 使用经核实的护理范围作为所有者核准的JSR例外:出版 拒绝两者 >= 和通配符的限制。 设置和CI 在没有锁文件的情况下解决当前释放; 使用 npm update --no-package-lock 以刷新已有的安装。 包0.11.0 提供了递归人口和 当前 Python/JavaScript TYTX 格式。 消费者必须解决一个共享袋 class and TYTX register; 较旧的嵌入式 Bag副本不能共享相同的后缀. 源导入袋和TYTX作为 @genrojs/bag 财务报告和审定财务报表 @genrojs/tytx,npm 时 名称; jsr.json 将其映射到 jsr:@genro/bag 财务报告和审定财务报表 jsr:@genro/tytx每一个 因此,登记册的软件包取决于一个包类和一个TYTX登记册 由同一登记处提供.

Deno 出版物为外部依赖和豁免保持24小时冷却 jsr:@genro/* 财务报告和审定财务报表 npm:@genrojs/* 允许经核实的连续释放.

文档

本地构建 Sphinx 手册 :

python -m pip install -r docs/requirements.txt
python -m sphinx -W --keep-going -n -b html docs build/docs

手册使用经典读取多克主题. 没有配置主机或 隐含。 见 变化 用于修改本地版本.

版权2025–2026 Softwell S.r.l. Apache-2.0;参见LICENSE和NOTICE.

明确指针后缀和生 HTML

属性使用明确 ^path:{}px 模板或 ^path:=!{} 表达. 普通类 ${name} 文本仍为文字,不使用帮助属性. 静态表达式返回为无效; 耗尽的运行时间提供其编译器钩.

节点值从不插入模板符; 数据指针和解析器仍然 解决正常。 这保存了脚本内容中的JavaScript模板文字.

对于 HTML 输出,结束于 ::HTML 发出原始标记并放下 后缀。 普通的文本仍然逍遥法外。 此标记无法启用模板, 不消毒标记,也不改变逃避的属性。 譬如说, <b>${name}</b>::HTML 发射 <b>${name}</b> 从字面上说.

见 指针后缀和 dtype 迁移指南。 。 。 .

版本与发布记录

@genrojs/builders 共发布 7 个版本,首次发布于 2026/10/01;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.0latest2026/10/2026 天前
0.6.02026/10/1729 天前
0.5.22026/10/151 个月前
0.5.12026/10/151 个月前
0.5.02026/10/131 个月前
0.4.22026/10/041 个月前

关于 @genrojs/builders 的常见问题

@genrojs/builders 是什么?

语法驱动的构建者:从JSON语法中打出源树,用于任何方言,并有可插接的渲染器.

如何安装 @genrojs/builders?

在项目目录运行 npm install @genrojs/builders,或使用 pnpm add / yarn add / bun add。

@genrojs/builders 支持 TypeScript 吗?

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

@genrojs/builders 支持 ESM 还是 CommonJS?

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

@genrojs/builders 需要什么版本的 Node.js?

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

@genrojs/builders 可以商用吗?

@genrojs/builders 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@genrojs/builders 的下载量有多少?

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

@genrojs/builders 还在维护吗?

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