@gera2ld/jsx-dom

中文文档
2.2.2发布于 2023/05/13ISCTypeScriptESM + CJS近 30 天下载 52.7万

对 HTML 元素使用 JSX .

中文使用文档
文档目录5 节
  1. 为什么是虚拟DOM?
  2. 使用量
  3. 自动运行时间
  4. 经典运行时间
  5. 声明类型

@ gerald/jsx- dom

NPM License Downloads

对 HTML/SVG 元素使用 JSX .

为什么是虚拟DOM?

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

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

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

使用量

$ yarn add @gera2ld/jsx-dom
# ESLint
$ yarn add eslint-plugin-react -D
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);
// .eslintrc.js
module.exports = {
  plugins: [
    // ...
    'react',
  ],
  rules: {
    // ...
    'react/jsx-uses-react': 'error',
  },
};

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

自动运行时间

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

// .babelrc
{
  // ...
  "plugins": [
    [
      "@babel/plugin-transform-react-jsx",
      { "runtime": "automatic", "importSource": "@gera2ld/jsx-dom" }
    ]
  ],
}
// tsconfig.json
{
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "@gera2ld/jsx-dom",
  }
}

经典运行时间

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

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

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

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

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

声明类型

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 共发布 20 个版本,首次发布于 2018/05/30;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.2.2latest2023/05/133 年前
2.2.12022/07/294 年前
2.2.02022/07/254 年前
2.1.12021/11/274 年前
2.1.02021/11/234 年前
2.0.12021/11/135 年前

其他发布通道:next → 2.0.0-3。

关于 @gera2ld/jsx-dom 的常见问题

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