@mui/styled-engine
配置您首选的样式库。
emotion是 MUI 组件用于生成 CSS 样式的默认样式库。 所有 MUI 组件都依靠 styled()
API 将 CSS 注入到页面。 此 API 得到多个流行式样式库的支持,这样就可以在 MUI 中切换它们。
如何切换到 styled-components
If you already have styled-components installed, it's possible to use it exclusively. There are currently two packages available to choose from:
@mui/styled-engine
- 一个围绕 emotion 的styled()
API, 包含一些所需的方法, 例如<GlobalStyles />
组件,css
和keyframe
等。 这是默认的。@mui/styled-engine-sc
- 一个类似于上者的styled-components
包装库。
These two packages implement the same interface, which makes it possible to replace one with the other. By default, @mui/material
has @mui/styled-engine
as a dependency, but you can configure your bundler to replace it with @mui/styled-engine-sc
.
yarn
If you are using yarn, you can configure it using a package resolution:
package.json
module.exports = {
//...
resolve: {
alias: {
'@mui/styled-engine': '@mui/styled-engine-sc',
},
},
};
npm
As package resolutions are not available in npm at this moment, you need to update you bundler's config to add this alias. Here is an example of how you can do it, if you use webpack
:
webpack.alias.js
module.exports = {
//...
module.exports = {
//...
+ resolve: {
+ alias: {
+ '@mui/styled-engine': '@mui/styled-engine-sc'
+ },
+ },
};
If you are using TypeScript, you will need to also update the TSConfig.
tsconfig.json
{
"compilerOptions": {
+ "paths": {
+ "@mui/styled-engine": ["./node_modules/@mui/styled-engine-sc"]
+ }
},
}
Next.js
next.config.js
These two packages implement the same interface, which makes it makes possible to replace one with the other. By default, <code>@mui/core</code> has <code>@mui/styled-engine</code> as a dependency, but you can configure your bundler to replace it with <code>@mui/styled-engine-sc</code>. For example, if you are using webpack you can configure this by adding a resolver:
Ready-to-use examples
If you are using create-react-app, there is a ready-to-use template in the example projects. You can use these styled-component
examples as a reference:
This package-swap approach is identical to the replacement of React with Preact. The Preact team has documented a large number of installation configurations. If you are stuck with MUI + styled-components, don't hesitate to check out how they solve the problem, as you can likely transfer the solution.