ant-design/CHANGELOG.zh-CN.md

order	title	toc	timeline
6	更新日志	false	true

antd 严格遵循 Semantic Versioning 2.0.0 语义化版本规范。

发布周期

• 修订版本号：每周末会进行日常 bugfix 更新。（如果有紧急的 bugfix，则任何时候都可发布）
• 次版本号：每月发布一个带有新特性的向下兼容的版本。
• 主版本号：含有破坏性更新和新特性，不在发布周期内。

---

3.2.1

2018-02-11

• 🌟 新增了部分著名产品的图标。c04377e5
• Mention
  • 🌟 现在 multiLines 模式的高度将默认自适应内容。
  • 🐞 修复指定了 placeholder 时无法粘贴内容的问题。#9215
• Table
  • 🐞 修复中号表格的 padding。#9319
  • 🐞 修复小号表格的边框错位问题。#8980
  • 🐞 修复排序图标点击区域溢出表头的问题。#8979
  • 🌟 优化了 column.dataIndex 的 TypeScript 定义。#9298 @clinyong
• Select
  • 🐞 修复使用键盘导航时，滚动条不会自动定位的问题。#9276
  • 🐞 修复在 IE11 下的箭头位置。
• 🐞 修复 Upload beforeUpload 返回 false 时，上传文件仍然显示 uploading 以及文件列表被替换的问题。#8020
• 🐞 修复 vertical 布局的 Form 下反馈图标错位的问题。#9153
• 🐞 修复 Card 没有子节点时 loading 样式不生效的问题。#9258
• 🐞 修复 Avatar 的图片不存在时的背景色。#9278 @andriijas
• 🐞 修复 RangePicker 选择结束时间时报 Cannot read property 'locale' of undefined 的问题。#9267
• 🐞 修复 ButtonGroup 内使用了失效按钮和 Tooltip 时样式错位的问题。#9296 #9296
• 🐞 修复 Dropdown 的子菜单被遮挡的问题。#9218

3.2.0

2018-02-04

• 🌟 Tab 新增 tabBarGutter 属性，用于设置 tabs 之间的间隙。#8644 @lixiaoyang1992
• 🌟 Layout 新增 hasSider 属性，用于避免服务端渲染时显示问题。#8937
• 🌟 Progress 新增 successPercent 属性，用于显示分段进度条。例子
• 🌟 Alert 新增 iconType 属性，用于显示自定义图标。#8811 @minwe
• 🌟 DatePicker 新增 id 属性。#8598 @mgrdevport
• 🌟 Collapse 新增 forceRender 属性，用于渲染隐藏的内容。#9192 #Pyroboomka @paulcmason
• RangePicker
  • 🌟 改进 ranges 属性，使其支持方法。#8281
  • 🐞 修复无法手动输入开始时间的问题。#6999
  • 🐞 修复点击预设范围关闭日期面板的时候没有动画的问题。#6364
  • 🐞 修复点击预设范围时不触发 onOk 的问题。#7747
• Select
  • 🌟 改进了 onChange、onDeselect 方法，现在他们会接受选中的 Option 作为第二个参数。
  • 🐞 修复自动分词不触发 onSelect 的问题。#9094
  • 🐞 修复 Chrome 上下拉框没有滚动条的问题。
• 🌟 改进 Table 的 rowSelection[getCheckboxProps] 属性，现在可以传任意属性给 chekbox 了。#9054 @mgrdevport
• 🐞 修复 Calendar 的 mode 属性不能从外部控制的问题。#9243 @mgrdevport
• 🐞 修复 AutoComplete 在 Form 中显示错误信息时的边框颜色。9f2b490
• 🐞 修复 DatePicker 在受控模式下时间显示不正确的问题。#8885
• 🐞 修复 TextArea 在 Edge 下高度计算错误的问题。#9108 @cuyl
• 🐞 修复 Tabs 在 card 模式且 tabPosition 是 bottom 时的样式问题。#9165 @ryanhoho
• 🌟 新增库尔德语。

3.1.6

2018-01-28

• 🐞 回退了 #9141 的修改，因其导致的 DatePicker 年月无法选择。

3.1.5

2018-01-27

