ant-design/CHANGELOG.zh-CN.md

order	title	toc	timeline
5	更新日志	false	true

如果需要查看 2.0.0 之前的更新日志，请移步 GitHub。

---

2.5.0

2016-11-25

• 默认主题风格修改为支付宝钱包风格，及大量样式优化。
• 支持服务端渲染。（Mention 会因为 draft-js 的问题有 warning）
• 引入 Jest Snapshot 测试组件结构及服务端渲染问题。
• 官网及文档优化。
• 新增自定义主题的 文档。
• 新增 Sketch 资源文件。
• LocaleProvider 新增巴西语支持。#4004 @nathantn
• DatePicker
  • DatePicker 现在可以决定是否展示 “今天” 按钮。commit
  • RangePicker 现在可以自定义快捷选择。demo
  • 修复 DatePicker 设置 showTime 后 “此刻” 按钮失效的问题。#3748
  • 修复 RangePicker[format] 失效的问题。#3808
• 新增并优化部分 Icon。#3977
• 新增 Input.Search 控件。demo
• Mention onSelect 事件现在可以获取完整的数据。#3867
• Pagination 现在支持展示当前页的索引范围。demo
• Table
  • 自定义筛选的显示隐藏现在可以通过代码控制。demo
  • 支持 JSX 风格的方式设置 columns。demo
  • 现在可以监听单元格的点击事件。#3774
  • 修复无边框 Table 头部的圆角样式问题。
  • 修复 title 和 footer 高度不随 Table[size] 变化的问题。commit
  • 修复选中状态出错的问题。#3900
• Upload
  • 修复 children 不能为 null 的问题。
  • 修复预览逻辑的问题。commit
• 修复 Badge 会覆盖其他组件的问题。#3898
• 修复多行 Checkbox 样式不对齐的问题。#3971 @flashback313
• 修复 InputNumber 与其它表单控件不对齐的问题。#3866(comment)
• 修复 Menu.Divider 样式问题。#3813
• 修复 Popover 直接内嵌 Checkbox 和 Radio 无效的问题。#3455
• 修复 Select combobox 高度异常问题。#3855
• 修复 Switch actived 后的样式问题。#3838
• 修复 Transfer 搜索无结果时不展示 “Not Found” 提示的问题。#3996
• 修复 TreeSelect 占位符的样式问题。#3841
• 修复 TypeScript 编译报错的问题。#3969 @AlbertZheng
• 修复表单反馈图标影响用户操作的问题。#3891

2.4.3

2016-11-17

• 修复 Anchor 内部 querySelector 报错，并做了一些体验优化 。#3832 #3844

2.4.2

2016-11-13

• 修复 Dropdown.Button 不弹出的问题。#3815

2.4.1

2016-11-11

• 修复 2.4.0 组件 index 文件丢失的问题。

2.4.0

2016-11-11

