安装
安装 Material-UI —— 世界上最受欢迎的 React UI 框架。
Material-UI 可以通过 npm 包 来安装。
npm
若想安装并写入您的 package.json
依赖包,请运行以下命令:
// 使用 npm
npm install @material-ui/core@next @emotion/react @emotion/styled
// 使用 yarn
yarn add @material-ui/core@next @emotion/react @emotion/styled
请注意,安装依赖于 react 的 17.0.0 及以上版本,和 react-dom >= 17.0.0 及以上版本。
Or if you want to use styled-components
as a styling engine:
// with npm
npm install @material-ui/core@next @material-ui/styled-engine-sc@next styled-components
// with yarn
yarn add @material-ui/core@next @material-ui/styled-engine-sc@next styled-components
💡 Take a look at the Styled Engine guide for more information about how to configure
styled-components
as the style engine.
Roboto 字体
在设计 Material-UI 时我们使用了Roboto字体。 因此,我们推荐您遵循此说明来载入字体。 例如,通过 Google Web Fonts 引入:
<link
rel="stylesheet"
href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap"
/>
Font Icons 字体图标
To use the font Icon
component, you must first add the Material icons font. 我们提供了安装字体的一些说明。 例如,通过 Google Web Fonts 引入:
<link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons" />
SVG 图标
在 icons 示例中, 您可以发现一些由我们提供的 SVG Material icons。若您想使用这个图标,您必须安装 @material-ui/icons 这个包:
// 通过 npm
npm install @material-ui/icons
// 通过 yarn
yarn add @material-ui/icons
CDN
如果您已经开始将 Material-UI 融入一些最基本的前端基础架构,您的原型开发就如虎添翼。
我们提供了两个通用模块定义(UMD)的文件:
- 您可以在开发环境调试:https://unpkg.com/@material-ui/core@latest/umd/material-ui.development.js
- 也可放心地在生产环境使用: https://unpkg.com/@material-ui/core@latest/umd/material-ui.production.min.js
通过此 CDN 示例,您可以快速上手。
尽管我们不赞成在生产环境中使用这种方式 —— 无论实际使用哪些组件,客户端必须下载整个库,而这将会影响到整体性能和带宽利用率。
⚠️带有 latest
标签的 UMD 会指向我们最新版本的库。 这个指向是不稳定的,它会随着我们发布的新版本而改变。 您应该考虑使用一个具体的版本,如 v5.0.0。
设计资源
A set of reusable components for design tools is available, designed to match the React components and to help you craft great products: