6.5 KiB
| order | title | ||||
|---|---|---|---|---|---|
| 4 |
|
此处着重列出升级中的不兼容变化和推荐改动。所有变动请见 更新日志。
1.x => 2.x
1.0.0 之后将不再单独提供升级指南，请参考对应版本 更新日志 中的 不兼容改动 部分进行升级。
0.12 => 1.x
1.0.0 之后将不再单独提供升级指南，请参考对应版本 更新日志 中的 不兼容改动 部分进行升级。
0.11 => 0.12
使用 Form 提供的校验功能代替 Validation
Validation 已经被废弃，并会在以后的版本完全移除，所以建议尽快使用 Form 自带的校验功能替换 Validation。具体使用方式可以查阅文档和例子（#1 #2 #3）。
Progress format 属性的值改为函数
把使用了 format 属性的代码，如：
<Progress.Circle percent={100} format={<Icon type="check" />} />
改为：
<Progress.Circle percent={100} format={() => <Icon type="check" />} />
Tree
onSelect回调函数，由原来的一个参数，变为两个，第一个为selectedKeys，第二个参数为原来第一个参数里的其余信息。另外selectedKeys里包含了当前选中的节点key，而原来的不包含。onCheck回调函数，由原来的一个参数，变为两个，第一个为checkedKeys，第二个参数为原来第一个参数里的其余信息。另外checkedKeys里包含了当前选中的节点key，而原来的不包含（这样免去业务里自己组装key的工作）。- 异步API中
onDataLoaded重命名为loadData，其他不用改。
0.10 => 0.11
0.11.x 版本有大量更新，其中部分为不兼容更新。以下列表为其中不兼容的更新及对应升级方案。如果您在升级过程中遇到下面没有提到的情况，可以到 Github 上面咨询。
0.11.x文档：http://ant.design0.10.x文档：http://010x.ant.design
默认加载样式
样式现在不再会在 antd 中默认加载，如果升级后没有样式，开发者需要手动自行引入样式。
import 'antd/lib/index.css';
// 或者
import 'antd/style/index.less';
表格远程模式
Table 的 dataSource 远程模式被移除，用户需要自行实现数据获取方式，ajax 获取数据的演示可以参见 演示。
Timepicker、Datepicker 重命名
Timepicker 被重命名为 TimePicker，Datepicker 被重命名为 DatePicker，需要做以下改动：
<Timepicker /> ==> <TimePicker />
<Datepicker /> ==> <DatePicker />
相应的，两个组件的文档地址也改为 /components/date-picker 和 /components/time-picker。
受控的 DatePicker
由于 DatePicker 已改为 受控组件，所以 DatePicker 显示的值必然与其 value 一致。
如果无法理解受控组件，只须在发现在选中日期后 Datepicker 显示的值不变的情况后，把其 value 属性改为 defaultValue 即可。
TimePicker locale 结构改变
属性 locale 结构发生了 变化，需要将原有的属性改为现有的结构。
其他
- Alert 组件默认不展示样式，可以用
showIcon属性添加图标。 - 在
0.10.x中 Datepicker 已废弃的onSelect属性被删除，请使用onChange属性。。 - TimePicker 的
hourOptionsminuteOptionssecondOptions属性已移除，可使用disabledHoursdisabledMinutesdisabledSeconds配和hideDisabled属性来完成原有功能。演示
0.9 => 0.10
0.10.x 版本有大量改动，是一个不完全向下兼容的版本。以下文档尽力列出了 0.9.x 到 0.10.x 的不兼容变动，以帮助开发者升级。
0.10.x文档：http://010x.ant.design0.9.x文档：http://09x.ant.design
升级 React
新版本推荐使用 react@0.14.x 及以上版本，并增加了对低版本 react 的警告。建议进行同步升级，参考官方的升级文档。
组件化改造
此版本对 Button、Iconfont、Layout、Form、Input 模块进行了 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 的
withDotsisIncluded属性修改为dotsincluded。 - iconfont 的基线更新，可能导致原有图标的位置偏移。