跳转到内容

从 v0.x 版本迁移到 v1 版本

是的,v1 版本已经发布了! 我们用了两年的努力达到了这个里程碑。

常问问题

哇—— API 看起来完全不一样! 这是否意味着1.0完全不同,而我得重新学习基础知识,而迁移是几乎不可能的?

我很高兴你问了! 答案是不。我们的核心概念并没有改变。 您会注意到 API 提供了更多的灵活性,但这有一定的成本——一些更低级别的组件提取了较低的复杂性。

到底是什么带来了如此巨大的改变呢?

Material-UI 这个项目是从4年前开始的。 在此期间,整个个生态系统发展了很多,我们也学到了很多东西。 @nathanmarks 启动了一项雄心勃勃的任务,将 Material-UI 重新启动,并利用我们学到的知识,来解决一些长期存在的问题。 譬如这些主要的变化:

我应该从哪里开始迁移?

  1. 首先,和 v0.x 版本一起,安装 v1.x 版本的 Material-UI。

    用 yarn:

  yarn add material-ui
  yarn add @material-ui/core

Or with npm:

npm install material-ui
npm install @material-ui/core

then

import FlatButton from 'material-ui/FlatButton'; // v0.x
import Button from '@material-ui/core/Button'; // v1.x
  1. 在你的项目上运行 迁移助手 3。 MuiThemeProvider 对于 v1.x. 版本是可选项,但是如果您有一个自定义的主题,你可以随意同时使用 v0.x 和 v1.x 版本的组件,像这样:

    import React from 'react';
    import { MuiThemeProvider, createMuiTheme } from '@material-ui/core/styles'; // v1.x
    import { MuiThemeProvider as V0MuiThemeProvider} from 'material-ui';
    import getMuiTheme from 'material-ui/styles/getMuiTheme';
    
    const theme = createMuiTheme({
     /* theme for v1.x */
    });
    const themeV0 = getMuiTheme({
     /* theme for v0.x */
    });
    
    function App() {
     return (
       <MuiThemeProvider theme={theme}>
         <V0MuiThemeProvider muiTheme={themeV0}>
           {/*Components*/}
         </V0MuiThemeProvider>
       </MuiThemeProvider>
     );
    }
    
    export default App;
  2. 之后,您可以自由地一次迁移一个组件实例。

组件

自动完成

Material-UI 并没有提供一个高级的 API 来解决这个问题。 我们鼓励您去探索 React 社区提供的解决方案

未来,我们打算提供一个简单的组件来解决这个用例:#9997

Svg 图标

请在你的项目上运行 迁移助手

这会应用出如下的变更:

-import AddIcon from 'material-ui/svg-icons/Add';
+import AddIcon from '@material-ui/icons/Add';

<AddIcon />

Flat Button(扁平按钮)

-import FlatButton from 'material-ui/FlatButton';
+import Button from '@material-ui/core/Button';

-<FlatButton />
+<Button />

Raised Button(凸起的按钮)

凸起按钮的升级的路径:

-import RaisedButton from 'material-ui/RaisedButton';
+import Button from '@material-ui/core/Button';

-<RaisedButton />
+<Button variant="contained" />

Subheader(副标题)

-import Subheader from 'material-ui/Subheader';
+import ListSubheader from '@material-ui/core/ListSubheader';

-<Subheader>Sub Heading</Subheader>
+<ListSubheader>Sub Heading</ListSubheader>

Toggle(切换)

-import Toggle from 'material-ui/Toggle';
+import Switch from '@material-ui/core/Switch';

-<Toggle

-  toggled={this.state.checkedA}
-  onToggle={this.handleToggle}
-/>
+<Switch
+  checked={this.state.checkedA}
+  onChange={this.handleSwitch}
+/>

Menu Item(菜单项)

-import MenuItem from 'material-ui/MenuItem';
+import MenuItem from '@material-ui/core/MenuItem';

-<MenuItem primaryText="Profile" />
+<MenuItem>Profile</MenuItem>

Font Icon(字体图标)

-import FontIcon from 'material-ui/FontIcon';
+import Icon from '@material-ui/core/Icon';

-<FontIcon>home</FontIcon>
+<Icon>home</Icon>

Circular Progress(环状进度条)

-import CircularProgress from 'material-ui/CircularProgress';
+import CircularProgress from '@material-ui/core/CircularProgress';

-<CircularProgress mode="indeterminate" />
+<CircularProgress variant="indeterminate" />

Drop Down Menu(下拉式菜单)

-import DropDownMenu from 'material-ui/DropDownMenu';
+import Select from '@material-ui/core/Select';

-<DropDownMenu></DropDownMenu>
+<Select value={this.state.value}></Select>

未完待续...

您是否已成功迁移您的应用,并助社区一臂之力? 要完成本迁移指南 #7195,还存在一个未决问题。 我们欢迎任何 pull request。