Griffel 的 Babel 预设
用于构建时间转换的 Babel 预设 @griffel/react。 。 。 .
[叹息] 我们不建议直接使用这个预设,它打算被其他工具使用,比如: 网络包装加载器。 。 。 .
安装
yarn add --dev @griffel/babel-preset
# or
npm install --save-dev @griffel/babel-preset
使用量
.babelrc
{
"presets": ["@griffel"]
}
从自定义包导入 Griffel
import { makeStyles } from 'custom-package';
// 👇 custom import names are also supported
import { createStyles } from 'custom-package';
默认情况下,预设处理从 @griffel/react 打开 @fluentui/react-components,用于处理自定义包设置的导入,应当被调整:
{
"presets": [
[
"@griffel",
{
"modules": [{ "moduleSource": "custom-package", "importName": "makeStyles" }]
}
]
]
}
说明:"海关包装"应再出口
__styles函数从@griffel/react
配置 Babel 设置
如果您需要指定自定义的 Babel 配置, 您可以将它们传递给 babelOptions。这些选项将被预设在解析和评价模块时使用.
{
"presets": [
[
"@griffel",
{
"babelOptions": {
"plugins": ["@babel/plugin-proposal-class-static-block"],
"presets": ["@babel/preset-typescript"]
}
}
]
]
}
配置模块评价
{
"presets": [
[
"@griffel",
{
"evaluationRules": []
}
]
]
}
一套规则,定义了匹配的文件在评价期间将如何被转换. EvalRule 是一个具有两个字段的天体:
- 测试是正则表达式或函数
(path: string) => boolean - 动作是
Evaluator函数,“ignore”或导出模块的名称Evaluator函数为 默认 导出
若为 test 规则适用于所有文件.
最后匹配的规则用于转换. 如果一个文件的最后一个匹配动作是“ ignoore ” , 该文件将按原样被评估, 因此文件不得包含任何无法在节点环境中执行的 js 代码( 对于任何 lib 中通常都是真实的) node_modules) (中文(简体) ).
如果您需要编辑某些模块 /node_modules/ (可以在单列波项目中出现这种情况),建议在模块基础上逐个模块进行,以进行更快的转换,例如忽略: /node_modules[\/\\](?!some-module|other-module)/。 。 。 .
默认设置为:
module.exports = {
presets: [
[
'@griffel',
{
evaluationRules: [
{
action: require('@griffel/babel-preset').shakerEvaluator,
},
{
test: /[/\\]node_modules[/\\]/,
action: 'ignore',
},
],
},
],
],
};
变换
此预设旨在为 @griffel/react,它同时支持ES模块和CommonJS,因此可以在TypeScript之后的后处理中使用.
此预设所应用的变换允许剥离运行时间部分 makeStyles() 并改进业绩.
示例
变换
import { makeStyles } from '@griffel/react';
const useStyles = makeStyles({
root: { color: 'red' },
});
大约是
import { __styles } from '@griffel/react';
const useStyles = __styles(/* resolved styles */);
从代码访问 CSS 输出
可以配置预设以返回文件的所有评价样式. 这个 元数据外观如下:
const output = {
// makeStyles
cssEntries: {
// by each hook
useStyles1: {
// by each slot
root: [".fxxxxx { color: 'red' }"],
},
useStyles2: {
root: [".fxxxxx { color: 'red' }"],
},
},
// makeResetStyles
cssResetEntries: {
// by each hook
useResetStyles1: [".fxxxxx { color: 'red' }"],
useResetStyles2: [".fxxxxx { color: 'red' }"],
},
};
用于代码中的程序转换,以便其他工具可以重新使用,而无需额外步骤来确定 输出样式
import { griffelPreset, BabelPluginMetadata } from '@griffel/babel-preset';
const babelFileResult = Babel.transformFromAstSync(babelAST, sourceCode, {
babelrc: false,
configFile: false,
presets: [[griffelPreset, { generateMetadata: true }]],
filename: options.filename,
sourceMaps: options.enableSourceMaps,
sourceFileName: options.filename,
inputSourceMap: options.inputSourceMap,
});
// metadata
console.log(babelFileResult.metadata as unknown as BabelPluginMetadata);
解决问题
本节主要介绍如何排除这首预设在 微软/流体 复发. 然而,这些概念并没有与重新布置相结合.
模块评价
预设使用来自 林纳利亚 评价运行时间 makeStyles。 。 。 .
Linaria 调试文档可以帮助这里。 。 。 .
可用以下环境变量激活调试输出 :
$ DEBUG=linaria\* LINARIA_LOG=debug yarn build
在Windows上,需要设置环境变量通过 set 或您可以使用 cross-env,例如:
$ cross-env DEBUG=linaria\* LINARIA_LOG=debug yarn build
调试输出将包括:
- 编译代码
- 评估代码
- 显示代码被震动的 AST
@linaria/shaker