• 调整了组件的导航结构。
• 新增 Anchor 锚点组件。
• 整理了样式变量，修复 @font-size-base 和 @text-color 在部分组件无效的问题，新增 @font-size-lg @text-color-secondary，并移除了部分无用的变量。
• Transfer 组件新增了受控属性 selectedKeys。#3729
• Tag 新增选中状态。
• 修复 Dropdown.Button 不支持 visible 和 onVisibleChange 的问题。#3779
• 修复 DatePicker[showTime]`` 的 此刻` 按钮。#3748
• 修复 Steps 竖直方向的样式。#3760
• 修复 Spin 组件在 IE10+ 的样式问题。#3755
• 修复 Mention 组件的 focus 逻辑. #3801
• 修复 Progress 组件的动画问题。#3784
• 修复 Select 搜索时的丢失焦点问题。#3778
• 修复 TimePicker 不支持 format="HH" 等格式的问题。#3793
• 修复 Input 的 suffix 部分区域中鼠标事件无法响应的问题。#3714
• 优化了 Table 选择的性能。#3757
• 优化 Carousel 的默认样式。
• 优化 Checkbox 和 Radio 的样式。#3590
• 修复 DatePicker、Form、Table 等组件的样式细节。

2.3.2

2016-11-09

• 修复使用 getFieldProps 会导致死循环的问题。

2.3.1

2016-11-07

• 修正上个版本缺少 dist/antd.css 的问题。

2.3.0

2016-11-04

• 升级 normalize.css 到 5.0。
• package.json 的 main 换成了 lib/index.js。#3397
• 全新的 Spin 设计。
• TimePicker 新增了 addon 以支持自定义的附加内容。
• Tree 新增了 onDragEnd。
• Collapse 新增了 bordered。
• 优化 Tabs 切换时的动画效果。
• 优化 Radio 和 Checkbox 在禁用和鼠标停留时的样式。#3590
• 优化 Transfer 的性能。#2860
• 修复 Popover 嵌套时的样式问题。#3448
• 修复 Transfer 服务端渲染报错的问题。#3686
• 修复 Upload picture-card 模式下新上传的图片不显示预览的问题。#3706 @denzw
• DatePicker
  • 在 showTime 模式下现在失去焦点也会触发 onChange。
  • MonthPicker 增加了 monthCellContentRender 和 cellContentRender。
  • RangePicker 现在可以手动输入时间了。#3718
  • 新增了捷克语的翻译。
• Badge
  • 优化鼠标停留时超过 99 的数字显示。#3645
  • 修复单独使用时会有移动动画的问题。#3709
• Mention
  • 修复会被 Table 遮住的问题。#3588
  • 新增 getSuggestionContainer 来指定容器。#3658
• Tag
  • 废弃 color 属性。#3560
  • 新增 type。#3560
  • 新增 checkable。#3560
• Radio.Group
  • 新增 className。
  • children 为 null 或 undefined 时现在会被忽略。
• Select
  • 新增 tokenSeparators 支持粘贴时自动分词。#2071
  • 新增 onFocus 回调。#3587
  • 修复 combobox 模式下选中项不能正确显示的问题。#3401

2.2.1

2016-11-02

• 修复 Form 中 DatePicker[showTime]（受控）无法使用的问题。#3665

2.2.0

2016-10-28

• 支持 TypeScript@2.0。@AlbertZheng #3358
• 不再强依赖于 React 特定版本。#3627
• Alert 支持 className style 属性。
• DatePicker MonthPicker RangePicker 现在允许设置是否显示清除按钮。#3618
• Form.Item 现在可以感知深层嵌套的表单域，以自动为其生成错误信息和状态。#3212
• RangePicker 现在可以设置不可选的时间。#
• Switch
  • 宽度现在会随着 checkedChildren/unCheckedChildren 自动调整。#3380
  • 优化切换动画。
• Upload 现在可以 自定义上传方式。@edgji
• Icon
  • 新增 bulb select like-o dislike-o。
  • 调整 loading like dislike。
• 优化 Card DatePicker Icon Table 的 TypeScript 定义。@infeng 3468 #3603 #3531
• 修复 Cascader defaultValue 失效的问题。#3470
• 修复在一行内同时使用 Button Input DatePicker Select 时对齐的问题。#3481
• DatePicker
  • 修复设置 DatePicker[showTime] 后 onChange 事件触发时机问题。#3523
• 修复 Dropdown.Button disabled 后仍然响应操作的问题。#3535
• Menu
  • 修复服务端渲染问题，感谢 @xpcode 定位问题。#2061 #2406 #3293
  • 修复 children 不能为 null 的问题。#3599
• 修复 message 加载状态无动画的问题。#3536
• Form
  • 修复 Form[inline] 与 Input[addonBefore|addonAfter] 一起使用时的样式问题。#3524
  • 修复 Form.Item 内 Radio.Button 样式问题。
  • 修复 Form.Item 内搜索按钮的样式问题。#3630
  • 修复用户无输入时 Form.Item 识别为校验成功的问题。#3613
• 当 Popover[title] 没有设置时，不再限制 Popover 的最小宽度。
• Table
  • 修复固定表头在没有数据情况下的样式问题。#3567
  • 修复无数据时会覆盖 SubMenu 的问题。#3521
• Tabs
  • 修复卡片叶签头部高度与设计稿不一致的问题。
  • 修复 TabPane 的高度会被同级 TabPane 撑高的问题。#3304
• 修复 TreeSelect[showSearch] 样式问题。#3520

2.1.0

2016-10-16

• Icon 现在支持旋转动画。
• Tabs 现在可以禁用切换动画。#3324
• 新增西班牙语的 localization 支持。@Danjavia
• 更新俄语的 localization 文案。@plandem
• 新增 AutoComplete[onSelect] 回调。
• 优化 Modal 样式细节。
• 优化 Tooltip 动画。
• 优化 Transfer 按钮的样式。
• 优化 Tree 的样式细节。
• 整理和修复了部分 less 变量。
• 修复服务端渲染时全量引入 antd 报错的问题。
• 修复 Affix 与 BackTop 的服务端渲染问题。#3283 #3343
• 修复 Card[title] 内无法使用 h3 之类的标签的问题。#3388
• 修复 Cascader 搜索模式与浏览器自动完成有冲突的问题。#3350
• DatePicker
  • 修复设置 showTime 后，onChange 重复触发的问题。#3376
  • 修复浮层与 Trigger 日期格式不一致的问题。#3405 #3298
  • 修复与 TimePicker 样式冲突问题。#3312 #3307
• 修复 Form.Item 标签文案过长溢出的问题。
• 修复 Icon 在 Safari 下会出现边框的问题。
• 修复 InputNubmer 键盘事件死循环问题。#3239
• 修复 Popover 箭头样式问题。
• 修复 Popover 和 Popconfirm 的 arrowPointAtCenter 无效的问题。
• Select
  • 修复样式重复引入的问题。#3376
  • 修复 notFoundContent 无法置空的问题。#3345
  • 修复 Table 内使用 Select[showSearch] 后宽度会跳动的问题。#3413
• 修复 Table 边框线与页头页脚冲突的问题。#3301
• 修复 TabPane 高度不随内容变化的问题。#3377
• 修复 Transfer[titles] 不受 LocaleProvider 控制的问题。#3264
• Upload
  • 修复用户自定义 onRemove 事件会覆盖默认行为的问题。#3317
  • 修复图片卡片样式问题。#3316
• 修复项目构建时 moment locales 找不到的问题。#3204 #3411

2.0.1

2016-10-01

• 修复无法调用 react-slick 方法的问题。#3164
• 修复 Steps.Step[icon] 不支持 React.ReactNode 的问题。#3159
• 修复 Affix 不支持服务端渲染的问题。#3216
• 修复 Mention 不支持 onSelect placeholder 的问题。#3236 #3226
• 修复 Transfer 与 getFieldDecorator 一起使用时的报错问题。
• 修复 LocaleProvider 对时间组件无效的问题。
• 修复 Cascader 搜索模式搜索文字显示不了的问题。
• 修复 Spin 动画与文案整体不垂直居中的问题。
• 修复 RangePicker Modal Tag Progress 等组件样式问题。

2.0.0

2016-09-28

很高兴的通知各位，经过四个月时间的紧密开发，antd@2.0.0 终于发布了。这个版本我们重构了底层代码，持续完善现有组件功能和优化细节，并提供了英文版的文档，其中很多都来自社区的贡献，无法一一感谢，欢迎各位持续关注和鞭策。在升级过程中遇到任何问题，请及时 反馈给我们。

2.x 主要变化

• 开发语言改为 TypeScript，提供 官方支持的 .d.ts 文件，感谢 #1846 中所有参与到这次重构的人以及后期 @infeng 对其的完善。
• 新增英文文档， 以后将同时提供中英双语文档，感谢 #1471 里所有参与到翻译和审阅工作中的人。
• 时间类组件 DatePicker、TimePicker、Calendar 等的底层 使用 moment 替换 gregorian-calendar。
• 全新设计的 图标。
• 新增提及组件 Mention。
• 新增自动完成组件 AutoComplete。
• Form 新增 getFieldDecorator 作为 getFieldProps 的替代，对于不正确的使用方式 getFieldDecorator 会给出提示，可以降低踩坑的概率。相关讨论见 #1533。
• Table 支持 表头分组。@yesmeck
• 完全移除 antd@1.x 中已经废弃的 QueueAnim、Validation、Form.ValueMixin、Progress.Line、Progress.Circle、Popover[overlay] 及 Slider[marks] 对数组的支持。

2.x 不兼容改动

此版本有部分不兼容的改动，升级时确保修改相应的使用代码。

• 时间类组件的 value 和 defaultValue 不再支持 String/Date 类型，请使用 moment。

  - <TimePicker defaultValue="12:08:23" />
  + <TimePicker defaultValue={moment('12:08:23', 'HH:mm:ss')} />
  
  - <DatePicker defaultValue="2015/01/01" />
  + <DatePicker defaultValue={moment('2015/01/01', 'YYYY/MM/DD')} />
  
  - <Calendar defaultValue={new Date('2010-10-10')} />
  + <Calendar defaultValue={moment('2010-10-10', 'YYYY-MM-DD')} />
  

• 时间类组件的 onChange 和 onPanelChange 及其他回调函数中为 Date/GregorianCalendar 类型的参数，均修改为 moment 类型，两者 API 有所不同，但功能基本一致，请对照 moment 的 API 文档 和 gregorian-calendar 的文档 进行修改。你也可以参考这个 commit 来进行修改。

  由于 JSON.stringy(date: moment) 返回的值会丢失时区设置，所以要先使用 .format 把日期转成字符串，相关 issue 见 #3082：

  handleSubmit() {
    const values = this.props.form.getFieldsValue();
    values.date = values.date.format('YYYY-MM-DD HH:mm:ss'); // 或其它格式
    const data = JSON.stringify(values);
    // 发送 data 到服务器
  }
  

• 时间类组件与表单校验一起使用时，type: 'date' 改为 type: 'object'。

• 时间类组件的 format 属性也发生了变化，从 gregorian-calendar-format 的格式 变化为与 moment 的格式，例如原来的 yyyy-MM-dd 将变为 YYYY-MM-DD。

• Breadcrumb 移除 linkRender 和 nameRender，请使用 itemRender。

• Menu 移除 onClose onOpen，请使用 onOpenChange。API 差异较大，请先研究 demo。

• Table 移除列分页功能，请使用 固定列。

• Popover 移除 overlay ，请使用 content。

以下变化升级后旧代码仍然能正常运行，但是控制台会出现警告提示，建议按提示进行修改。

• Form 废弃 getFieldProps，请使用 getFieldDecorator：

  -  <Input placeholder="text" {...getFieldProps('userName', { ... })} />
  +  {getFieldDecorator('userName', { ... })(
  +    <Input placeholder="text" />
  +  )}
  

  相关讨论可以看 #1533。

• DatePicker 废弃 toggleOpen，请使用 onOpenChange：

  - handleToggleOpen({ open }) {
  + handleOpenChange(open) {
    ...
  }
  

2.x Bug 修复

• 修复 Dropdown.Button disabled 属性无效的问题。#3070
• 修复 Form.create withRef 选项失效的问题。#2843
• 修复 Menu inline 模式下子菜单展开的问题。#2701
• 修复 Modal.confirm 之类的弹窗在异步调用时按钮仍可点击的问题。#2684
• 修复 DatePicker[showTime] 参数中的 format 失效的问题。#3123
• 修复 Table[dataSource] 中的项的 key 为 0 时识别错误的问题。#3166 @noonnightstorm
• 修复 Tree.Node 无子节点时仍然显示箭头的问题。#2616
• 修复 Tree.Node 箭头隐藏后鼠标 hover 上去光标仍会发生变化的问题。#2748

2.x 其他改进

• Alert 新增 banner 模式。
• BackTop 增加回到顶部的动画效果。
• Badge 新增 状态点模式。
• Cascader 新增 搜索功能。
• Checkbox 新增 indeterminate 状态。
• Form 新增 垂直布局。
• InputNumber 现在支持长按。#
• notification 支持 自定义 icon。
• Spin 现在允许 自定义文案与动画共存。@jerrybendy
• Transfer 现在可以监听用户选择了哪些选项。#
• Transfer 现在可以定义哪些选项是 不可选择的。
• 优化 Alert 和 notification 的样式。
• 优化 Modal.confirm 之类的弹窗的键盘交互。@Dafrok
• 优化 DatePicker 的时间选择 交互。
• 优化 Spin 状态切换 时的效果。
• 更新 font-family。

2.x 相关工具发布

• 新增配套网站 AntD Library，提供遵循 Ant Design 设计规范的组件、模式等的 Axure 资源。

• babel-plugin-antd 更名为 babel-plugin-import，标志着该插件将作为一个通用的按需加载方案存在，而不再是 antd 专有。

  请更新 package.json：

  {
    "devDependencies": {
  -   "babel-plugin-antd": "^0.x.x",
  +   "babel-plugin-import": "^1.0.0",
    }
  }
  

  同时更新 .babelrc 或你在其它地方对其的配置：

  {
  -  "plugins": [["antd", { style: "css" }]]
  +  "plugins": [["import", { libraryName: "antd", style: "css" }]]
  }
  

• dva@1.0.0 也已经发布，并推荐 在实战项目中使用。

• 脚手架工具推荐使用 dva-cli，原来的 antd-init 以后仅会用于学习以及 demo。

1.11.4

去 GitHub 查看 0.x 到 1.x 的 Change Log。