为什么 HTML 不是合法的 JSX
JSX 形似 HTML,但会被编译成 JavaScript,因此存在若干差异:与 JavaScript 保留字冲突的属性需要改名,最典型的是 class 改为 className、for 改为 htmlFor;多词属性改为小驼峰,而 data- 和 aria- 属性保留连字符;内联 style 必须是对象而非字符串;img、br 等空元素必须显式自闭合;注释要写成 JavaScript 表达式;字面花括号需要转义;多个并列根节点需要 Fragment 包裹。本工具用自带解析器实现全部规则,结果是确定的,而不是依赖浏览器 DOM 的自动修复。
如何转换标记
- 1粘贴 HTML 片段:模板片段、邮件版式,或从设计交付物中复制的标记。
- 2查看转换后的 JSX,结果会随输入实时更新。
- 3开启“包装为组件”,即可得到完整的导出函数组件,而不只是裸片段。
- 4为组件命名;不可用的名称会回退为合法标识符,而不是输出无法运行的 JavaScript。
- 5把结果复制到项目中,并把内联事件处理字符串替换为真正的函数。
常见场景
迁移静态模板
把现有 HTML 页面或局部模板迁入 React 代码库,无需逐个手工修改属性。
使用文档中的片段
组件库和 CSS 框架给出的示例通常是纯 HTML,粘贴进组件前先转换一次。
迁移邮件或落地页
转换大量使用表格和内联样式的标记,这类内容手工翻译最为繁琐。
快速定位构建报错
当粘贴的代码编译失败时,用本工具查看究竟是哪些属性或自闭合规则不符合要求。
常见问题
为什么 data- 和 aria- 属性保持原样?
React 会把它们原样传给 DOM,因此保留连字符。只有 React 定义了对应小驼峰属性的那些属性才会改名,所以 data-test-id 不变,而 tabindex 会变成 tabIndex。
内联事件处理器会怎样处理?
onclick 这类属性会改名为 onClick,但取值仍是字符串。这是有意为之:字符串在 React 中不是合法的处理器,保留原值可以让剩余工作一目了然,而不是凭空造出一个未必匹配你代码的函数。
为什么我的标记被 <> 和 </> 包住了?
JSX 表达式必须只有一个根节点。当输入包含多个顶层元素时,转换器会加上 Fragment 以保证可编译。如果你只需要一个根节点,请单独转换该元素。
它能处理格式不规范的 HTML 吗?
它会像浏览器一样忽略多余的闭合标签,但对未闭合的标签和注释会明确报错而不是猜测。它没有实现完整的 HTML5 树构建算法,因此刻意损坏的标记可能需要先行清理。