• 🐞 修复了 Select 下拉选择框在 IE11 点击滚动条会无故消失的问题。#7934 @tianlang89757
• 🐞 修复了 Form 中使用 getFieldDecorator 当 id 重复时引用冲突的问题。#9103 #7351
• 🐞 修复了 RangePicker 在语言切换时会显示上一次的语言的问题。#8970
• 🐞 修复了 DatePicker 在受控模式下时间显示不正确的问题。#8885
• 🐞 修复了 Table 在 loading 时显示空提示的问题。#9095 @sallen450
• 🐞 补充 Icon 类型 file-word。#9092 #9061
• 🐞 修复写错的字体名称，造成浏览器无法正确识别的问题。commit/506f97
• 📖 修复了 TypeScript 定义
  • 补充 Notification 缺失的 duration 定义。pull/9120 @duhongjun
  • 补充 Steps 缺失的 style 定义。pull/9126 @wanliyunyan
• 🌟 优化了 Avatar 的默认背景色。commit/275946
• 🌟 新增了 Slider 以及 Menu 的 less 变量，更加方便的修改主题。pull/9065 pull/9115 @mrgeorgegray

3.1.4

2018-01-21

• 🐞 修复 ButtonGroup 错误 z-index 导致的样式问题。#9014
• 🐞 修复 Dropdown.Button 不能被完全禁用的问题。#8991 @sallen450
• 🐞 修复 Layout 错误的响应式相关文档。#8995 @ReedSun
• 🐞 修复 List grid 不支持 xxl 配置的问题。#9019
• 🐞 修复 RangePicker 关闭选择面板之后无法清空已选开始时间的问题。#8839
• 🐞 修复 Tabs 错误外边距导致的样式问题。commit/200d6c
• 🐞 修复 WeekPicker 显示错误周数的问题。#9021
• 🐞 修复 TypeScript 定义
  • 补充 Menu 缺失的 subMenuCloseDelay 和 subMenuOpenDelay。#8976 @Rohanhacker
  • 重构了 DatePicker 相关 type 定义。commit/0bb531
  • 修复了 Input maxLength type 定义。#9046 @Riokai
• 🌟 新增 less 变量
  • Checkbox 和 Radio 相关：#9003 @mrgeorgegray
  • Breadcrumb 相关：#9022 @mrgeorgegray
• 🌟 新增 aliyun 图标。

3.1.3

2018-01-14

• 🐞 修复 locale 为 null 时 LocaleProvider 出错的问题。

3.1.2

2018-01-13

• 🐞 修复 Button 不能正确显示 0 的问题。#8733 @Cuihongsen
• 🐞 修复 Table 和 List 中由于 Spin 导致的滚动条。#8799
• 🐞 修复不能传方法给 Table[emptyText] 的问题。#8871
• 🐞 修复 Dropdown[transitionName] 不生效的问题。
• 🐞 修复 Input 中输入数字时字体会发生变化的问题。 #8636
• 🐞 修复 import 多个 locale 文件后日期文本显示错误的问题。#8785
• 🐞 修复 dist/antd-with-locales.js 中的 locale 会多一个 default 字段的问题。#8881
• 🐞 修复 TypeScript 定义 4cc29bc 693e734 67e956d ecd4177 33119ec 88e0c9b
• 🌟 新增 less 变量 b9b5aba 5931b20 c9d7397
• 🌟 优化中文引号的显示。

3.1.1

2018-01-08

• 📖 发布了全新的官网和设计文档。
• 📖 更新了项目实战文档到 roadhog 2.0。5dcf1c0
• 📖 发布了 Ant Design 3.0 的 sketch 模板包。22dfe88
• 🐞 修复 Dropdown 组件的 TypeScript 类型定义中 trigger 属性缺少 contextMenu 事件的问题。#8646 @cjahv
• 🐞 修复 Button 内使用 HOC 组件时两个中文字符间未添加空格的问题。
• 🐞 修复 List 组件在 IE 11 下的样式兼容问题。#8784
• 🐞 修复 Select 组件 notFoundContent 属性不生效的问题。#8809
• 🐞 修复 BackTop 组件在 React 16 下 target 属性出现警告的问题。#8848
• 🐞 修复当设置 gutter 后 List 组件出现横向滚动条的问题。#8799
• 🐞 修复 Anchor.Link 的 href 属性不支持完整链接的问题。#8808
• 🌟 优化中文引号的字体。c6fcc31

3.1.0

2017-12-29

