跳转到内容

关于 lab

此依赖包包含了一些还在开发中的组件,它们还不能移到 core(核心)库中。

核心库(core)和实验室(lab)的主要区别在于对组件进行版本管理的方式。 拥有独立的实验室版本,我们就可以在必要的时候发布一些会影响原本代码的改动,并且核心库遵循 slower-moving 政策

程序员在使用和测试组件后向项目报漏洞,维护者就知道更多关于组件的缺点:如缺少功能,访问问题、漏洞,API 设计等等。 一个组建被使用的时间越久,发现一个新的问题,以及因此需要引入重大更改的可能性就越小。

对于那些准备放到核心库里的组件,需要考虑以下几点:

  • 它需要被使用过。 The Material-UI team uses Google Analytics in the documentation (among other metrics) to evaluate the usage of each component. A lab component with low usage either means that it isn't fully working yet, or that there is low demand for it.
  • 它的代码质量要和核心组件保持一致。 It doesn't have to be perfect to be part of the core, but the component should be reliable enough that developers can depend on it.
    • 每个组件需要类型定义。 就目前来说,一个实验室组件不需要定义类型,但是当搬到核心代码之后就需要定义好类型了。
    • 需要较高的测试覆盖率。 有一些实验室组件目前不带有一些综合的测试。
  • 该组件是否可以作为杠杆来激励用户升级到最新的主要版本? 一个社区的分裂程度越低越好。
  • 它需要尽量避免在中短期内发生破坏性更改。 例如,如果它需要一个新的功能并因此将有可能引入重大更改,那么最好推迟将其纳入核心库的进程。

安装

请在您的项目目录中用以下方式安装依赖包:

// 用 npm 安装
npm install @material-ui/lab@next

// 用 yarn 安装
yarn add @material-ui/lab@next

该 lab 和那些核心组件是对等依赖的。 若您还未在项目中使用 Material-UI,那可以按如下方式安装:

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

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

TypeScript

为了从 theme 中的 CSS重载默认的属性自定义 中获益,使用 TypeScript 的用户需要引入如下类型的 types。 TypeScript 在内部将实验室里可用的扩展组件和 模块扩展(module augmentation) 一起使用,这样可以拓展默认的主题(theme)结构。

import '@material-ui/lab/themeAugmentation';

const theme = createTheme({
  components: {
    MuiTimeline: {
      styleOverrides: {
        root: {
          backgroundColor: 'red',
        },
      },
    },
  },
});