安装
安装 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 的 16.8.0 及以上版本,和 react-dom >= 16.8.0 及以上版本。
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 字体图标
若您想使用 Icon
组件,前提条件是安装了 Material icons 的字体。 我们提供了安装字体的一些说明。 例如,通过 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 会指向我们最新版本的库。 这个指向是不稳定的,它会随着我们发布的新版本而改变。 您应该考虑使用一个具体的版本,如 v4.4.0。
设计资源
一套可重复使用的设计工具组件已经面世,这些工具是为了配合 React 组件而设计的,它们可以帮助你制作优秀的产品。