新年快乐！~ 2018年了，00后都成年了！少年赶紧提个 PR 给我们吧！~

• 🐞 修复组件 Spin 可能出现跳动的问题。#8602 @jhsu
• 🐞 修复 Table 在设置 size=small 的情况下出现多余 padding 的问题。#8724
• 🐞 修复 Checkbox.Group 在 Form 中和 label 的对齐问题。#8739
• 🐞 修复 Affix 组件出现滚动条的问题。#8606
• 🐞 修复组件 List "No Data" 和加载动画重叠的问题. #8647
• 🌟 为 Input 添加 onKeyUp。#8705 @delesseps
• 🌟 折叠面板 Collapse 添加 showArrow 来支持隐藏箭头。#8536 @apieceofbart
• 🌟 评分 Rate 组件添加 allowClear，支持再次点击后重置。#8627
• 🌟 优化 BackTop 组件的响应式效果。#8719 @JetRunner
• 🌟 Modal 组件添加 destroyOnClose 支持关闭时销毁 Modal 里的子元素。#8769 @Rohanhacker
• 🌟 组件 Pagination 添加 hideOnSinglePage 支持当只有一页时隐藏组件。#8615 @camsong
• 🌟 支持 List 组件自定义加载动画。
• 👻 你现在可以通过 CodeSandbox 来打开官方文档中的示例了。

3.0.3

2017-12-22

• 🐞 Form.create 返回值增加 React.SFC 类型的支持。#8672
• 🐞 修复 Form 控件高度和对齐的问题。#8701
• 🐞 修复前后置标签与 Input 高度不一致的问题。#8680
• 🐞 修复 Table 固定列时左右未对齐的问题。#8660

3.0.2

2017-12-17

• 📝 提供了 3.0 迁移工具。e71b68dd
• 📝 重写了 开源贡献指南
• 🌟 优化 notification 在小屏幕下的显示效果。#8631
• 🌟 优化了 Pagination 的样式和并修复了对齐和边距问题。
• 🐞 升级 react-slick 到 0.16.0，修复 peerDependencies 安装警告。#8455
• 🐞 修复固定列头的表格大小设置无效的问题。#8577
• 🐞 修复 DatePicker 等时间组件的 locale 属性失效的问题。#8635
• 🐞 修复 Popover 的箭头偏移和大小无法覆盖的问题。#8548 #8549
• 🐞 修复 AutoComponent 的 notFoundContent 设置无效的问题。#8553
• 🐞 微调 RangePicker 的垂直对齐问题。
• 🐞 Layout.Sider 的响应式断点和栅格系统保持一致。#8620
• 🐞 修复一个 collapsedWidth 为 0 时，收缩后子菜单依然会显示的问题。#8587
• 🐞 修复 Card 的 Meta.title 文本无法自动截断的问题。#8597
• 🐞 修复带边框的 List 下的分页样式边距。#8562
• 🐞 修复一个 Menu 指定了不存在的 defaultOpenKeys 时子菜单无法展开的问题。#8475
• 🐞 修复 Input、AutoComplete、Transfer 的 InputProps 和 SearchProps TypeScript 类型命名冲突。#8478

3.0.1

2017-12-11

• 移除 Card 无用 DOM wrapper，以和 2.x 保持一致。
• 修复 antd/lib/style/v2-compatible-reset.css 缺失问题。28d13e2
• 修复 Affix 比浏览器可见区域还高时被截断的问题。31a0654
• 修复 Collapse 展开动画。edd592c
• 修复 Form 内大尺寸 Input、Button 的对齐问题。#8459
• Menu
  • 修复弹层在 Safari 下消失的问题。#8453
  • 修复展开动画。edd592c
• 修复 Notification 样式编译错误。#8437
• 修复迷你 Pagination 的背景色问题。e13c6d8
• Table
  • 修复在移动端样式错乱的问题。#8465
  • 修复嵌套表格与 size 属性共用时的样式问题。#8525
• TypeScript
  • 修复 AutoComplete 的 TypeScript 定义。#8383 @nidhi-ag
  • 修复 Divider 的 TypeScript 定义。#8504 @cyyyu
  • 修复 Dropdown 的 TypeScript 定义。#8444
  • 修复 List 的 TypeScript 定义。e27061e 1b2a955
  • 修复 Table 的 TypeScript 定义。#8507 #8515 @danedavid

3.0.0

