ant-design/docs/upgrade-notes.md
2015-12-10 16:45:20 +08:00

2.4 KiB

升级指南

  • category: 3
  • order: 3

0.10 => 0.11 升级指南

待补充。

0.9 => 0.10 升级指南

0.10.x 版本有大量改动,是一个不完全向下兼容的版本。以下文档尽力列出了 0.9.x0.10.x 的不兼容变动,以帮助开发者升级。

升级 React

新版本推荐使用 react@0.14.x 及以上版本,并增加了对低版本 react 的警告。建议进行同步升级,参考官方的升级文档

组件化改造

此版本对 ButtonIconfontLayoutFormInput 模块进行了 React 组件化的改造,请基于新的使用方式修改,原有的书写方式理论上无影响。

例如:

<button className="ant-btn ant-btn-primary">按 钮</button>
  ==>
<Button type="primary">按钮</Button>
<i className="anticon anticon-appstore"></i>
  ==>
<Icon type="appstore" />

size 属性统一

原有组件的 size 属性统一为大中小:large default small,包括 Button Table Tabs Steps Select Pagination InputNumber Datepicker

例如:

<Tabs size="mini"> ... </Tabs>
  ==>
<Tabs size="small"> ... </Tabs>

详情可参考:https://github.com/ant-design/ant-design/issues/415

其他

  • enter-animation 组件下线, 请使用 queue-anim 来代替。
  • Carousel 升级依赖,参考新的新的 API 和使用方式进行修改。
  • antd.Notification() 修改为小写的 antd.notification()
  • Datepicker 的 onSelect 属性修改为 onChange 属性。
  • Datepicker 的 calendarStyle 属性修改为 popupStyle 属性。
  • Dropdown 的 onSelect 属性应修正为 onClick 属性,因为原有的 onSelect 只在变化时触发。
  • Slider 的 withDots isIncluded 属性修改为 dots included
  • iconfont 的基线更新,可能导致原有图标的位置偏移。

新版本变化较大,以上升级指南可能有遗漏,全部改动可以参考 Changelog。在升级过程中遇到问题,欢迎 报告 给我们。