@wordpress/babel插件导入jsx杂注

Babel转换插件,用于自动注入导入以用作React JSX转换插件.

JSX公司只是函数调用的语法糖,通常用于反应.创建元素与一起使用时反应因此,它要求此转换引用的函数位于发生JSX的文件的范围内。在典型的React项目中,这意味着必须将React导入JSX所在的任何文件中。

Babel插件导入JSX Pragma通过在JSX存在的地方自动引入必要的导入来自动化此过程,允许您在代码中使用JSX,而无需考虑确保转换的函数在范围内。它尊重现有的导入语句以及范围变量声明。

安装

使用将模块安装到项目中净现值.

npm install@wordpress/babel插件导入jsx杂注

注释:此软件包要求Node.js版本具有长期支持状态(请检查活动LTS或维护LTS版本). 它与旧版本不兼容。

用法

请参阅Babel插件文档如果你还没有使用Babel插件的经验。

包括@wordpress/babel插件导入jsx杂注(和@babel/plugin-transform-react-jsx)作为Babel配置中的插件。如果不同时包含这两个标记,则在遇到JSX标记时会收到错误。

//.babelrc.js文件模块导出={插件:[“@wordpress/babel-plugin-import-jsx-pragma”,“@babel/plugin-transform-react-jsx”,],};

注: @wordpress/babel插件导入jsx杂注包含在中@wordpress/babel预设(WordPress开发的默认预设)从开始4.0.0版。如果您正在使用此预设,则不应在Babel配置中包含此插件。

选项

作为@babel/plugin转换react jsx插件提供了自定义杂注对于转换引用的对象,可以为自定义生成的导入指定等效选项。

例如,如果您使用反应包中,您可能希望使用以下配置:

//.babelrc.js文件模块导出={插件:[[“@wordpress/babel-plugin-import-jsx-pragma”,{scopeVariable:'创建元素',scopeVariableFrag:“片段”,source:'反应',isDefault:false,},],[“@babel/plugin-transform-react-jsx”,{pragma:“createElement”,pragmaFrag:'片段',},],],};

范围变量

类型:字符串

JSX杂注需要在范围内使用的变量的名称。对于React.createElement的默认杂注,React变量必须在范围内。

范围变量片段

类型:字符串

需要在范围内的变量名称<></> 碎片JSX公司。命名<片段/>元素
期望Fragment在作用域中,并且不会添加导入。

来源

类型:字符串

缺少范围变量时要从中导入的模块。

是默认值

类型:布尔值

scopeVariable是否是源模块的默认导入。请注意,这没有影响
范围变量片段.

参与此包

这是古腾堡项目的一部分。该项目被组织为单回购项目。它由多个独立的软件包组成,每个包都有特定的用途。此monorepo中的包发布到净现值并由使用WordPress(文字出版社)以及其他软件项目。

要了解更多关于对这个包或古腾堡整体贡献的信息,请阅读该项目的主要内容贡献者指南.