2017-12-04

更多内容见 Ant Design 3.0 发布公告！

主要变化

• 全新的色彩系统，组件主色由 『#108EE9』 改为 『#1890FF』，新主色我们称之为『拂晓蓝』。
• 全新的视觉样式和组件尺寸，更现代更美观。
• 基础字体大小由 12px 增大到 14px。
• 默认语言由中文改为英文。
• 全面支持 React 16。
• 更友好的 TypeScript 支持。
• 新的 List 组件。
• 新的 Divider 组件。
• 新增 30 个图标。

不兼容改动

此版本有部分不兼容的改动，升级时确保修改相应的使用代码。另外由于人肉查找代码中的废弃用法过于低效，所以我们提供了 antd-migration-helper 用于扫描代码中的废弃用法。

• Card 的 noHovering 属性重命名为 hoverable，且默认值改为 true。

• 调整了 Grid 的响应式断点值。详见 #7230

• Form getFieldDecorator 的 exclusive 参数被移除，此类场景应该由 Radio.Group、Checkbox.Group 之类的组件来完成。

• 新增 Form.createFormField 方法，mapPropsToFields 返回的字段都需要由该方法创建。

  import { Form } from 'antd';
  
  Form.create({
    mapPropsToFields() {
      return {
  -     name: { value: 'antd' },
  +     name: Form.createFormField({ value: 'antd' }),
      };
    },
  })
  

• 优化了全局的重置样式，如果升级后你的全局样式有问题，可以引入我们提供的 2.x 兼容样式。

  import 'antd/lib/style/v2-compatible-reset';
  

  或者在 less 里引入

  @import '~antd/lib/style/v2-compatible-reset.less';
  

• 由于默认语言改为英文，如果你需要显示中文，现在需要配置 LocalProvider。

  import { LocaleProvider } from 'antd';
  import zhCN from 'antd/lib/locale-provider/zh_CN';
  
  ReactDOM.render(
    <LocaleProvider locale={zhCN}><YourApp /></LocaleProvider>,
    document.getElementById('root')
  );
  

• Form 下的表单控件不再默认为 size="large"。

• Input.Search 默认的 🔍 图标只作为装饰，不再响应用户交互。需要添加可交互按钮请使用 enterButton。

• UMD 版本的 dist/antd.js 不再包含 moment，使用的时候需要自己引入 moment。

  <html>
    <head>
  +   <script src="https://unpkg.com/moment@2.19.3/moment.js"></script>
      <script src="https://unpkg.com/antd@3.0.0/dist/antd.js"></script>
    </head>
  </html>
  

以下在 2.x 中废弃的特性被移除

• 🗑 移除了 DatePicker.Calendar， 请直接使用 Calendar 组件。
• 🗑 移除了 DatePicker 的 toggleOpen 属性， 请使用 onOpenChange 代替。
• 🗑 移除了 Form 的 inline、horizontal、vertical 属性，请使用 layout 代替。
• 🗑 移除了 Select 的 multiple、tags、combobox 属性，请使用 mode 代替。
• 🗑 移除了 Input 对 type='textarea' 的支持，请直接使用 Input.TextArea 组件。
• 🗑 移除了 Mention 的 toEditorState 方法，请使用 toContentState 代替。

新增功能及改进

• 🌟 Tabs 新增 size="large"。
• 🌟 Row 的 gutter 属性新增响应式断点的支持，可以使用诸如 gutter={{ sm: 16, lg: 32 }} 的设置。
• 🌟 Spin 新增 indicator 属性，用于设置自定义的加载指示符。 #7977 @kossel
• 🌟 Input.Search 新增 enterButton 用于设置自定义的搜索图标。#7596
• 🌟 Mention 新增 placement, 用于设置下拉框的弹出方向。
• 🌟 Carousel 新增 next()、prev()、goTo(slideNumber) 方法，用于控制面板展示。
• 🌟 Button 新增链接支持，当提供 href 时会自动渲染为 <a>。#8343
• 🌟 Steps 进行了重构，首次渲染的时候不会再闪烁。 #6010
• 🌟 Switch 新增 loading 属性，用于表现加载中的状态。
• Menu
  • 🌟 我们使用了 rc-trigger 重构了菜单以支持延迟加载和窗口边缘浮层自适应方向。
  • 🌟 新增 subMenuOpenDelay 和 subMenuCloseDelay，用于设置子菜单打开和关闭的延迟。
  • 🌟 新增 forceSubMenuRender，用于强制渲染子菜单。#5586
