跳转到内容

🎉 Material UI v5 is out! Head to the migration guide to get started.

安装

安装 Material-UI —— 世界上最受欢迎的 React UI 框架。

Material-UI 可以通过 npm 包 来安装。

npm

若想安装并写入您的 package.json 依赖包,请运行以下命令:

// 用npm安装
npm install @material-ui/core

// 用yarn安装
yarn add @material-ui/core

请注意,安装依赖于 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)的文件:

通过此 CDN 示例,您可以快速上手。

尽管我们不赞成生产环境中使用这种方式 —— 无论实际使用哪些组件,客户端必须下载整个库,而这将会影响到整体性能和带宽利用率。

⚠️带有 latest 标签的 UMD 会指向我们最新版本的库。 这个指向是不稳定的,它会随着我们发布的新版本而改变。 您应该考虑使用一个具体的版本,如 v4.4.0

设计资源

figma sketch adobe-xd

一套可重复使用的设计工具组件已经面世,这些工具是为了配合 React 组件而设计的,它们可以帮助你制作优秀的产品。

  • Figma:大型 UI 套件,包含 600 多个手工制作的 Material-UI 组件。
  • Sketch:大型 UI 套件,包含 600 多个手工制作的 Material-UI 符号。
  • Adobe XD:大型 UI 套件,包含 600 多个手工制作的 Material-UI 符号。
  • Framer:Material-UI 组件的小型 UI 套件