# @gera2ld/jsx-dom 中文文档

规范地址：https://npmcn.com/package/%40gera2ld/jsx-dom/

版本：2\.2\.2
npm 元数据更新时间：2023-05-13T05:14:57.884Z
中文译文更新时间：2026-11-16T05:07:05.114Z
软件包许可：ISC

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

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

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

- 包体积（解压后）：21.5 kB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2018-05-30T06:45:44.249Z
- 最新版本发布：2023-05-13T05:14:57.760Z
- 近 30 天下载量：526631（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 0 个）

## 中文简介

对 HTML 元素使用 JSX .

## 安装

```sh
npm install @gera2ld/jsx-dom
```

也可以使用：`pnpm add @gera2ld/jsx-dom`、`yarn add @gera2ld/jsx-dom`、`bun add @gera2ld/jsx-dom`

## README

# @ gerald/jsx- dom

[![NPM](https://img.shields.io/npm/v/@gera2ld/jsx-dom.svg)](https://npm.im/@gera2ld/jsx-dom) ![License](https://img.shields.io/npm/l/@gera2ld/jsx-dom.svg) ![Downloads](https://img.shields.io/npm/dt/@gera2ld/jsx-dom.svg)

对 HTML/SVG 元素使用 JSX .

## 为什么是虚拟DOM?

v1.x没有虚拟DOM,因此所有元素立即被挂载,我们很难决定某一元素是否是SVG的一部分.

v2.x引入了虚拟 DOM,这样我们就可以根据每个节点的母体决定命名空间.

不过,如果您不需要 SVG 支持, 并期望像以前一样简单使用, 请将 pragma/ jsx Factory 设置为 `JSX.hm` 改为 `JSX.h`。 。 。 .

## 使用量

```sh
$ yarn add @gera2ld/jsx-dom
# ESLint
$ yarn add eslint-plugin-react -D
```

```js
import { mountDom } from '@gera2ld/jsx-dom';

// Create vdom
const vdom = <div>hello</div>;
// Mount as DOM element
const dom = mountDom(vdom);

// Attach to document
document.body.appendChild(dom);
```

```js
// .eslintrc.js
module.exports = {
  plugins: [
    // ...
    'react',
  ],
  rules: {
    // ...
    'react/jsx-uses-react': 'error',
  },
};
```

您可能还需要 [@babe/ 预设反应](https://babeljs.io/docs/en/babel-preset-react) 或者说 [@babel/ plugin- transform- react-jsx](https://babeljs.io/docs/en/babel-plugin-transform-react-jsx) 以自动运行时间或经典运行时间转换JSX. 以下关于不同运行时间的 Babel 配置, `tsconfig.json`编号 :`jsconfig.json` 还建议提供更好的类型定义.

### 自动运行时间

在与 Babel 使用自动运行时间时,不需要导入任何额外的帮助.

```js
// .babelrc
{
  // ...
  "plugins": [
    [
      "@babel/plugin-transform-react-jsx",
      { "runtime": "automatic", "importSource": "@gera2ld/jsx-dom" }
    ]
  ],
}
```

```js
// tsconfig.json
{
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "@gera2ld/jsx-dom",
  }
}
```

### 经典运行时间

另一种选择是使用经典运行时间. 请注意,你需要 `import JSX from '@gera2ld/jsx-dom'` 无论JSX在哪里使用.

```json
// .babelrc
{
  // ...
  "plugins": [
    [
      "@babel/plugin-transform-react-jsx",
      {
        "runtime": "classic",
        "pragma": "JSX.h",
        "pragmaFrag": "JSX.Fragment"
      }
    ],
  ],
}
```

```js
// tsconfig.json
{
  "compilerOptions": {
    "jsx": "react",
    "jsxFactory": "JSX.h",
    "jsxFragmentFactory": "JSX.Fragment",
  }
}
```

如果您不需要 SVG 支持, 请省略 `mountDom`替换 `JSX.h` 与 `JSX.hm`数字 :

```js
// pragma/jsxFactory set to "JSX.hm"

document.body.append(<div>hello</div>);
```

### 声明类型

```ts
import { VNode, DomNode } from '@gera2ld/jsx-dom';

declare global {
  namespace JSX {
    type Element = VNode; // use `DomNode` instead if you want to omit `mountDom` and set pragma to `JSX.hm`
  }
}
```

## 常见问题

### @gera2ld/jsx-dom 是什么？

对 HTML 元素使用 JSX \.

### 如何安装 @gera2ld/jsx-dom？

在项目目录运行 npm install @gera2ld/jsx-dom，或使用 pnpm add / yarn add / bun add。

### @gera2ld/jsx-dom 支持 TypeScript 吗？

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

### @gera2ld/jsx-dom 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gera2ld/jsx-dom 可以商用吗？

@gera2ld/jsx-dom 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gera2ld/jsx-dom 的下载量有多少？

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

### @gera2ld/jsx-dom 还在维护吗？

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

