# @cocreate/render 中文文档

规范地址：https://npmcn.com/package/%40cocreate/render/

版本：2\.0\.2
npm 元数据更新时间：2026-11-07T02:44:25.258Z
中文译文更新时间：2026-11-10T06:57:53.702Z
软件包许可：AGPL-3\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cocreate/render
原文对照：https://npmcn.com/package/%40cocreate/render/?lang=original
项目主页：https://cocreatejs.com/docs/render
源码仓库：https://github.com/CoCreateJS/render

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

- 包体积（解压后）：273 kB，32 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：5 个
- 首次发布：2021-03-26T01:45:41.271Z
- 最新版本发布：2026-11-07T02:44:25.078Z
- 近 30 天下载量：2537（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：282（近 12 个月 15 个）

## 中文简介

香草javascript中的简单渲染成分. 使用 HTML5 属性和/或 JavaScript API 轻松配置.

## 安装

```sh
npm install @cocreate/render
```

也可以使用：`pnpm add @cocreate/render`、`yarn add @cocreate/render`、`bun add @cocreate/render`

## README

# 创造- 投降

香草javascript中的简单渲染成分. 使用 HTML5 属性和/或 JavaScript API 轻松配置. 把它当作我们的旋转 [游乐场!](https://cocreatejs.com/docs/render)

![minified](https://img.badgesize.io/https://cdn.CoCreateJS.com/render/latest/CoCreate-render.min.js?style=flat-square&label=minified&color=orange) ![gzip](https://img.badgesize.io/https://cdn.CoCreateJS.com/render/latest/CoCreate-render.min.js?compression=gzip&style=flat-square&label=gzip&color=yellow) ![brotli](https://img.badgesize.io/https://cdn.CoCreateJS.com/render/latest/CoCreate-render.min.js?compression=brotli&style=flat-square&label=brotli) ![GitHub latest release](https://img.shields.io/github/v/release/CoCreateJS/render?style=flat-square) ![License](https://img.shields.io/github/license/CoCreateJS/render?style=flat-square) ![Hiring](https://img.shields.io/static/v1?style=flat-square&label=&message=Hiring&color=blueviolet)

![CoCreate-render](https://cdn.cocreatejs.com/docs/CoCreate-render.gif)

## [文档和演示](https://cocreatejs.com/docs/render)

完整的指南和工作演示请参见 [贴花](https://cocreatejs.com/docs/render)

## 光盘N

```html
<script src="https://cdn.CoCreateJS.com/render/latest/CoCreate-render.min.js"></script>
```

```html
<script src="https://cdn.CoCreateJS.com/render/latest/CoCreate-render.min.css"></script>
```

## 国家预防机制

```shell
$ npm i @cocreate/render
```

## 线条

```shell
$ yarn install @cocreate/render
```

# 目录

-   [目录](https://npmcn.com/package/%40cocreate/render/#readme-table-of-contents)
-   [通知](https://npmcn.com/package/%40cocreate/render/#readme-announcements)
-   [路线图](https://npmcn.com/package/%40cocreate/render/#readme-roadmap)
-   [如何贡献](https://npmcn.com/package/%40cocreate/render/#readme-how-to-contribute)
-   [关于](https://npmcn.com/package/%40cocreate/render/#readme-about)
-   [许可证](https://npmcn.com/package/%40cocreate/render/#readme-license)

# 通知

图书馆的所有更新都记录在我们 [变化](https://github.com/CoCreateJS/render/blob/master/CHANGELOG.md) 财务报告和审定财务报表 [释放](https://github.com/CoCreateJS/render/releases)。您也可以订阅电子邮件以发布和中断更改.

# 路线图

如果你对这个项目的未来方向有兴趣, 请看看我们的开放 [问题](https://github.com/CoCreateJS/render/issues) 财务报告和审定财务报表 [拖动请求](https://github.com/CoCreateJS/render/pulls)我们想听听你的反馈.

# 关于

CoCreate-reland由CoCreate开发者经验团队指导和支持.

请发电子邮件给开发者体验团队 [这里](mailto:develop@CoCreateJS.com) 如果有任何疑问.

Coreate-reder由CoCreate维护和资助. CoCreate的名称和标志是CoCreate,LLC的商标.

# 如何贡献

我们鼓励为我们的图书馆捐款(你甚至可能得分) [捐款](https://github.com/CoCreateJS/render/blob/master/CONTRIBUTING.md) 详细指南.

我们希望这个图书馆由社区驱动, Coreate 领导。 我们需要你的帮助来实现这一目标。 为了帮助确保我们按正确的顺序建造正确的东西,我们请你们创造 [问题](https://github.com/CoCreateJS/render/issues) 财务报告和审定财务报表 [拖动请求](https://github.com/CoCreateJS/render/pulls) 或只是对现有问题进行投票或发表意见或提出请求.

我们感谢你的继续支持,谢谢!

# 许可证

该软件在GNU Affero通用公共许可证版本3(AGPLv3)和商业许可证下获得双许可证.

-   **开源使用**:用于开源项目和非商业用途,此软件可在AGPLv3下提供. AGPLv3允许您自由使用,修改并分发此软件,前提是所有修改和衍生作品也根据AGPLv3获得许可. 营业执照全文见 [自由文件](https://github.com/CoCreateJS/render/blob/master/LICENSE)。 。 。 .
    
-   **商业用途**: 意图将这一软件用于商业目的的营利性公司和个人必须获得商业许可证。 商业执照,当你签到 API 密钥我们 [网站](https://cocreatejs.com/)。该许可证允许对软件进行专有使用和修改,而不需要AGPLv3的左取要求。 将这一软件融入专有商业产品和应用是理想的.
    

如果您没有购买商业许可证,并打算将这个软件用于商业目的,请到我们的网站上注册API密钥.

## 服务器

Render还提供了一个无国籍的服务器侧HTML渲染器. 从这里导入 `@cocreate/render/server`; 浏览器渲染器仍然可用 `@cocreate/render`。 。 。 .

### 服务器渲染

这个 `HTML` 函数处理 HTML 字符串,解决嵌入式文件和数据库支持的内容,应用状态和元数据,并保护循环引用中的递归性.

```javascript
import { HTML } from '@cocreate/render/server';

const html = await HTML({
  file: {
    src: `<html><body><h1 array="posts" object="post-id" key="title"></h1></body></html>`,
    pathname: "/pages/dashboard.html",
    organization_id: "organization-id"
  },
  organization: { languages: ["en"] },
  urlObject: new URL("https://example.com/pages/dashboard.html"),
  lang: "en",
  theme: "dark",
  crud: crudInstance
});
```

### 服务器 HTML 属性

服务器渲染器评价 `src` 对于嵌入文件碎片, `array` 财务报告和审定财务报表 `object` 解决记录 `key` 以设置一个值。 它还支持 `filter`, (中文(简体) ), `value-type="outerHTML"`, (中文(简体) ), `render-error`, (中文(简体) ), `state-id`,以及 `state-overwrite`插入内容的服务器渲染标记 `rendered="true"` 因此浏览器不会再次取出相同的碎片 .

## 常见问题

### @cocreate/render 是什么？

香草javascript中的简单渲染成分\. 使用 HTML5 属性和/或 JavaScript API 轻松配置\.

### 如何安装 @cocreate/render？

在项目目录运行 npm install @cocreate/render，或使用 pnpm add / yarn add / bun add。

### @cocreate/render 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cocreate\_\_render 是否存在。

### @cocreate/render 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cocreate/render 可以商用吗？

@cocreate/render 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @cocreate/render 的下载量有多少？

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

### @cocreate/render 还在维护吗？

最新版本 2\.0\.2 发布于 2026/11/07（3 天前）；至今共发布 282 个版本，其中过去 12 个月发布了 15 个；首次发布于 2021/03/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。