添加 Sass 样式表
注意:
react-scripts@2.0.0及更高版本提供此功能。¥Note: this feature is available with
react-scripts@2.0.0and higher.
通常,我们建议你不要在不同的组件中重复使用相同的 CSS 类。例如,与其在 <AcceptButton> 和 <RejectButton> 组件中使用 .Button CSS 类,我们建议创建一个具有自己的 .Button 样式的 <Button> 组件,<AcceptButton> 和 <RejectButton> 都可以渲染(但 不继承)。
¥Generally, we recommend that you don’t reuse the same CSS classes across different components. For example, instead of using a .Button CSS class in <AcceptButton> and <RejectButton> components, we recommend creating a <Button> component with its own .Button styles, that both <AcceptButton> and <RejectButton> can render (but not inherit).
遵循这条规则通常会使 CSS 预处理器变得不那么有用,因为混合和嵌套等功能被组件组合所取代。但是,如果你觉得它有价值,你可以集成一个 CSS 预处理器。
¥Following this rule often makes CSS preprocessors less useful, as features like mixins and nesting are replaced by component composition. You can, however, integrate a CSS preprocessor if you find it valuable.
要使用 Sass,首先安装 sass:
¥To use Sass, first install sass:
$ npm install sass
# or
$ yarn add sass
现在你可以将 src/App.css 重命名为 src/App.scss,并将 src/App.js 更新为导入 src/App.scss。如果以扩展名 .scss 或 .sass 导入,此文件和任何其他文件将自动编译。
¥Now you can rename src/App.css to src/App.scss and update src/App.js to import src/App.scss.
This file and any other file will be automatically compiled if imported with the extension .scss or .sass.
要在 Sass 文件之间共享变量,可以使用 Sass 的 @use 规则。例如,src/App.scss 和其他组件样式文件可以包括带有变量定义的 @use "./shared.scss";。
¥To share variables between Sass files, you can use Sass's @use rule. For example, src/App.scss and other component style files could include @use "./shared.scss"; with variable definitions.
这将允许你进行导入,例如
¥This will allow you to do imports like
@use 'styles/_colors.scss'; // assuming a styles directory under src/
@use '~nprogress/nprogress'; // loading a css file from the nprogress node module
注意:你可以使用
~作为路径前缀,如上所示,以解析node_modules中的模块。¥Note: You can prefix paths with
~, as displayed above, to resolve modules fromnode_modules.
sass 还支持 SASS_PATH 变量。
¥sass also supports the SASS_PATH variable.
要使用相对于你指定的路径的导入,你可以使用 SASS_PATH 环境变量中指定的路径在项目根目录添加 .env 文件。要指定更多目录,你可以将它们添加到 SASS_PATH,用 : 分隔,例如 path1:path2:path3。
¥To use imports relative to a path you specify, you can add a .env file at the project root with the path specified in the SASS_PATH environment variable. To specify more directories you can add them to SASS_PATH separated by a : like path1:path2:path3.
注意:对于 Windows 操作系统,请用分号分隔路径。
¥Note: For the Windows operating system, separate your paths by semicolons.
SASS_PATH=path1;path2;path3
提示:你也可以选择在 CSS 模块 上使用此功能!
¥Tip: You can opt into using this feature with CSS modules too!
注意:如果你使用 Flow,请覆盖
.flowconfig中的 module.file_ext 设置,以便它识别.sass或.scss文件。你还需要包括.js、.jsx、.mjs和.json文件的module.file_ext默认设置。¥Note: If you're using Flow, override the module.file_ext setting in your
.flowconfigso it'll recognize.sassor.scssfiles. You will also need to include themodule.file_extdefault settings for.js,.jsx,.mjsand.jsonfiles.[options]
module.file_ext=.js
module.file_ext=.jsx
module.file_ext=.mjs
module.file_ext=.json
module.file_ext=.sass
module.file_ext=.scss
注意:LibSass 以及构建在其之上的软件包(包括 Node Sass)是 已弃用。如果你是 Node Sass 的用户,则可以通过将
package.json文件中的node-sass替换为sass或运行以下命令来迁移到 Dart Sass:¥Note: LibSass and the packages built on top of it, including Node Sass, are deprecated. If you're a user of Node Sass, you can migrate to Dart Sass by replacing
node-sassin yourpackage.jsonfile withsassor by running the following commands:$ npm uninstall node-sass
$ npm install sass
# or
$ yarn remove node-sass
$ yarn add sass