• Form
  • 🌟 新增显示验证信息时的动画效果。
  • 🌟 新增按条件渲染表单项的支持。#react-component/117
• Message
  • 🌟 duration 允许可选 #7857 @monkindey
• Badge
  • 🌟 新增 offset 属性，用于设置状态点的位置偏移。
  • 🌟 status 允许与 children 同时使用。#8164
• Card
  • 🌟 新增 inner 类型。例子。
  • 🌟 新增 cover、actions 以及 Meta 子组件。例子。
• DatePicker
  • 🌟 新增 mode 和 onPanelChange，用户控制面板的展示模式。例子。
  • 🌟 新增 WeekPicker 子组件。例子
  • 🌟 新增 dateRender 属性，用于自定义日期单元格的渲染。
• TimePicker
  • 🌟 新增 hourStep、minuteStep、secondStep，用于设置时间步长。例子
  • 🌟 新增 focusOnOpen，用于设置在打开面板的时候是否聚焦输入框。
• Table
  • 🌟 新增 components 属性，用于覆盖表格元素的默认标签。

    // 支持覆盖的元素
    const components = {
      table: MyTable,
      header: {
        wrapper: HeaderWrapper,
        row: HeaderRow,
        cell: HeaderCell,
      },
      body: {
        wrapper: BodyWrapper,
        row: BodyRow,
        cell: BodyCell,
      },
    };
    
    <Table components={components} columns={columns} data={data} />
    

  • 🌟 新增 onRow 属性，用于设置表格列的属性。
  • 🌟 新增 onHeaderRow，用户设置表格头部列的属性。
  • 🌟 新增 column[onCell]，用户设置单元格的属性。
  • 🌟 新增 column[onHeaderCell]，用于设置头部单元格的属性。
  • 🌟 新增 column[align]，用于设置列内文字的对其方向。
  • 🌟 新增 column[defaultSortOrder]，用于设置列的默认排序。#8111 @megawac
  • 🌟 新增 rowSelection[fixed]，用于固定选择列。
  • 🙅 废弃 getBodyWrapper，请使用 components 属性代替。
  • 🙅 废弃以下属性 onRowClick，onRowDoubleClick、onRowContextMenu、onRowMouseEnter、onRowMouseLeave，请使用 onRow 代替。

    <Table onRow={(record) => ({
      onClick: () => {},
      onDoubleClick: () => {},
      onContextMenu: () => {},
      onMouseEnter: () => {},
      onMouseLeave: () => {},
    })} />
    

• Select
  • 🌟 默认和多选模式下 Option 的值允许使用 number。
  • 🌟 新增 maxTagCount 和 maxTagPlaceholder`，用于设置最多可显示的选中项。
  • 🌟 新增 showAction，用于设置出发下拉框打开的事件。
  • 🌟 新增 onMouseEnter 和 onMouseLeave 事件回调。
• LocaleProvider
  • 🇮🇸 新增冰岛语。#7561 @paunovic-stefan
  • 🇪🇬 新增埃及语。#7888 @mohamed-seada-1994
  • 🇺🇦 新增乌克兰语。#8169 @anxolerd

Bug 修复

• Form
  • 🐞 修复输入框的图标会被验证图标覆盖的问题。
  • 🐞 修复使用大尺寸输入框时，验证图标不居中的问题。
• 🐞 修复 Menu 按键时的报错。#8089

其他

• 在 TypeScript 中使用时不再需要设置 allowSyntheticDefaultImports。
• 从 peerDependencies 中移除了 react@0.14 和 react@15，虽然目前 antd 3.0.0 依然可以在旧版本的 React 上使用，但是我们在未来有可能使用 React 16 的新特性，所以强烈建议升级到 React 16，见升级文档。
• 全面支持 ES Module ，antd 及其依赖的底层 react-component 组件全部提供了 ES Module 的构建版本，如果你使用 webpack 3，可以把 babel-plugin-import 的 libraryDirectory 设置为 es，以获得 Tree Shaking 的优化效果。
• 最后，我们会继续维护 2.x 的分支到明年 6 月份。

2.x

去 GitHub 查看 2.x 的 Change Log。

1.11.4

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