@ gerald/jsx- dom
对 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`
}
}