# @genrojs/builders 中文文档

规范地址：https://npmcn.com/package/%40genrojs/builders/

版本：0\.7\.0
npm 元数据更新时间：2026-10-20T13:04:58.141Z
中文译文更新时间：2026-11-16T03:54:47.250Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40genrojs/builders
原文对照：https://npmcn.com/package/%40genrojs/builders/?lang=original
项目主页：https://github.com/genro-org/genro-builders-js#readme
源码仓库：https://github.com/genro-org/genro-builders-js

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：344 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-10-01T14:34:29.671Z
- 最新版本发布：2026-10-20T13:04:57.694Z
- 近 30 天下载量：4246（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

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

## 安装

```sh
npm install @genrojs/builders
```

也可以使用：`pnpm add @genrojs/builders`、`yarn add @genrojs/builders`、`bun add @genrojs/builders`

## README

# 天才建筑师

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

版本 **0.7.0 (简体中文)** 目标npm和JSR与包0.11合同。 Python 等值以 [记录差异](https://npmcn.com/package/%40genrojs/builders/docs/020-python-differences.md)食谱没有执行. 构建者宣布其源代码的 sourceBag 类 `static _sourceClass` (单位:千美元)[源类别](https://npmcn.com/package/%40genrojs/builders/docs/005-authoring.md#gbj-005-025)) (中文(简体) ).

```js
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/*` 允许经核实的连续释放.

## 文档

-   [部分收集组成](https://npmcn.com/package/%40genrojs/builders/docs/030-collections.md)
-   [作者、语法和API](https://npmcn.com/package/%40genrojs/builders/docs/005-authoring.md)
-   [制作和展示](https://npmcn.com/package/%40genrojs/builders/docs/010-rendering.md)
-   [仓库地图与发展](https://npmcn.com/package/%40genrojs/builders/docs/015-development.md)
-   [Python 差异和开点](https://npmcn.com/package/%40genrojs/builders/docs/020-python-differences.md)
-   [1.1.2 审查记录](https://npmcn.com/package/%40genrojs/builders/docs/025-review.md)

本地构建 Sphinx 手册 :

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

手册使用经典读取多克主题. 没有配置主机或 隐含。 见 [变化](https://npmcn.com/package/%40genrojs/builders/CHANGELOG.md) 用于修改本地版本.

版权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 迁移指南](https://npmcn.com/package/%40genrojs/builders/docs/035-pointer-suffixes.md)。 。 。 .

## 常见问题

### @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 和提交记录判断。

