docs: add changelog (#17902)

Release 3.20.6

.github/PULL_REQUEST_TEMPLATE.md

@@ -21,20 +21,18 @@ Please makes sure that these form are filled before submitting your pull request
 - [ ] Branch merge
 - [ ] Other (about what?)
 
-### 👻 What's the background?
+### 🔗 Related issue link
 
 <!--
 1. Describe the source of requirement, like related issue link.
-
-2. Describe the problem and the scenario.
 -->
 
-### 💡 Solution
+### 💡 Background and solution
 
 <!--
-1. How to fix the problem, and list final API implementation and usage sample if that is an new feature.
-
+1. Describe the problem and the scenario.
 2. GIF or snapshot should be provided if includes UI/interactive modification.
+3. How to fix the problem, and list final API implementation and usage sample if that is an new feature.
 -->
 
 ### 📝 Changelog

.github/PULL_REQUEST_TEMPLATE/pr_cn.md

@@ -21,20 +21,18 @@
 - [ ] 分支合并
 - [ ] 其他改动（是关于什么的改动？）
 
-### 👻 需求背景
+### 🔗 相关 Issue
 
 <!--
 1. 描述相关需求的来源，如相关的 issue 讨论链接。
-
-2. 要解决的具体问题。
 -->
 
-### 💡 解决方案和最终实现是？
+### 💡 需求背景和解决方案
 
 <!--
-1. 列出最终的 API 实现和用法。
-
-2. 涉及UI/交互变动需要有截图或 GIF。
+1. 要解决的具体问题。
+2. 列出最终的 API 实现和用法。
+3. 涉及UI/交互变动需要有截图或 GIF。
 -->
 
 ### 📝 更新日志怎么写？

.github/main.workflow

@@ -0,0 +1,14 @@
+workflow "Deploy website" {
+  on = "release"
+  resolves = ["Deploy"]
+}
+
+action "Deploy" {
+  uses = "docker://node:10"
+  runs = [
+    "sh",
+    "-c",
+    "git remote set-url origin https://${DEPLOY_TOKEN}@github.com/ant-design/ant-design.git && npm install && npm run deploy"
+  ],
+  secrets = ["DEPLOY_TOKEN"]
+}

.jest.js

@@ -2,7 +2,7 @@ const libDir = process.env.LIB_DIR;
 
 const transformIgnorePatterns = [
   '/dist/',
-  'node_modules/(?!(_react-dnd|react-dnd|_dnd-core|dnd-core))[^/]+?/(?!(es|node_modules)/)', // Ignore modules without es dir
+  'node_modules/[^/]+?/(?!(es|node_modules)/)', // Ignore modules without es dir
 ];
 
 module.exports = {
@@ -10,6 +10,14 @@ module.exports = {
   setupFiles: ['./tests/setup.js'],
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'md'],
   modulePathIgnorePatterns: ['/_site/'],
+  moduleNameMapper: {
+    '^dnd-core$': 'dnd-core/dist/cjs',
+    '^react-dnd$': 'react-dnd/dist/cjs',
+    '^react-dnd-html5-backend$': 'react-dnd-html5-backend/dist/cjs',
+    '^react-dnd-touch-backend$': 'react-dnd-touch-backend/dist/cjs',
+    '^react-dnd-test-backend$': 'react-dnd-test-backend/dist/cjs',
+    '^react-dnd-test-utils$': 'react-dnd-test-utils/dist/cjs',
+  },
   testPathIgnorePatterns: ['/node_modules/', 'dekko', 'node'],
   transform: {
     '\\.tsx?$': './node_modules/antd-tools/lib/jest/codePreprocessor',

.jest.node.js

@@ -1,9 +1,10 @@
-const { transformIgnorePatterns } = require('./.jest');
+const { moduleNameMapper, transformIgnorePatterns } = require('./.jest');
 
 // jest config for server render environment
 module.exports = {
   setupFiles: ['./tests/setup.js'],
   moduleFileExtensions: ['ts', 'tsx', 'js', 'md'],
+  moduleNameMapper,
   transform: {
     '\\.tsx?$': './node_modules/antd-tools/lib/jest/codePreprocessor',
     '\\.js$': './node_modules/antd-tools/lib/jest/codePreprocessor',

CHANGELOG.en-US.md

@@ -15,6 +15,86 @@ timeline: true
 
 ---
 
+## 3.20.7
+
+- 🐞 Fix Upload can not click in Form.Item. [#17897](https://github.com/ant-design/ant-design/pull/17897)
+
+## 3.20.6
+
+`2019-07-24`
+
+- 🐞 Fix Col miss the place when its height is 0. [#17748](https://github.com/ant-design/ant-design/pull/17748) [@yoyo837](https://github.com/yoyo837)
+- 🐞 Fix Cascader was broken when `options`'s `children` is `null`. [#17756](https://github.com/ant-design/ant-design/pull/17756)
+- 🐞 Fix Checkbox padding where all spans align left. [#17752](https://github.com/ant-design/ant-design/pull/17752) [#17761](https://github.com/ant-design/ant-design/pull/17761) [@inovux](https://github.com/inovux)
+- 🐞 Fix Input line height style bug in IE. [#17759](https://github.com/ant-design/ant-design/pull/17759)
+- 🐞 Fix last item of Rate has additional margin. [#17764](https://github.com/ant-design/ant-design/pull/17764) [@inovux](https://github.com/inovux)
+- 🐞 Fix Radio.Button disabled item border style. [#17775](https://github.com/ant-design/ant-design/pull/17775)
+- 🐞 Fix DatePicker `@input-hover-border-color` variables not working. [#17784](https://github.com/ant-design/ant-design/pull/17784)
+- 🐞 Fix Transfer not re-render list when `dataSource` with `lazy`. [#17783](https://github.com/ant-design/ant-design/pull/17783)
+- 🐞 Fix RangePicker `defaultValue` startTime later than endTime. [#17694](https://github.com/ant-design/ant-design/pull/17694) [@mraiguo](https://github.com/mraiguo)
+- 💄 Tweak long `placeholder` truncate style. [#17797](https://github.com/ant-design/ant-design/pull/17797) [@Kapiroska](https://github.com/Kapiroska)
+- 🐞 Fix Menu circular dependencies. [#17805](https://github.com/ant-design/ant-design/pull/17805) [@phthhieu](https://github.com/phthhieu)
+- 🐞 Fix Alert `message` style. [#17808](https://github.com/ant-design/ant-design/pull/17808) [@mtadams007](https://github.com/mtadams007)
+- 🐞 Fix Result `extra` is not centered. [#17786](https://github.com/ant-design/ant-design/pull/17786) [@nnecec](https://github.com/nnecec)
+- 🐞 Fix Progress with mini `value` not keeps bar radius round. [#17819](https://github.com/ant-design/ant-design/pull/17819)
+- 🐞 Fix Statistic.Countdown `format` not escaping characters in square brackets. [#17841](https://github.com/ant-design/ant-design/pull/17841)
+- 🐞 Fix Table custom `filterDropdown` always triggering `onChange` in some situations. [#17846](https://github.com/ant-design/ant-design/pull/17846)
+- 🐞 Fix TimePicker weird render bug in Safari. [#17857](https://github.com/ant-design/ant-design/pull/17857)
+
+## 3.20.5
+
+`2019-07-19`
+
+- 🐞 Fix `<Button type="danger" ghost />` broken style. [#17743](https://github.com/ant-design/ant-design/pull/17743)
+
+## 3.20.4
+
+`2019-07-19`
+
+- 🐞 Fix multiple level Drawer with falsy `mask`, parent Drawer can not collapse after removing sub component. [#17698](https://github.com/ant-design/ant-design/pull/17698)
+- 🐞 Fix Table border radius missing in Firefox. [#17641](https://github.com/ant-design/ant-design/pull/17641)
+- 🐞 Fix Menu throw warning `Cannot update during an existing state transition`. [#17657](https://github.com/ant-design/ant-design/pull/17657)
+- 🐞 Fix Affix not resize when container size changed. [#17678](https://github.com/ant-design/ant-design/pull/17678)
+- 🐞 Fix Anchor not update bind element when `getContainer` changed. [#17677](https://github.com/ant-design/ant-design/pull/17677)
+- 🐞 Fix window scroll issue when using Modal and Drawer same time. [#17600](https://github.com/ant-design/ant-design/pull/17600)
+- 🌟 Empty `description` supports `false`. [#17659](https://github.com/ant-design/ant-design/pull/17659) [@billfeller](https://github.com/billfeller)
+- 💄 Remove Pagination element underline style to avoid polluted by global style. [#17728](https://github.com/ant-design/ant-design/pull/17728)
+- 💄 Extends Card action click area. [#17705](https://github.com/ant-design/ant-design/pull/17705) [@lhx6538665](https://github.com/lhx6538665)
+- 💄 Tweak less variables and UI to improve style customization. [#17705](https://github.com/ant-design/ant-design/pull/17705)
+
+  - Optimize danger Button UI design.
+
+    <img width="103" class="markdown-inline-image" alt="image" src="https://user-images.githubusercontent.com/507615/61370809-e37aa480-a8c5-11e9-98b3-51ce06dfba24.png">
+
+  - Fix `@border-radius-sm` not working for Slider, TreeSelect.
+  - Added some less variables for Progress, Tabs, Slider and Timeline.
+
+- TypeScript
+  - 💄 Improve type definition of Form. [#17676](https://github.com/ant-design/ant-design/pull/17676) [@lixiaoyang1992](https://github.com/lixiaoyang1992)
+  - 💄 Improve type definition of Tabs. [#17675](https://github.com/ant-design/ant-design/pull/17675)
+
+## 3.20.3
+
+`2019-07-15`
+
+- 🚨 Revert change of Input suffix style in [#17508](https://github.com/ant-design/ant-design/pull/17508), since it introduced other problems
+
+## 3.20.2
+
+`2019-07-13`
+
+- 📖 Add version description for every features. [#17373](https://github.com/ant-design/ant-design/pull/17373) [@muzea](https://github.com/muzea)
+- 🐞 Fix Button transition style when loading. [#17596](https://github.com/ant-design/ant-design/pull/17596) [@LilyWakana](https://github.com/LilyWakana)
+- Cascader
+  - 🐞 Fix not display `notFoundContent` when options.length is 0. [#17538](https://github.com/ant-design/ant-design/pull/17538)
+  - 🐞 Fix option's loading not aligned when `isLeaf` is true. [#17550](https://github.com/ant-design/ant-design/pull/17550)
+  - 🐞 Fix over-length text covered by arrow. [#17583](https://github.com/ant-design/ant-design/pull/17583)
+- 🐞 Fix Input style when suffix and clear icon exist both. [#17508](https://github.com/ant-design/ant-design/pull/17508) [@LilyWakana](https://github.com/LilyWakana)
+- TypeScript
+  - 💄 Improve type definition of Cascader's option. [#17581](https://github.com/ant-design/ant-design/pull/17581) [@MrHeer](https://github.com/MrHeer)
+  - 🐞 Fix type definition of Descriptions.title. [#17559](https://github.com/ant-design/ant-design/pull/17559)
+  - 🐞 Fix type definition of Collapse.activeKey, Collapse.defaultActiveKey and CollapsePanel.key. [#17557](https://github.com/ant-design/ant-design/pull/17557) [@thylsky](https://github.com/thylsky)
+
 ## 3.20.1
 
 - 💄 Optimize TimePicker focus style. [#17447](https://github.com/ant-design/ant-design/pull/17447)
@@ -35,7 +115,7 @@ timeline: true
 - 🔥 Descriptions support vertical layout. [#17330](https://github.com/ant-design/ant-design/pull/17330) [@hengkx](https://github.com/hengkx)
 - 🔥 Progress.Circle support gradient line color. [#17315](https://github.com/ant-design/ant-design/pull/17315) [@hengkx](https://github.com/hengkx)
 
-<img class="markdown-inline-image" src="https://gw.alipayobjects.com/zos/antfincdn/WogwW6kA4O/method-draw-image.svg" alt="Progress">
+  <img class="markdown-inline-image" src="https://gw.alipayobjects.com/zos/antfincdn/WogwW6kA4O/method-draw-image.svg" alt="Progress">
 
 - 🔥 Optimize PageHeader className naming. [#17321](https://github.com/ant-design/ant-design/pull/17321)
 - 🐞 Drawer fixes `maskCloseble` to false, keyboard ESC closes invalid. [#17316](https://github.com/ant-design/ant-design/pull/17316)

CHANGELOG.zh-CN.md

@@ -15,6 +15,86 @@ timeline: true
 
 ---
 
+## 3.20.7
+
+- 🐞 修复 Upload 在 Form.Item 中无法点击的问题。[#17897](https://github.com/ant-design/ant-design/pull/17897)
+
+## 3.20.6
+
+`2019-07-24`
+
+- 🐞 修复 Col 在高度为 0 时的占位问题。 [#17748](https://github.com/ant-design/ant-design/pull/17748) [@yoyo837](https://github.com/yoyo837)
+- 🐞 修复 Cascader `options` 中 `children` 为 `null` 时报错的问题。[#17756](https://github.com/ant-design/ant-design/pull/17756)
+- 🐞 修复 Checkbox 左对齐的内边距问题。[#17752](https://github.com/ant-design/ant-design/pull/17752) [#17761](https://github.com/ant-design/ant-design/pull/17761) [@inovux](https://github.com/inovux)
+- 🐞 修复 Input 在 IE 下错位的问题。[#17759](https://github.com/ant-design/ant-design/pull/17759)
+- 🐞 修复最后一个 Rate 有额外边距的问题。[#17764](https://github.com/ant-design/ant-design/pull/17764) [@inovux](https://github.com/inovux)
+- 🐞 修复 Radio.Button 失效项的边框样式问题。[#17775](https://github.com/ant-design/ant-design/pull/17775)
+- 🐞 修复 DatePicker `@input-hover-border-color` 变量不生效的问题。[#17784](https://github.com/ant-design/ant-design/pull/17784)
+- 🐞 修复 Transfer 在 `lazy` 时更新数据不触发重新渲染的问题。[#17783](https://github.com/ant-design/ant-design/pull/17783)
+- 🐞 修复 RangePicker `defaultValue` 中开始时间可大于结束时间的问题。[#17694](https://github.com/ant-design/ant-design/pull/17694) [@mraiguo](https://github.com/mraiguo)
+- 💄 优化 `placeholder` 文字过长时的截断样式兼容性问题。[#17797](https://github.com/ant-design/ant-design/pull/17797) [@Kapiroska](https://github.com/Kapiroska)
+- 🐞 修复 Menu 循环依赖的问题。[#17805](https://github.com/ant-design/ant-design/pull/17805) [@phthhieu](https://github.com/phthhieu)
+- 🐞 修复 Alert `message` 样式问题。[#17808](https://github.com/ant-design/ant-design/pull/17808) [@mtadams007](https://github.com/mtadams007)
+- 🐞 修复 Result `extra` 部分不居中的问题。[#17786](https://github.com/ant-design/ant-design/pull/17786) [@nnecec](https://github.com/nnecec)
+- 🐞 修复 Progress 在 `value` 较小时，左边条不够圆的问题。[#17819](https://github.com/ant-design/ant-design/pull/17819)
+- 🐞 修复 Statistic.Countdown `format` 不支持方括号保留字符串的问题。[#17841](https://github.com/ant-design/ant-design/pull/17841)
+- 🐞 修复 Table 自定义 `filterDropdown` 在某些情况下消失时总是触发 `onChange` 的问题。[#17846](https://github.com/ant-design/ant-design/pull/17846)
+- 🐞 修复 TimePicker 在 Safari 下的滚动条渲染问题。[#17857](https://github.com/ant-design/ant-design/pull/17857)
+
+## 3.20.5
+
+`2019-07-19`
+
+- 🐞 修复 `<Button type="danger" ghost />` 样式问题。[#17743](https://github.com/ant-design/ant-design/pull/17743)
+
+## 3.20.4
+
+`2019-07-19`
+
+- 🐞 修复多层级 Drawer 的 `mask` 为 false 时，卸载子级组件后父抽屉不收回的问题。[#17698](https://github.com/ant-design/ant-design/pull/17698)
+- 🐞 修复 Table 圆角样式在 Firefox 下丢失的问题。[#17641](https://github.com/ant-design/ant-design/pull/17641)
+- 🐞 修复 Menu 抛出 `Cannot update during an existing state transition` 警告的问题。[#17657](https://github.com/ant-design/ant-design/pull/17657)
+- 🐞 修复 Affix 容器变化时尺寸不变的问题。[#17678](https://github.com/ant-design/ant-design/pull/17678)
+- 🐞 修复 Anchor 监听元素不随着 `getContainer` 变化的问题。[#17677](https://github.com/ant-design/ant-design/pull/17677)
+- 🐞 修复 Modal 和 Drawer 同时使用导致的窗体滚动条冲突的问题。[#17600](https://github.com/ant-design/ant-design/pull/17600)
+- 🌟 Empty `description` 支持 `false`。 [#17659](https://github.com/ant-design/ant-design/pull/17659) [@billfeller](https://github.com/billfeller)
+- 💄 去除 Pagination 元素下划线以防止被全局样式污染。[#17728](https://github.com/ant-design/ant-design/pull/17728)
+- 💄 拓展 Card action 可点击区域。[#17705](https://github.com/ant-design/ant-design/pull/17705) [@lhx6538665](https://github.com/lhx6538665)
+- 💄 对 Less 变量进行了一波调整，以适应更多细节风格定制。[#17697](https://github.com/ant-design/ant-design/pull/17697)
+
+  - 调整危险按钮样式。
+
+    <img width="103" class="markdown-inline-image" alt="image" src="https://user-images.githubusercontent.com/507615/61370809-e37aa480-a8c5-11e9-98b3-51ce06dfba24.png">
+
+  - 修复 `@border-radius-sm` 对 Slider、TreeSelect 不生效的问题。
+  - Progress、Tabs、Slider、Timeline 组件补充 less 变量。
+
+- TypeScript
+  - 💄 完善 Form 的类型定义。[#17676](https://github.com/ant-design/ant-design/pull/17676) [@lixiaoyang1992](https://github.com/lixiaoyang1992)
+  - 💄 完善 Tabs 的类型定义。[#17675](https://github.com/ant-design/ant-design/pull/17675)
+
+## 3.20.3
+
+`2019-07-15`
+
+- 🚨 回滚 [#17508](https://github.com/ant-design/ant-design/pull/17508) 中对 Input 后缀样式的修改，因其导致了其他更多问题。
+
+## 3.20.2
+
+`2019-07-13`
+
+- 📖 文档中增加对组件新特性的版本说明。[#17373](https://github.com/ant-design/ant-design/pull/17373) [@muzea](https://github.com/muzea)
+- 🐞 修复 Button 组件的 loading 样式问题。[#17596](https://github.com/ant-design/ant-design/pull/17596) [@LilyWakana](https://github.com/LilyWakana)
+- Cascader
+  - 🐞 修复 options 为空时不展示空内容的问题。[#17538](https://github.com/ant-design/ant-design/pull/17538)
+  - 🐞 修复 option 的 isLeaf 为 true 时 loading 样式没有对齐的问题。[#17550](https://github.com/ant-design/ant-design/pull/17550)
+  - 🐞 修复文本过长被箭头遮挡的问题。[#17583](https://github.com/ant-design/ant-design/pull/17583)
+- 🐞 修复 Input 组件存在多个后缀图标时的样式错乱问题。[#17508](https://github.com/ant-design/ant-design/pull/17508) [@LilyWakana](https://github.com/LilyWakana)
+- TypeScript
+  - 💄 完善 Cascader 的 `option` 类型定义。[#17581](https://github.com/ant-design/ant-design/pull/17581) [@MrHeer](https://github.com/MrHeer)
+  - 🐞 修复 Descriptions 的 `title` 类型定义。[#17559](https://github.com/ant-design/ant-design/pull/17559)
+  - 🐞 修复 Collapse 的 activeKey、defaultActiveKey 以及 Collapse.Panel 的 key 类型定义。[#17557](https://github.com/ant-design/ant-design/pull/17557) [@thylsky](https://github.com/thylsky)
+
 ## 3.20.1
 
 - 💄 优化 TimePicker 聚焦状态的样式。[#17447](https://github.com/ant-design/ant-design/pull/17447)
@@ -36,7 +116,7 @@ timeline: true
 - 🔥 优化 PageHeader 的 `className` 定义。[#17321](https://github.com/ant-design/ant-design/pull/17321)
 - 🔥 Progress.Circle 支持渐变色。[#17315](https://github.com/ant-design/ant-design/pull/17315) [@hengkx](https://github.com/hengkx)
 
-<img class="markdown-inline-image" src="https://gw.alipayobjects.com/zos/antfincdn/WogwW6kA4O/method-draw-image.svg" alt="Progress">
+  <img class="markdown-inline-image" src="https://gw.alipayobjects.com/zos/antfincdn/WogwW6kA4O/method-draw-image.svg" alt="Progress">
 
 - 🐞 Drawer 修复 `maskCloseble` 为 false，键盘 ESC 关闭无效的问题。[#17316](https://github.com/ant-design/ant-design/pull/17316)
 - 🐞 修复在 Edge 下 Drawer 关闭后没有调用 `afterVisibleChange` 的问题。[#17311](https://github.com/ant-design/ant-design/pull/17311)

components/affix/__tests__/Affix.test.js

@@ -162,29 +162,37 @@ describe('Affix Render', () => {
     });
   });
 
-  it('updatePosition when size changed', () => {
-    document.body.innerHTML = '<div id="mounter" />';
+  describe('updatePosition when size changed', () => {
+    function test(name, index) {
+      it(name, () => {
+        document.body.innerHTML = '<div id="mounter" />';
 
-    const updateCalled = jest.fn();
-    wrapper = mount(<AffixMounter offsetBottom={0} onTestUpdatePosition={updateCalled} />, {
-      attachTo: document.getElementById('mounter'),
-    });
+        const updateCalled = jest.fn();
+        wrapper = mount(<AffixMounter offsetBottom={0} onTestUpdatePosition={updateCalled} />, {
+          attachTo: document.getElementById('mounter'),
+        });
 
-    jest.runAllTimers();
+        jest.runAllTimers();
 
-    movePlaceholder(300);
-    expect(wrapper.instance().affix.state.affixStyle).toBeTruthy();
-    jest.runAllTimers();
-    wrapper.update();
+        movePlaceholder(300);
+        expect(wrapper.instance().affix.state.affixStyle).toBeTruthy();
+        jest.runAllTimers();
+        wrapper.update();
 
-    // Mock trigger resize
-    updateCalled.mockReset();
-    wrapper
-      .find('ReactResizeObserver')
-      .instance()
-      .onResize();
-    jest.runAllTimers();
+        // Mock trigger resize
+        updateCalled.mockReset();
+        wrapper
+          .find('ReactResizeObserver')
+          .at(index)
+          .instance()
+          .onResize();
+        jest.runAllTimers();
 
-    expect(updateCalled).toHaveBeenCalled();
+        expect(updateCalled).toHaveBeenCalled();
+      });
+    }
+
+    test('inner', 0);
+    test('outer', 1);
   });
 });

components/affix/__tests__/__snapshots__/demo.test.js.snap

@@ -34,6 +34,37 @@ exports[`renders ./components/affix/demo/basic.md correctly 1`] = `
 </div>
 `;
 
+exports[`renders ./components/affix/demo/debug.md correctly 1`] = `
+<div
+  style="height:10000px"
+>
+  <div>
+    Top
+  </div>
+  <div>
+    <div
+      class=""
+    >
+      <div
+        style="background:red"
+      >
+        <button
+          class="ant-btn ant-btn-primary"
+          type="button"
+        >
+          <span>
+            Affix top
+          </span>
+        </button>
+      </div>
+    </div>
+  </div>
+  <div>
+    Bottom
+  </div>
+</div>
+`;
+
 exports[`renders ./components/affix/demo/on-change.md correctly 1`] = `
 <div>
   <div

components/affix/demo/debug.md

@@ -0,0 +1,50 @@
+---
+order: 99
+title:
+  zh-CN: 调试
+  en-US: Debug
+debug: true
+---
+
+## zh-CN
+
+DEBUG
+
+## en-US
+
+DEBUG
+
+```jsx
+import { Affix, Button } from 'antd';
+
+class Demo extends React.Component {
+  state = {
+    top: 10,
+  };
+
+  render() {
+    return (
+      <div style={{ height: 10000 }}>
+        <div>Top</div>
+        <Affix offsetTop={this.state.top}>
+          <div style={{ background: 'red' }}>
+            <Button
+              type="primary"
+              onClick={() => {
+                this.setState({
+                  top: this.state.top + 10,
+                });
+              }}
+            >
+              Affix top
+            </Button>
+          </div>
+        </Affix>
+        <div>Bottom</div>
+      </div>
+    );
+  }
+}
+
+ReactDOM.render(<Demo />, mountNode);
+```

components/affix/index.en-US.md

@@ -14,12 +14,12 @@ Please note that Affix should not cover other content on the page, especially wh
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| offsetBottom | Pixels to offset from bottom when calculating position of scroll | number | - |
-| offsetTop | Pixels to offset from top when calculating position of scroll | number | 0 |
-| target | specifies the scrollable area dom node | () => HTMLElement | () => window |
-| onChange | Callback for when affix state is changed | Function(affixed) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| offsetBottom | Pixels to offset from bottom when calculating position of scroll | number | - |  |
+| offsetTop | Pixels to offset from top when calculating position of scroll | number | 0 |  |
+| target | specifies the scrollable area dom node | () => HTMLElement | () => window |  |
+| onChange | Callback for when affix state is changed | Function(affixed) | - |  |
 
 **Note:** Children of `Affix` can not be `position: absolute`, but you can set `Affix` as `position: absolute`:
 

components/affix/index.tsx

@@ -256,8 +256,8 @@ class Affix extends React.Component<AffixProps, AffixState> {
 
   // =================== Render ===================
   renderAffix = ({ getPrefixCls }: ConfigConsumerProps) => {
-    const { affixStyle, placeholderStyle, status } = this.state;
-    const { prefixCls, style, children } = this.props;
+    const { affixStyle, placeholderStyle } = this.state;
+    const { prefixCls, children } = this.props;
     const className = classNames({
       [getPrefixCls('affix', prefixCls)]: affixStyle,
     });
@@ -267,22 +267,26 @@ class Affix extends React.Component<AffixProps, AffixState> {
     if (process.env.NODE_ENV === 'test') {
       props = omit(props, ['onTestUpdatePosition']);
     }
-    const mergedPlaceholderStyle = {
-      ...(status === AffixStatus.None ? placeholderStyle : null),
-      ...style,
-    };
+
     return (
-      <div {...props} style={mergedPlaceholderStyle} ref={this.savePlaceholderNode}>
-        <div className={className} ref={this.saveFixedNode} style={this.state.affixStyle}>
-          <ResizeObserver
-            onResize={() => {
-              this.updatePosition();
-            }}
-          >
-            {children}
-          </ResizeObserver>
+      <ResizeObserver
+        onResize={() => {
+          this.updatePosition();
+        }}
+      >
+        <div {...props} ref={this.savePlaceholderNode}>
+          {affixStyle && <div style={placeholderStyle} aria-hidden="true" />}
+          <div className={className} ref={this.saveFixedNode} style={affixStyle}>
+            <ResizeObserver
+              onResize={() => {
+                this.updatePosition();
+              }}
+            >
+              {children}
+            </ResizeObserver>
+          </div>
         </div>
-      </div>
+      </ResizeObserver>
     );
   };
 

components/affix/index.zh-CN.md

@@ -15,12 +15,12 @@ title: Affix
 
 ## API
 
-| 成员 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| offsetBottom | 距离窗口底部达到指定偏移量后触发 | number |  |
-| offsetTop | 距离窗口顶部达到指定偏移量后触发 | number |  |
-| target | 设置 `Affix` 需要监听其滚动事件的元素，值为一个返回对应 DOM 元素的函数 | () => HTMLElement | () => window |
-| onChange | 固定状态改变时触发的回调函数 | Function(affixed) | 无 |
+| 成员 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| offsetBottom | 距离窗口底部达到指定偏移量后触发 | number |  |  |
+| offsetTop | 距离窗口顶部达到指定偏移量后触发 | number |  |  |
+| target | 设置 `Affix` 需要监听其滚动事件的元素，值为一个返回对应 DOM 元素的函数 | () => HTMLElement | () => window |  |
+| onChange | 固定状态改变时触发的回调函数 | Function(affixed) | 无 |  |
 
 **注意：**`Affix` 内的元素不要使用绝对定位，如需要绝对定位的效果，可以直接设置 `Affix` 为绝对定位：
 

components/alert/index.en-US.md

@@ -13,15 +13,15 @@ Alert component for feedback.
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| afterClose | Called when close animation is finished | () => void | - |
-| banner | Whether to show as banner | boolean | false |
-| closable | Whether Alert can be closed | boolean | - |
-| closeText | Close text to show | string\|ReactNode | - |
-| description | Additional content of Alert | string\|ReactNode | - |
-| icon | Custom icon, effective when `showIcon` is `true` | ReactNode | - |
-| message | Content of Alert | string\|ReactNode | - |
-| showIcon | Whether to show icon | boolean | false, in `banner` mode default is true |
-| type | Type of Alert styles, options: `success`, `info`, `warning`, `error` | string | `info`, in `banner` mode default is `warning` |
-| onClose | Callback when Alert is closed | (e: MouseEvent) => void | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| afterClose | Called when close animation is finished | () => void | - | 3.3.1 |
+| banner | Whether to show as banner | boolean | false |  |
+| closable | Whether Alert can be closed | boolean | - |  |
+| closeText | Close text to show | string\|ReactNode | - |  |
+| description | Additional content of Alert | string\|ReactNode | - |  |
+| icon | Custom icon, effective when `showIcon` is `true` | ReactNode | - | 3.10.0 |
+| message | Content of Alert | string\|ReactNode | - |  |
+| showIcon | Whether to show icon | boolean | false, in `banner` mode default is true |  |
+| type | Type of Alert styles, options: `success`, `info`, `warning`, `error` | string | `info`, in `banner` mode default is `warning` |  |
+| onClose | Callback when Alert is closed | (e: MouseEvent) => void | - |  |

components/alert/index.zh-CN.md

@@ -14,15 +14,15 @@ title: Alert
 
 ## API
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| afterClose | 关闭动画结束后触发的回调函数 | () => void | - |
-| banner | 是否用作顶部公告 | boolean | false |
-| closable | 默认不显示关闭按钮 | boolean | 无 |
-| closeText | 自定义关闭按钮 | string\|ReactNode | 无 |
-| description | 警告提示的辅助性文字介绍 | string\|ReactNode | 无 |
-| icon | 自定义图标，`showIcon` 为 `true` 时有效 | ReactNode | - |
-| message | 警告提示内容 | string\|ReactNode | 无 |
-| showIcon | 是否显示辅助图标 | boolean | false，`banner` 模式下默认值为 true |
-| type | 指定警告提示的样式，有四种选择 `success`、`info`、`warning`、`error` | string | `info`，`banner` 模式下默认值为 `warning` |
-| onClose | 关闭时触发的回调函数 | (e: MouseEvent) => void | 无 |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| afterClose | 关闭动画结束后触发的回调函数 | () => void | - | 3.3.1 |
+| banner | 是否用作顶部公告 | boolean | false |  |
+| closable | 默认不显示关闭按钮 | boolean | 无 |  |
+| closeText | 自定义关闭按钮 | string\|ReactNode | 无 |  |
+| description | 警告提示的辅助性文字介绍 | string\|ReactNode | 无 |  |
+| icon | 自定义图标，`showIcon` 为 `true` 时有效 | ReactNode | - | 3.10.0 |
+| message | 警告提示内容 | string\|ReactNode | 无 |  |
+| showIcon | 是否显示辅助图标 | boolean | false，`banner` 模式下默认值为 true |  |
+| type | 指定警告提示的样式，有四种选择 `success`、`info`、`warning`、`error` | string | `info`，`banner` 模式下默认值为 `warning` |  |
+| onClose | 关闭时触发的回调函数 | (e: MouseEvent) => void | 无 |  |

components/alert/style/index.less

@@ -124,6 +124,10 @@
     font-size: @font-size-lg;
   }
 
+  &-message {
+    color: @alert-message-color;
+  }
+
   &-with-description &-description {
     display: block;
   }

components/anchor/Anchor.tsx

@@ -145,6 +145,8 @@ export default class Anchor extends React.Component<AnchorProps, AnchorState> {
   };
 
   private inkNode: HTMLSpanElement;
+  // scroll scope's container
+  private scrollContainer: HTMLElement | Window;
 
   private links: string[] = [];
   private scrollEvent: any;
@@ -174,7 +176,8 @@ export default class Anchor extends React.Component<AnchorProps, AnchorState> {
 
   componentDidMount() {
     const { getContainer } = this.props as AnchorDefaultProps;
-    this.scrollEvent = addEventListener(getContainer(), 'scroll', this.handleScroll);
+    this.scrollContainer = getContainer();
+    this.scrollEvent = addEventListener(this.scrollContainer, 'scroll', this.handleScroll);
     this.handleScroll();
   }
 
@@ -185,6 +188,16 @@ export default class Anchor extends React.Component<AnchorProps, AnchorState> {
   }
 
   componentDidUpdate() {
+    if (this.scrollEvent) {
+      const { getContainer } = this.props as AnchorDefaultProps;
+      const currentContainer = getContainer();
+      if (this.scrollContainer !== currentContainer) {
+        this.scrollContainer = currentContainer;
+        this.scrollEvent.remove();
+        this.scrollEvent = addEventListener(this.scrollContainer, 'scroll', this.handleScroll);
+        this.handleScroll();
+      }
+    }
     this.updateInk();
   }
 
@@ -192,10 +205,14 @@ export default class Anchor extends React.Component<AnchorProps, AnchorState> {
     if (this.animating) {
       return;
     }
+    const { activeLink } = this.state;
     const { offsetTop, bounds } = this.props;
-    this.setState({
-      activeLink: this.getCurrentAnchor(offsetTop, bounds),
-    });
+    const currentActiveLink = this.getCurrentAnchor(offsetTop, bounds);
+    if (activeLink !== currentActiveLink) {
+      this.setState({
+        activeLink: currentActiveLink,
+      });
+    }
   };
 
   handleScrollTo = (link: string) => {

components/anchor/__tests__/Anchor.test.js

@@ -4,6 +4,8 @@ import Anchor from '..';
 
 const { Link } = Anchor;
 
+const delay = timeout => new Promise(resolve => setTimeout(resolve, timeout));
+
 describe('Anchor Render', () => {
   it('Anchor render perfectly', () => {
     const wrapper = mount(
@@ -62,7 +64,7 @@ describe('Anchor Render', () => {
     wrapper.instance().handleScrollTo('##API');
     expect(wrapper.instance().state.activeLink).toBe('##API');
     expect(scrollToSpy).not.toHaveBeenCalled();
-    await new Promise(resolve => setTimeout(resolve, 1000));
+    await delay(1000);
     expect(scrollToSpy).toHaveBeenCalled();
   });
 
@@ -130,4 +132,116 @@ describe('Anchor Render', () => {
     expect(event).not.toBe(undefined);
     expect(link).toEqual({ href, title });
   });
+
+  it('Different function returns the same DOM', async () => {
+    let root = document.getElementById('root');
+    if (!root) {
+      root = document.createElement('div', { id: 'root' });
+      root.id = 'root';
+      document.body.appendChild(root);
+    }
+    mount(<div id="API">Hello</div>, { attachTo: root });
+    const getContainerA = () => {
+      return document.getElementById('API');
+    };
+    const getContainerB = () => {
+      return document.getElementById('API');
+    };
+
+    const wrapper = mount(
+      <Anchor getContainer={getContainerA}>
+        <Link href="#API" title="API" />
+      </Anchor>,
+    );
+    const removeListenerSpy = jest.spyOn(wrapper.instance().scrollEvent, 'remove');
+    await delay(1000);
+    wrapper.setProps({ getContainer: getContainerB });
+    expect(removeListenerSpy).not.toHaveBeenCalled();
+  });
+
+  it('Different function returns different DOM', async () => {
+    let root = document.getElementById('root');
+    if (!root) {
+      root = document.createElement('div', { id: 'root' });
+      root.id = 'root';
+      document.body.appendChild(root);
+    }
+    mount(
+      <div>
+        <div id="API1">Hello</div>
+        <div id="API2">World</div>
+      </div>,
+      { attachTo: root },
+    );
+    const getContainerA = () => {
+      return document.getElementById('API1');
+    };
+    const getContainerB = () => {
+      return document.getElementById('API2');
+    };
+    const wrapper = mount(
+      <Anchor getContainer={getContainerA}>
+        <Link href="#API1" title="API1" />
+        <Link href="#API2" title="API2" />
+      </Anchor>,
+    );
+    const removeListenerSpy = jest.spyOn(wrapper.instance().scrollEvent, 'remove');
+    expect(removeListenerSpy).not.toHaveBeenCalled();
+    await delay(1000);
+    wrapper.setProps({ getContainer: getContainerB });
+    expect(removeListenerSpy).toHaveBeenCalled();
+  });
+
+  it('Same function returns the same DOM', () => {
+    let root = document.getElementById('root');
+    if (!root) {
+      root = document.createElement('div', { id: 'root' });
+      root.id = 'root';
+      document.body.appendChild(root);
+    }
+    mount(<div id="API">Hello</div>, { attachTo: root });
+    const getContainer = () => document.getElementById('API');
+    const wrapper = mount(
+      <Anchor getContainer={getContainer}>
+        <Link href="#API" title="API" />
+      </Anchor>,
+    );
+    wrapper.find('a[href="#API"]').simulate('click');
+    wrapper.instance().handleScroll();
+    expect(wrapper.instance().state).not.toBe(null);
+  });
+
+  it('Same function returns different DOM', async () => {
+    let root = document.getElementById('root');
+    if (!root) {
+      root = document.createElement('div', { id: 'root' });
+      root.id = 'root';
+      document.body.appendChild(root);
+    }
+    mount(
+      <div>
+        <div id="API1">Hello</div>
+        <div id="API2">World</div>
+      </div>,
+      { attachTo: root },
+    );
+    const holdContainer = {
+      container: document.getElementById('API1'),
+    };
+    const getContainer = () => {
+      return holdContainer.container;
+    };
+    const wrapper = mount(
+      <Anchor getContainer={getContainer}>
+        <Link href="#API1" title="API1" />
+        <Link href="#API2" title="API2" />
+      </Anchor>,
+    );
+    const removeListenerSpy = jest.spyOn(wrapper.instance().scrollEvent, 'remove');
+    expect(removeListenerSpy).not.toHaveBeenCalled();
+    await delay(1000);
+    holdContainer.container = document.getElementById('API2');
+    wrapper.setProps({ 'data-only-trigger-re-render': true });
+    expect(removeListenerSpy).toHaveBeenCalled();
+  });
 });

components/anchor/index.en-US.md

@@ -15,19 +15,19 @@ For displaying anchor hyperlinks on page and jumping between them.
 
 ### Anchor Props
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| affix | Fixed mode of Anchor | boolean | true |
-| bounds | Bounding distance of anchor area | number | 5(px) |
-| getContainer | Scrolling container | () => HTMLElement | () => window |
-| offsetBottom | Pixels to offset from bottom when calculating position of scroll | number | - |
-| offsetTop | Pixels to offset from top when calculating position of scroll | number | 0 |
-| showInkInFixed | Whether show ink-balls in Fixed mode | boolean | false |
-| onClick | set the handler to handle `click` event | Function(e: Event, link: Object) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| affix | Fixed mode of Anchor | boolean | true |  |
+| bounds | Bounding distance of anchor area | number | 5(px) |  |
+| getContainer | Scrolling container | () => HTMLElement | () => window | 3.4.0 |
+| offsetBottom | Pixels to offset from bottom when calculating position of scroll | number | - |  |
+| offsetTop | Pixels to offset from top when calculating position of scroll | number | 0 |  |
+| showInkInFixed | Whether show ink-balls in Fixed mode | boolean | false |  |
+| onClick | set the handler to handle `click` event | Function(e: Event, link: Object) | - | 3.9.0 |
 
 ### Link Props
 
-| Property | Description          | Type              | Default |
-| -------- | -------------------- | ----------------- | ------- |
-| href     | target of hyperlink  | string            |         |
-| title    | content of hyperlink | string\|ReactNode |         |
+| Property | Description          | Type              | Default | Version |
+| -------- | -------------------- | ----------------- | ------- | ------- |
+| href     | target of hyperlink  | string            |         |         |
+| title    | content of hyperlink | string\|ReactNode |         |         |

components/anchor/index.zh-CN.md

@@ -16,19 +16,19 @@ title: Anchor
 
 ### Anchor Props
 
-| 成员 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| affix | 固定模式 | boolean | true |
-| bounds | 锚点区域边界 | number | 5(px) |
-| getContainer | 指定滚动的容器 | () => HTMLElement | () => window |
-| offsetBottom | 距离窗口底部达到指定偏移量后触发 | number |  |
-| offsetTop | 距离窗口顶部达到指定偏移量后触发 | number |  |
-| showInkInFixed | 固定模式是否显示小圆点 | boolean | false |
-| onClick | `click` 事件的 handler | Function(e: Event, link: Object) | - |
+| 成员 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| affix | 固定模式 | boolean | true |  |
+| bounds | 锚点区域边界 | number | 5(px) |  |
+| getContainer | 指定滚动的容器 | () => HTMLElement | () => window | 3.4.0 |
+| offsetBottom | 距离窗口底部达到指定偏移量后触发 | number |  |  |
+| offsetTop | 距离窗口顶部达到指定偏移量后触发 | number |  |  |
+| showInkInFixed | 固定模式是否显示小圆点 | boolean | false |  |
+| onClick | `click` 事件的 handler | Function(e: Event, link: Object) | - | 3.9.0 |
 
 ### Link Props
 
-| 成员  | 说明     | 类型              | 默认值 |
-| ----- | -------- | ----------------- | ------ |
-| href  | 锚点链接 | string            |        |
-| title | 文字内容 | string\|ReactNode |        |
+| 成员  | 说明     | 类型              | 默认值 | 版本 |
+| ----- | -------- | ----------------- | ------ | ---- |
+| href  | 锚点链接 | string            |        |      |
+| title | 文字内容 | string\|ReactNode |        |      |

components/auto-complete/index.en-US.md

@@ -18,33 +18,33 @@ const dataSource = ['12345', '23456', '34567'];
 <AutoComplete dataSource={dataSource} />;
 ```
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| allowClear | Show clear button, effective in multiple mode only. | boolean | false |
-| autoFocus | get focus when component mounted | boolean | false |
-| backfill | backfill selected item the input when using keyboard | boolean | false |
-| children (for customize input element) | customize input element | HTMLInputElement / HTMLTextAreaElement / React.ReactElement<InputProps> | `<Input />` |
-| children (for dataSource) | Data source for autocomplete | React.ReactElement<OptionProps> / Array&lt;React.ReactElement<OptionProps>> | - |
-| dataSource | Data source for autocomplete | [DataSourceItemType](https://git.io/vMMKF)\[] |  |
-| defaultActiveFirstOption | Whether active first option by default | boolean | true |
-| defaultValue | Initial selected option. | string\|string\[]\| - |
-| disabled | Whether disabled select | boolean | false |
-| filterOption | If true, filter options by input, if function, filter options against it. The function will receive two arguments, `inputValue` and `option`, if the function returns `true`, the option will be included in the filtered set; Otherwise, it will be excluded. | boolean or function(inputValue, option) | true |
-| optionLabelProp | Which prop value of option will render as content of select. | string | `children` |
-| placeholder | placeholder of input | string | - |
-| value | selected option | string\|string\[]\|{ key: string, label: string\|ReactNode }\|Array&lt;{ key: string, label: string\|ReactNode }> | - |
-| onBlur | Called when leaving the component. | function() | - |
-| onChange | Called when select an option or input value change, or value of input is changed | function(value) | - |
-| onFocus | Called when entering the component | function() | - |
-| onSearch | Called when searching items. | function(value) | - |
-| onSelect | Called when a option is selected. param is option's value and option instance. | function(value, option) | - |
-| defaultOpen | Initial open state of dropdown | boolean | - |
-| open | Controlled open state of dropdown | boolean | - |
-| onDropdownVisibleChange | Call when dropdown open | function(open) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| allowClear | Show clear button, effective in multiple mode only. | boolean | false |  |
+| autoFocus | get focus when component mounted | boolean | false |  |
+| backfill | backfill selected item the input when using keyboard | boolean | false |  |
+| children (for customize input element) | customize input element | HTMLInputElement / HTMLTextAreaElement / React.ReactElement<InputProps> | `<Input />` |  |
+| children (for dataSource) | Data source for autocomplete | React.ReactElement<OptionProps> / Array&lt;React.ReactElement<OptionProps>> | - |  |
+| dataSource | Data source for autocomplete | [DataSourceItemType](https://git.io/vMMKF)\[] | - |  |
+| defaultActiveFirstOption | Whether active first option by default | boolean | true |  |
+| defaultValue | Initial selected option. | string\|string\[] | - |  |
+| disabled | Whether disabled select | boolean | false |  |
+| filterOption | If true, filter options by input, if function, filter options against it. The function will receive two arguments, `inputValue` and `option`, if the function returns `true`, the option will be included in the filtered set; Otherwise, it will be excluded. | boolean or function(inputValue, option) | true |  |
+| optionLabelProp | Which prop value of option will render as content of select. | string | `children` |  |
+| placeholder | placeholder of input | string | - |  |
+| value | selected option | string\|string\[]\|{ key: string, label: string\|ReactNode }\|Array&lt;{ key: string, label: string\|ReactNode }> | - |  |
+| onBlur | Called when leaving the component. | function() | - | 3.6.5 |
+| onChange | Called when select an option or input value change, or value of input is changed | function(value) | - |  |
+| onFocus | Called when entering the component | function() | - | 3.6.5 |
+| onSearch | Called when searching items. | function(value) | - |  |
+| onSelect | Called when a option is selected. param is option's value and option instance. | function(value, option) | - |  |
+| defaultOpen | Initial open state of dropdown | boolean | - | 3.9.3 |
+| open | Controlled open state of dropdown | boolean | - | 3.9.3 |
+| onDropdownVisibleChange | Call when dropdown open | function(open) | - | 3.9.3 |
 
 ## Methods
 
-| Name    | Description  |
-| ------- | ------------ |
-| blur()  | remove focus |
-| focus() | get focus    |
+| Name    | Description  | Version |
+| ------- | ------------ | ------- |
+| blur()  | remove focus |         |
+| focus() | get focus    |         |

components/auto-complete/index.zh-CN.md

@@ -19,34 +19,34 @@ const dataSource = ['12345', '23456', '34567'];
 <AutoComplete dataSource={dataSource} />;
 ```
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| allowClear | 支持清除, 单选模式有效 | boolean | false |
-| autoFocus | 自动获取焦点 | boolean | false |
-| backfill | 使用键盘选择选项的时候把选中项回填到输入框中 | boolean | false |
-| children (自动完成的数据源) | 自动完成的数据源 | React.ReactElement<OptionProps> / Array&lt;React.ReactElement<OptionProps>> | - |
-| children (自定义输入框) | 自定义输入框 | HTMLInputElement / HTMLTextAreaElement / React.ReactElement<InputProps> | `<Input />` |
-| dataSource | 自动完成的数据源 | [DataSourceItemType](https://git.io/vMMKF)\[] |  |
-| defaultActiveFirstOption | 是否默认高亮第一个选项。 | boolean | true |
-| defaultValue | 指定默认选中的条目 | string\|string\[]\| 无 |
-| disabled | 是否禁用 | boolean | false |
-| filterOption | 是否根据输入项进行筛选。当其为一个函数时，会接收 `inputValue` `option` 两个参数，当 `option` 符合筛选条件时，应返回 `true`，反之则返回 `false`。 | boolean or function(inputValue, option) | true |
-| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codesandbox.io/s/4j168r7jw0) | Function(triggerNode) | () => document.body |
-| optionLabelProp | 回填到选择框的 Option 的属性值，默认是 Option 的子元素。比如在子元素需要高亮效果时，此值可以设为 `value`。 | string | `children` |
-| placeholder | 输入框提示 | string | - |
-| value | 指定当前选中的条目 | string\|string\[]\|{ key: string, label: string\|ReactNode }\|Array&lt;{ key: string, label: string\|ReactNode }> | 无 |
-| onBlur | 失去焦点时的回调 | function() | - |
-| onChange | 选中 option，或 input 的 value 变化时，调用此函数 | function(value) | 无 |
-| onFocus | 获得焦点时的回调 | function() | - |
-| onSearch | 搜索补全项的时候调用 | function(value) | 无 |
-| onSelect | 被选中时调用，参数为选中项的 value 值 | function(value, option) | 无 |
-| defaultOpen | 是否默认展开下拉菜单 | boolean | - |
-| open | 是否展开下拉菜单 | boolean | - |
-| onDropdownVisibleChange | 展开下拉菜单的回调 | function(open) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| allowClear | 支持清除, 单选模式有效 | boolean | false |  |
+| autoFocus | 自动获取焦点 | boolean | false |  |
+| backfill | 使用键盘选择选项的时候把选中项回填到输入框中 | boolean | false |  |
+| children (自动完成的数据源) | 自动完成的数据源 | React.ReactElement<OptionProps> / Array&lt;React.ReactElement<OptionProps>> | - |  |  |
+| children (自定义输入框) | 自定义输入框 | HTMLInputElement / HTMLTextAreaElement / React.ReactElement<InputProps> | `<Input />` | @todo.muyu |
+| dataSource | 自动完成的数据源 | [DataSourceItemType](https://git.io/vMMKF)\[] |  |  |
+| defaultActiveFirstOption | 是否默认高亮第一个选项。 | boolean | true |  |
+| defaultValue | 指定默认选中的条目 | string\|string\[]\| 无 |  |
+| disabled | 是否禁用 | boolean | false |  |
+| filterOption | 是否根据输入项进行筛选。当其为一个函数时，会接收 `inputValue` `option` 两个参数，当 `option` 符合筛选条件时，应返回 `true`，反之则返回 `false`。 | boolean or function(inputValue, option) | true |  |
+| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codesandbox.io/s/4j168r7jw0) | Function(triggerNode) | () => document.body | 3.19.4 |
+| optionLabelProp | 回填到选择框的 Option 的属性值，默认是 Option 的子元素。比如在子元素需要高亮效果时，此值可以设为 `value`。 | string | `children` |  |
+| placeholder | 输入框提示 | string | - |  |
+| value | 指定当前选中的条目 | string\|string\[]\|{ key: string, label: string\|ReactNode }\|Array&lt;{ key: string, label: string\|ReactNode }> | 无 |  |
+| onBlur | 失去焦点时的回调 | function() | - | 3.6.5 |
+| onChange | 选中 option，或 input 的 value 变化时，调用此函数 | function(value) | 无 |  |
+| onFocus | 获得焦点时的回调 | function() | - | 3.6.5 |
+| onSearch | 搜索补全项的时候调用 | function(value) | 无 |  |
+| onSelect | 被选中时调用，参数为选中项的 value 值 | function(value, option) | 无 |  |
+| defaultOpen | 是否默认展开下拉菜单 | boolean | - | 3.9.3 |
+| open | 是否展开下拉菜单 | boolean | - | 3.9.3 |
+| onDropdownVisibleChange | 展开下拉菜单的回调 | function(open) | - | 3.9.3 |
 
 ## 方法
 
-| 名称    | 描述     |
-| ------- | -------- |
-| blur()  | 移除焦点 |
-| focus() | 获取焦点 |
+| 名称    | 描述     | 版本 |
+| ------- | -------- | ---- |
+| blur()  | 移除焦点 |      |
+| focus() | 获取焦点 |      |

components/avatar/index.en-US.md

@@ -8,12 +8,12 @@ Avatars can be used to represent people or objects. It supports images, `Icon`s,
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| icon | the `Icon` type for an icon avatar, see `Icon` Component | string | - |
-| shape | the shape of avatar | `circle` \| `square` | `circle` |
-| size | the size of the avatar | number \| string: `large` `small` `default` | `default` |
-| src | the address of the image for an image avatar | string | - |
-| srcSet | a list of sources to use for different screen resolutions | string | - |
-| alt | This attribute defines the alternative text describing the image | string | - |
-| onError | handler when img load error, return false to prevent default fallback behavior | () => boolean | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| icon | the `Icon` type for an icon avatar, see `Icon` Component | string | - |  |
+| shape | the shape of avatar | `circle` \| `square` | `circle` |  |
+| size | the size of the avatar | number \| string: `large` `small` `default` | `default` |  |
+| src | the address of the image for an image avatar | string | - |  |
+| srcSet | a list of sources to use for different screen resolutions | string | - | 3.11.0 |
+| alt | This attribute defines the alternative text describing the image | string | - | 3.7.0 |
+| onError | handler when img load error, return false to prevent default fallback behavior | () => boolean | - | 3.8.0 |

components/avatar/index.zh-CN.md

@@ -13,12 +13,12 @@ title: Avatar
 
 ## API
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| icon | 设置头像的图标类型，参考 `Icon` 组件 | string | - |
-| shape | 指定头像的形状 | Enum{ 'circle', 'square' } | `circle` |
-| size | 设置头像的大小 | number \| Enum{ 'large', 'small', 'default' } | `default` |
-| src | 图片类头像的资源地址 | string | - |
-| srcSet | 设置图片类头像响应式资源地址 | string | - |
-| alt | 图像无法显示时的替代文本 | string | - |
-| onError | 图片加载失败的事件，返回 false 会关闭组件默认的 fallback 行为 | () => boolean | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| icon | 设置头像的图标类型，参考 `Icon` 组件 | string | - |  |
+| shape | 指定头像的形状 | Enum{ 'circle', 'square' } | `circle` |  |
+| size | 设置头像的大小 | number \| Enum{ 'large', 'small', 'default' } | `default` |  |
+| src | 图片类头像的资源地址 | string | - |  |
+| srcSet | 设置图片类头像响应式资源地址 | string | - | 3.11.0 |
+| alt | 图像无法显示时的替代文本 | string | - | 3.7.0 |
+| onError | 图片加载失败的事件，返回 false 会关闭组件默认的 fallback 行为 | () => boolean | - | 3.8.0 |

components/back-top/index.en-US.md

@@ -17,8 +17,8 @@ title: BackTop
 >
 > If you decide to use custom styles, please note the size limit: no more than `40px * 40px`.
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| target | specifies the scrollable area dom node | () => HTMLElement | () => window |
-| visibilityHeight | the `BackTop` button will not show until the scroll height reaches this value | number | 400 |
-| onClick | a callback function, which can be executed when you click the button | Function | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| target | specifies the scrollable area dom node | () => HTMLElement | () => window |  |
+| visibilityHeight | the `BackTop` button will not show until the scroll height reaches this value | number | 400 |  |
+| onClick | a callback function, which can be executed when you click the button | Function | - |  |

components/back-top/index.zh-CN.md

@@ -18,8 +18,8 @@ title: BackTop
 >
 > 自定义样式宽高不大于 40px \* 40px。
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| target | 设置需要监听其滚动事件的元素，值为一个返回对应 DOM 元素的函数 | Function | () => window |
-| visibilityHeight | 滚动高度达到此参数值才出现 `BackTop` | number | 400 |
-| onClick | 点击按钮的回调函数 | Function | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| target | 设置需要监听其滚动事件的元素，值为一个返回对应 DOM 元素的函数 | Function | () => window |  |
+| visibilityHeight | 滚动高度达到此参数值才出现 `BackTop` | number | 400 |  |
+| onClick | 点击按钮的回调函数 | Function | - |  |

components/badge/index.en-US.md

@@ -32,4 +32,4 @@ Badge normally appears in proximity to notifications or user avatars with eye-ca
 | showZero | Whether to show badge when `count` is zero | boolean | `false` |  |
 | status | Set Badge as a status dot | `success` \| `processing` \| `default` \| `error` \| `warning` | `''` |  |
 | text | If `status` is set, `text` sets the display text of the status `dot` | string | `''` |  |
-| title | Text to show when hovering over the badge | string | `count` |  |
+| title | Text to show when hovering over the badge | string | `count` | 3.5.0 |

components/badge/index.zh-CN.md

@@ -33,4 +33,4 @@ title: Badge
 | showZero | 当数值为 0 时，是否展示 Badge | boolean | false |  |
 | status | 设置 Badge 为状态点 | Enum{ 'success', 'processing, 'default', 'error', 'warning' } | '' |  |
 | text | 在设置了 `status` 的前提下有效，设置状态点的文本 | string | '' |  |
-| title | 设置鼠标放在状态点上时显示的文字 | string | `count` |  |
+| title | 设置鼠标放在状态点上时显示的文字 | string | `count` | 3.5.0 |

components/breadcrumb/index.en-US.md

@@ -15,12 +15,12 @@ A breadcrumb displays the current location within a hierarchy. It allows going b
 
 ## API
 
-| Property | Description | Type | Optional | Default |
-| --- | --- | --- | --- | --- |
-| itemRender | Custom item renderer | (route, params, routes, paths) => ReactNode |  | - |
-| params | Routing parameters | object |  | - |
-| routes | The routing stack information of router | [routes\[\]](#routes) |  | - |
-| separator | Custom separator | string\|ReactNode |  | `/` |
+| Property | Description | Type | Optional | Default | Version |
+| --- | --- | --- | --- | --- | --- |
+| itemRender | Custom item renderer | (route, params, routes, paths) => ReactNode |  | - |  |
+| params | Routing parameters | object |  | - |  |
+| routes | The routing stack information of router | [routes\[\]](#routes) |  | - |  |
+| separator | Custom separator | string\|ReactNode |  | `/` |  |
 
 ### Use with browserHistory
 

components/breadcrumb/index.zh-CN.md

@@ -17,21 +17,20 @@ title: Breadcrumb
 
 ### Breadcrumb
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| itemRender | 自定义链接函数，和 react-router 配置使用 | (route, params, routes, paths) => ReactNode | - |
-| params | 路由的参数 | object | - |
-| routes | router 的路由栈信息 | [routes\[\]](#routes) | - |
-| separator | 分隔符自定义 | string\|ReactNode | '/' |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| itemRender | 自定义链接函数，和 react-router 配置使用 | (route, params, routes, paths) => ReactNode | - | 3.17.0 |
+| params | 路由的参数 | object | - | 3.17.0 |
+| routes | router 的路由栈信息 | [routes\[\]](#routes) | - | 3.17.0 |
+| separator | 分隔符自定义 | string\|ReactNode | '/' | 3.17.0 |
 
 ### Breadcrumb.Item
 
-| 参数      | 参数           | 类型                                   | 默认值 |
-| --------- | -------------- | -------------------------------------- | ------ |
-| href      | 链接的目的地   | string                                 | -      |
-| separator | 自定义的分隔符 | string\|ReactNode                      | '/'    |
-| overlay   | 下来菜单的内容 | [Menu](/components/menu) \| () => Menu | -      |
-| onClick   | 单击事件       | (e:MouseEvent)=>void                   | -      |
+| 参数    | 参数           | 类型                                   | 默认值 | 版本   |
+| ------- | -------------- | -------------------------------------- | ------ | ------ |
+| href    | 链接的目的地   | string                                 | -      | 3.17.0 |
+| overlay | 下拉菜单的内容 | [Menu](/components/menu) \| () => Menu | -      | 3.17.0 |
+| onClick | 单击事件       | (e:MouseEvent)=>void                   | -      | 3.17.0 |
 
 ### routes
 

components/button/index.en-US.md

@@ -14,20 +14,20 @@ A button means an operation (or a series of operations). Clicking a button will
 
 To get a customized button, just set `type`/`shape`/`size`/`loading`/`disabled`.
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| disabled | disabled state of button | boolean | `false` |
-| ghost | make background transparent and invert text and border colors, added in 2.7 | boolean | `false` |
-| href | redirect url of link button | string | - |
-| htmlType | set the original html `type` of `button`, see: [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type) | string | `button` |
-| icon | set the icon of button, see: Icon component | string | - |
-| loading | set the loading status of button | boolean \| { delay: number } | `false` |
-| shape | can be set to `circle`, `round` or omitted | string | - |
-| size | can be set to `small` `large` or omitted | string | `default` |
-| target | same as target attribute of a, works when href is specified | string | - |
-| type | can be set to `primary` `ghost` `dashed` `danger` `link`(added in 3.17) or omitted (meaning `default`) | string | `default` |
-| onClick | set the handler to handle `click` event | (event) => void | - |
-| block | option to fit button width to its parent width | boolean | `false` |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| disabled | disabled state of button | boolean | `false` | 3.5.1 |
+| ghost | make background transparent and invert text and border colors, added in 2.7 | boolean | `false` |  |
+| href | redirect url of link button | string | - |  |
+| htmlType | set the original html `type` of `button`, see: [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type) | string | `button` |  |
+| icon | set the icon of button, see: Icon component | string | - |  |
+| loading | set the loading status of button | boolean \| { delay: number } | `false` |  |
+| shape | can be set to `circle`, `round` or omitted | string | - |  |
+| size | can be set to `small` `large` or omitted | string | `default` |  |
+| target | same as target attribute of a, works when href is specified | string | - |  |
+| type | can be set to `primary` `ghost` `dashed` `danger` `link`(added in 3.17) or omitted (meaning `default`) | string | `default` |  |
+| onClick | set the handler to handle `click` event | (event) => void | - |  |
+| block | option to fit button width to its parent width | boolean | `false` | 3.8.0 |
 
 It accepts all props which native button support.
 

components/button/index.zh-CN.md

@@ -17,20 +17,20 @@ subtitle: 按钮
 
 按钮的属性说明如下：
 
-| 属性 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| disabled | 按钮失效状态 | boolean | `false` |
-| ghost | 幽灵属性，使按钮背景透明，版本 2.7 中增加 | boolean | false |
-| href | 点击跳转的地址，指定此属性 button 的行为和 a 链接一致 | string | - |
-| htmlType | 设置 `button` 原生的 `type` 值，可选值请参考 [HTML 标准](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type) | string | `button` |
-| icon | 设置按钮的图标类型 | string | - |
-| loading | 设置按钮载入状态 | boolean \| { delay: number } | `false` |
-| shape | 设置按钮形状，可选值为 `circle`、 `round` 或者不设 | string | - |
-| size | 设置按钮大小，可选值为 `small` `large` 或者不设 | string | `default` |
-| target | 相当于 a 链接的 target 属性，href 存在时生效 | string | - |
-| type | 设置按钮类型，可选值为 `primary` `dashed` `danger` `link`(3.17 中增加) 或者不设 | string | - |
-| onClick | 点击按钮时的回调 | (event) => void | - |
-| block | 将按钮宽度调整为其父宽度的选项 | boolean | `false` |
+| 属性 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| disabled | 按钮失效状态 | boolean | `false` | 3.5.1 |
+| ghost | 幽灵属性，使按钮背景透明，版本 2.7 中增加 | boolean | false |  |
+| href | 点击跳转的地址，指定此属性 button 的行为和 a 链接一致 | string | - |  |
+| htmlType | 设置 `button` 原生的 `type` 值，可选值请参考 [HTML 标准](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type) | string | `button` |  |
+| icon | 设置按钮的图标类型 | string | - |  |
+| loading | 设置按钮载入状态 | boolean \| { delay: number } | `false` |  |
+| shape | 设置按钮形状，可选值为 `circle`、 `round` 或者不设 | string | - |  |
+| size | 设置按钮大小，可选值为 `small` `large` 或者不设 | string | `default` |  |
+| target | 相当于 a 链接的 target 属性，href 存在时生效 | string | - |  |
+| type | 设置按钮类型，可选值为 `primary` `dashed` `danger` `link`(3.17 中增加) 或者不设 | string | - |  |
+| onClick | 点击按钮时的回调 | (event) => void | - |  |
+| block | 将按钮宽度调整为其父宽度的选项 | boolean | `false` | 3.8.0 |
 
 支持原生 button 的其他所有属性。
 

components/button/style/index.less

@@ -24,6 +24,7 @@
   > i,
   > span {
     display: inline-block;
+    transition: margin-left 0.3s @ease-in-out;
     pointer-events: none;
   }
 
@@ -166,7 +167,7 @@
   }
 
   &-background-ghost&-danger {
-    .button-variant-ghost(@btn-danger-color);
+    .button-variant-ghost(@btn-danger-border);
   }
 
   &-background-ghost&-link {

components/button/style/mixin.less

@@ -66,26 +66,6 @@
   }
   .button-disabled();
 }
-.button-variant-danger(@color; @background; @border) {
-  .button-color(@color; @background; @border);
-  &:hover {
-    .button-color(
-      @btn-primary-color; ~`colorPalette('@{color}', 5) `; ~`colorPalette('@{color}', 5) `
-    );
-  }
-  &:focus {
-    .button-color(
-      ~`colorPalette('@{color}', 5) `; @component-background; ~`colorPalette('@{color}', 5) `
-    );
-  }
-  &:active,
-  &.active {
-    .button-color(
-      @btn-primary-color; ~`colorPalette('@{color}', 7) `; ~`colorPalette('@{color}', 7) `
-    );
-  }
-  .button-disabled();
-}
 .button-variant-ghost(@color; @border: @color) {
   .button-color(@color; transparent; @border);
   text-shadow: none;
@@ -230,7 +210,7 @@
 }
 // danger button style
 .btn-danger() {
-  .button-variant-danger(@btn-danger-color, @btn-danger-bg, @btn-danger-border);
+  .button-variant-primary(@btn-danger-color, @btn-danger-bg);
 }
 // link button style
 .btn-link() {

components/calendar/index.en-US.md

@@ -40,9 +40,9 @@ When data is in the form of dates, such as schedules, timetables, prices calenda
 | mode | The display mode of the calendar | `month` \| `year` | `month` |  |
 | monthCellRender | Customize the display of the month cell, the returned content will be appended to the cell | function(date: moment): ReactNode | - |  |
 | monthFullCellRender | Customize the display of the month cell, the returned content will override the cell | function(date: moment): ReactNode | - |  |
-| validRange | to set valid range | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)] | - |  |
-| value | The current selected date | [moment](http://momentjs.com/) | current date |
+| validRange | to set valid range | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)] | - | 3.3.0 |
+| value | The current selected date | [moment](http://momentjs.com/) | current date |  |
 | onPanelChange | Callback for when panel changes | function(date: moment, mode: string) | - |  |
 | onSelect | Callback for when a date is selected | function(date: moment） | - |  |
-| onChange | Callback for when date changes | function(date: moment） | - |  |
+| onChange | Callback for when date changes | function(date: moment） | - | 3.8.0 |
 | headerRender | render custom header in panel | function(object:{value: moment, type: string, onChange: f(), onTypeChange: f()}) | - | 3.19.0 |

components/calendar/index.zh-CN.md

@@ -34,16 +34,16 @@ title: Calendar
 | --- | --- | --- | --- | --- |
 | dateCellRender | 自定义渲染日期单元格，返回内容会被追加到单元格 | function(date: moment): ReactNode | 无 |  |
 | dateFullCellRender | 自定义渲染日期单元格，返回内容覆盖单元格 | function(date: moment): ReactNode | 无 |  |
-| defaultValue | 默认展示的日期 | [moment](http://momentjs.com/) | 默认日期 |
+| defaultValue | 默认展示的日期 | [moment](http://momentjs.com/) | 默认日期 |  |
 | disabledDate | 不可选择的日期 | (currentDate: moment) => boolean | 无 |  |
 | fullscreen | 是否全屏显示 | boolean | true |  |
 | locale | 国际化配置 | object | [默认配置](https://github.com/ant-design/ant-design/blob/master/components/date-picker/locale/example.json) |  |
-| mode | 初始模式，`month/year` | string | month |
+| mode | 初始模式，`month/year` | string | month |  |
 | monthCellRender | 自定义渲染月单元格，返回内容会被追加到单元格 | function(date: moment): ReactNode | 无 |  |
 | monthFullCellRender | 自定义渲染月单元格，返回内容覆盖单元格 | function(date: moment): ReactNode | 无 |  |
-| validRange | 设置可以显示的日期 | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)] | 无 |  |
-| value | 展示日期 | [moment](http://momentjs.com/) | 当前日期 |
+| validRange | 设置可以显示的日期 | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)] | 无 | 3.3.0 |
+| value | 展示日期 | [moment](http://momentjs.com/) | 当前日期 |  |
 | onPanelChange | 日期面板变化回调 | function(date: moment, mode: string) | 无 |  |
 | onSelect | 点击选择日期回调 | function(date: moment） | 无 |  |
-| onChange | 日期变化回调 | function(date: moment） | 无 |  |
+| onChange | 日期变化回调 | function(date: moment） | 无 | 3.8.0 |
 | headerRender | 自定义头部内容 | function(object:{value: moment, type: string, onChange: f(), onTypeChange: f()}) | 无 | 3.19.0 |

components/card/index.en-US.md

@@ -19,37 +19,37 @@ A card can be used to display content related to a single subject. The content c
 
 ### Card
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| actions | The action list, shows at the bottom of the Card. | Array<ReactNode> | - |
-| activeTabKey | Current TabPane's key | string | - |
-| headStyle | Inline style to apply to the card head | object | - |
-| bodyStyle | Inline style to apply to the card content | object | - |
-| bordered | Toggles rendering of the border around the card | boolean | `true` |
-| cover | Card cover | ReactNode | - |
-| defaultActiveTabKey | Initial active TabPane's key, if `activeTabKey` is not set. | string | - |
-| extra | Content to render in the top-right corner of the card | string\|ReactNode | - |
-| hoverable | Lift up when hovering card | boolean | false |
-| loading | Shows a loading indicator while the contents of the card are being fetched | boolean | false |
-| tabList | List of TabPane's head. | Array<{key: string, tab: ReactNode}> | - |
-| size | Size of card | `default` \| `small` | `default` |
-| title | Card title | string\|ReactNode | - |
-| type | Card style type, can be set to `inner` or not set | string | - |
-| onTabChange | Callback when tab is switched | (key) => void | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| actions | The action list, shows at the bottom of the Card. | Array<ReactNode> | - |  |
+| activeTabKey | Current TabPane's key | string | - | 3.3.0 |
+| headStyle | Inline style to apply to the card head | object | - | 3.8.0 |
+| bodyStyle | Inline style to apply to the card content | object | - |  |
+| bordered | Toggles rendering of the border around the card | boolean | `true` |  |
+| cover | Card cover | ReactNode | - |  |
+| defaultActiveTabKey | Initial active TabPane's key, if `activeTabKey` is not set. | string | - | 3.3.0 |
+| extra | Content to render in the top-right corner of the card | string\|ReactNode | - |  |
+| hoverable | Lift up when hovering card | boolean | false |  |
+| loading | Shows a loading indicator while the contents of the card are being fetched | boolean | false |  |
+| tabList | List of TabPane's head. | Array<{key: string, tab: ReactNode}> | - |  |
+| size | Size of card | `default` \| `small` | `default` | 3.12.0 |
+| title | Card title | string\|ReactNode | - |  |
+| type | Card style type, can be set to `inner` or not set | string | - |  |
+| onTabChange | Callback when tab is switched | (key) => void | - |  |
 
 ### Card.Grid
 
-| Property  | Description               | Type   | Default |
-| --------- | ------------------------- | ------ | ------- |
-| className | className of container    | string | -       |
-| style     | style object of container | object | -       |
+| Property  | Description               | Type   | Default | Version |
+| --------- | ------------------------- | ------ | ------- | ------- |
+| className | className of container    | string | -       |         |
+| style     | style object of container | object | -       |         |
 
 ### Card.Meta
 
-| Property    | Description               | Type      | Default |
-| ----------- | ------------------------- | --------- | ------- |
-| avatar      | avatar or icon            | ReactNode | -       |
-| className   | className of container    | string    | -       |
-| description | description content       | ReactNode | -       |
-| style       | style object of container | object    | -       |
-| title       | title content             | ReactNode | -       |
+| Property    | Description               | Type      | Default | Version |
+| ----------- | ------------------------- | --------- | ------- | ------- |
+| avatar      | avatar or icon            | ReactNode | -       |         |
+| className   | className of container    | string    | -       |         |
+| description | description content       | ReactNode | -       |         |
+| style       | style object of container | object    | -       |         |
+| title       | title content             | ReactNode | -       |         |

components/card/index.zh-CN.md

@@ -20,37 +20,37 @@ cols: 1
 
 ### Card
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| actions | 卡片操作组，位置在卡片底部 | Array<ReactNode> | - |
-| activeTabKey | 当前激活页签的 key | string | - |
-| headStyle | 自定义标题区域样式 | object | - |
-| bodyStyle | 内容区域自定义样式 | object | - |
-| bordered | 是否有边框 | boolean | true |
-| cover | 卡片封面 | ReactNode | - |
-| defaultActiveTabKey | 初始化选中页签的 key，如果没有设置 activeTabKey | string | 第一个页签 |
-| extra | 卡片右上角的操作区域 | string\|ReactNode | - |
-| hoverable | 鼠标移过时可浮起 | boolean | false |
-| loading | 当卡片内容还在加载中时，可以用 loading 展示一个占位 | boolean | false |
-| tabList | 页签标题列表 | Array<{key: string, tab: ReactNode}> | - |
-| size | card 的尺寸 | `default` \| `small` | `default` |
-| title | 卡片标题 | string\|ReactNode | - |
-| type | 卡片类型，可设置为 `inner` 或 不设置 | string | - |
-| onTabChange | 页签切换的回调 | (key) => void | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| actions | 卡片操作组，位置在卡片底部 | Array<ReactNode> | - |  |
+| activeTabKey | 当前激活页签的 key | string | - | 3.3.0 |
+| headStyle | 自定义标题区域样式 | object | - | 3.8.0 |
+| bodyStyle | 内容区域自定义样式 | object | - |  |
+| bordered | 是否有边框 | boolean | true |  |
+| cover | 卡片封面 | ReactNode | - |  |
+| defaultActiveTabKey | 初始化选中页签的 key，如果没有设置 activeTabKey | string | 第一个页签 | 3.3.0 |
+| extra | 卡片右上角的操作区域 | string\|ReactNode | - |  |
+| hoverable | 鼠标移过时可浮起 | boolean | false |  |
+| loading | 当卡片内容还在加载中时，可以用 loading 展示一个占位 | boolean | false |  |
+| tabList | 页签标题列表 | Array<{key: string, tab: ReactNode}> | - |  |
+| size | card 的尺寸 | `default` \| `small` | `default` | 3.12.0 |
+| title | 卡片标题 | string\|ReactNode | - |  |
+| type | 卡片类型，可设置为 `inner` 或 不设置 | string | - |  |
+| onTabChange | 页签切换的回调 | (key) => void | - |  |
 
 ### Card.Grid
 
-| Property  | Description            | Type   | Default |
-| --------- | ---------------------- | ------ | ------- |
-| className | 网格容器类名           | string | -       |
-| style     | 定义网格容器类名的样式 | object | -       |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --------- | ---------------------- | ------ | ------- | ---- |
+| className | 网格容器类名           | string | -       |      |
+| style     | 定义网格容器类名的样式 | object | -       |      |
 
 ### Card.Meta
 
-| Property    | Description        | Type      | Default |
-| ----------- | ------------------ | --------- | ------- |
-| avatar      | 头像/图标          | ReactNode | -       |
-| className   | 容器类名           | string    | -       |
-| description | 描述内容           | ReactNode | -       |
-| style       | 定义容器类名的样式 | object    | -       |
-| title       | 标题内容           | ReactNode | -       |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| ----------- | ------------------ | --------- | ------- | ---- |
+| avatar      | 头像/图标          | ReactNode | -       |      |
+| className   | 容器类名           | string    | -       |      |
+| description | 描述内容           | ReactNode | -       |      |
+| style       | 定义容器类名的样式 | object    | -       |      |
+| title       | 标题内容           | ReactNode | -       |      |

components/card/style/index.less

@@ -139,7 +139,7 @@
 
       & > span {
         position: relative;
-        display: inline-block;
+        display: block;
         min-width: 32px;
         font-size: 14px;
         line-height: 22px;
@@ -155,7 +155,8 @@
           line-height: 22px;
         }
 
-        a {
+        a,
+        i {
           display: inline-block;
           width: 100%;
           color: @text-color-secondary;
@@ -163,6 +164,7 @@
 
           &:hover {
             color: @primary-color;
+            transition: color 0.3s;
           }
         }
       }

components/carousel/index.en-US.md

@@ -26,10 +26,10 @@ A carousel component. Scales with its container.
 
 ## Methods
 
-| Name | Description |
-| --- | --- |
-| goTo(slideNumber, dontAnimate) | Go to slide index, if dontAnimate=true, it happens without animation |
-| next() | Change current slide to next slide |
-| prev() | Change current slide to previous slide |
+| Name | Description | Version |
+| --- | --- | --- |
+| goTo(slideNumber, dontAnimate) | Go to slide index, if dontAnimate=true, it happens without animation | 3.9.3 |
+| next() | Change current slide to next slide |  |
+| prev() | Change current slide to previous slide |  |
 
 For more info on the parameters, refer to the <https://github.com/akiran/react-slick>

components/carousel/index.zh-CN.md

@@ -17,20 +17,20 @@ subtitle: 走马灯
 
 | 参数 | 说明 | 类型 | 默认值 | 版本 |
 | --- | --- | --- | --- | --- |
-| afterChange | 切换面板的回调 | function(current) | 无 |  |
-| autoplay | 是否自动切换 | boolean | false |  |
-| beforeChange | 切换面板的回调 | function(from, to) | 无 |  |
-| dotPosition | 面板指示点位置，可选 `top` `bottom` `left` `right` | string | bottom | 3.17.0 |
-| dots | 是否显示面板指示点 | boolean | true |  |
-| easing | 动画效果 | string | linear |  |
-| effect | 动画效果函数，可取 scrollx, fade | string | scrollx |  |
+| afterChange | 切换面板的回调 | function(current) | 无 |  |  |
+| autoplay | 是否自动切换 | boolean | false |  |  |
+| beforeChange | 切换面板的回调 | function(from, to) | 无 |  |  |
+| dotPosition | 面板指示点位置，可选 `top` `bottom` `left` `right` | string | bottom | 3.17.0 | 3.17.0 |
+| dots | 是否显示面板指示点 | boolean | true |  |  |
+| easing | 动画效果 | string | linear |  |  |
+| effect | 动画效果函数，可取 scrollx, fade | string | scrollx |  |  |
 
 ## 方法
 
 | 名称                           | 描述                                              |
 | ------------------------------ | ------------------------------------------------- |
-| goTo(slideNumber, dontAnimate) | 切换到指定面板, dontAnimate = true 时，不使用动画 |
-| next()                         | 切换到下一面板                                    |
-| prev()                         | 切换到上一面板                                    |
+| goTo(slideNumber, dontAnimate) | 切换到指定面板, dontAnimate = true 时，不使用动画 | 3.9.3 |
+| next()                         | 切换到下一面板                                    |  |
+| prev()                         | 切换到上一面板                                    |  |
 
 更多参数可参考：<https://github.com/akiran/react-slick>

components/cascader/__tests__/__snapshots__/index.test.js.snap

@@ -1256,6 +1256,299 @@ exports[`Cascader should render not found content 1`] = `
 </Popup>
 `;
 
+exports[`Cascader should show not found content when options.length is 0 1`] = `
+<Popup
+  action={
+    Array [
+      "click",
+    ]
+  }
+  align={
+    Object {
+      "offset": Array [
+        0,
+        4,
+      ],
+      "overflow": Object {
+        "adjustX": 1,
+        "adjustY": 1,
+      },
+      "points": Array [
+        "tl",
+        "bl",
+      ],
+    }
+  }
+  className=""
+  destroyPopupOnHide={false}
+  getClassNameFromAlign={[Function]}
+  getRootDomNode={[Function]}
+  mask={false}
+  onAlign={[Function]}
+  onMouseDown={[Function]}
+  onTouchStart={[Function]}
+  prefixCls="ant-cascader-menus"
+  style={Object {}}
+  transitionName="slide-up"
+  visible={true}
+>
+  <div>
+    <Animate
+      animation={Object {}}
+      component=""
+      componentProps={Object {}}
+      exclusive={true}
+      onAppear={[Function]}
+      onEnd={[Function]}
+      onEnter={[Function]}
+      onLeave={[Function]}
+      showProp="xVisible"
+      transitionAppear={true}
+      transitionEnter={true}
+      transitionLeave={true}
+      transitionName="slide-up"
+    >
+      <AnimateChild
+        animation={Object {}}
+        key="popup"
+        transitionAppear={true}
+        transitionEnter={true}
+        transitionLeave={true}
+        transitionName="slide-up"
+      >
+        <Align
+          align={
+            Object {
+              "offset": Array [
+                0,
+                4,
+              ],
+              "overflow": Object {
+                "adjustX": 1,
+                "adjustY": 1,
+              },
+              "points": Array [
+                "tl",
+                "bl",
+              ],
+            }
+          }
+          childrenProps={
+            Object {
+              "visible": "xVisible",
+            }
+          }
+          disabled={false}
+          key="popup"
+          monitorBufferTime={50}
+          monitorWindowResize={true}
+          onAlign={[Function]}
+          target={[Function]}
+          xVisible={true}
+        >
+          <PopupInner
+            className="ant-cascader-menus  ant-cascader-menus-placement-bottomLeft "
+            hiddenClassName="ant-cascader-menus-hidden"
+            onMouseDown={[Function]}
+            onTouchStart={[Function]}
+            prefixCls="ant-cascader-menus"
+            style={Object {}}
+            visible={true}
+          >
+            <div
+              className="ant-cascader-menus  ant-cascader-menus-placement-bottomLeft "
+              onMouseDown={[Function]}
+              onTouchStart={[Function]}
+              style={Object {}}
+            >
+              <LazyRenderBox
+                className="ant-cascader-menus-content"
+                visible={true}
+              >
+                <Menus
+                  activeValue={Array []}
+                  allowClear={true}
+                  builtinPlacements={
+                    Object {
+                      "bottomLeft": Object {
+                        "offset": Array [
+                          0,
+                          4,
+                        ],
+                        "overflow": Object {
+                          "adjustX": 1,
+                          "adjustY": 1,
+                        },
+                        "points": Array [
+                          "tl",
+                          "bl",
+                        ],
+                      },
+                      "bottomRight": Object {
+                        "offset": Array [
+                          0,
+                          4,
+                        ],
+                        "overflow": Object {
+                          "adjustX": 1,
+                          "adjustY": 1,
+                        },
+                        "points": Array [
+                          "tr",
+                          "br",
+                        ],
+                      },
+                      "topLeft": Object {
+                        "offset": Array [
+                          0,
+                          -4,
+                        ],
+                        "overflow": Object {
+                          "adjustX": 1,
+                          "adjustY": 1,
+                        },
+                        "points": Array [
+                          "bl",
+                          "tl",
+                        ],
+                      },
+                      "topRight": Object {
+                        "offset": Array [
+                          0,
+                          -4,
+                        ],
+                        "overflow": Object {
+                          "adjustX": 1,
+                          "adjustY": 1,
+                        },
+                        "points": Array [
+                          "br",
+                          "tr",
+                        ],
+                      },
+                    }
+                  }
+                  defaultFieldNames={
+                    Object {
+                      "children": "children",
+                      "label": "label",
+                      "value": "value",
+                    }
+                  }
+                  disabled={false}
+                  dropdownMenuColumnStyle={
+                    Object {
+                      "height": "auto",
+                      "width": 0,
+                    }
+                  }
+                  expandIcon={
+                    <Icon
+                      type="right"
+                    />
+                  }
+                  expandTrigger="click"
+                  fieldNames={
+                    Object {
+                      "children": "children",
+                      "label": "label",
+                      "value": "value",
+                    }
+                  }
+                  loadingIcon={
+                    <span
+                      className="ant-cascader-menu-item-loading-icon"
+                    >
+                      <Icon
+                        spin={true}
+                        type="redo"
+                      />
+                    </span>
+                  }
+                  onChange={[Function]}
+                  onItemDoubleClick={[Function]}
+                  onPopupVisibleChange={[Function]}
+                  onSelect={[Function]}
+                  options={
+                    Array [
+                      Object {
+                        "disabled": true,
+                        "label": <Context.Consumer>
+                          [Function]
+                        </Context.Consumer>,
+                        "value": "ANT_CASCADER_NOT_FOUND",
+                      },
+                    ]
+                  }
+                  placeholder="Please select"
+                  popupClassName=""
+                  popupPlacement="bottomLeft"
+                  popupVisible={true}
+                  prefixCls="ant-cascader"
+                  transitionName="slide-up"
+                  value={Array []}
+                  visible={true}
+                >
+                  <div>
+                    <ul
+                      className="ant-cascader-menu"
+                      key="0"
+                      style={
+                        Object {
+                          "height": "auto",
+                          "width": 0,
+                        }
+                      }
+                    >
+                      <li
+                        className="ant-cascader-menu-item ant-cascader-menu-item-disabled"
+                        key="ANT_CASCADER_NOT_FOUND"
+                        onClick={[Function]}
+                        onDoubleClick={[Function]}
+                        onMouseDown={[Function]}
+                        role="menuitem"
+                        title=""
+                      >
+                        <OriginEmpty
+                          className="ant-empty-small"
+                          image="data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNjQiIGhlaWdodD0iNDEiIHZpZXdCb3g9IjAgMCA2NCA0MSIgIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CiAgPGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMCAxKSIgZmlsbD0ibm9uZSIgZmlsbC1ydWxlPSJldmVub2RkIj4KICAgIDxlbGxpcHNlIGZpbGw9IiNGNUY1RjUiIGN4PSIzMiIgY3k9IjMzIiByeD0iMzIiIHJ5PSI3Ii8+CiAgICA8ZyBmaWxsLXJ1bGU9Im5vbnplcm8iIHN0cm9rZT0iI0Q5RDlEOSI+CiAgICAgIDxwYXRoIGQ9Ik01NSAxMi43Nkw0NC44NTQgMS4yNThDNDQuMzY3LjQ3NCA0My42NTYgMCA0Mi45MDcgMEgyMS4wOTNjLS43NDkgMC0xLjQ2LjQ3NC0xLjk0NyAxLjI1N0w5IDEyLjc2MVYyMmg0NnYtOS4yNHoiLz4KICAgICAgPHBhdGggZD0iTTQxLjYxMyAxNS45MzFjMC0xLjYwNS45OTQtMi45MyAyLjIyNy0yLjkzMUg1NXYxOC4xMzdDNTUgMzMuMjYgNTMuNjggMzUgNTIuMDUgMzVoLTQwLjFDMTAuMzIgMzUgOSAzMy4yNTkgOSAzMS4xMzdWMTNoMTEuMTZjMS4yMzMgMCAyLjIyNyAxLjMyMyAyLjIyNyAyLjkyOHYuMDIyYzAgMS42MDUgMS4wMDUgMi45MDEgMi4yMzcgMi45MDFoMTQuNzUyYzEuMjMyIDAgMi4yMzctMS4zMDggMi4yMzctMi45MTN2LS4wMDd6IiBmaWxsPSIjRkFGQUZBIi8+CiAgICA8L2c+CiAgPC9nPgo8L3N2Zz4K"
+                        >
+                          <LocaleReceiver
+                            componentName="Empty"
+                          >
+                            <div
+                              className="ant-empty ant-empty-normal ant-empty-small"
+                            >
+                              <div
+                                className="ant-empty-image"
+                              >
+                                <img
+                                  alt="No Data"
+                                  src="data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNjQiIGhlaWdodD0iNDEiIHZpZXdCb3g9IjAgMCA2NCA0MSIgIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CiAgPGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMCAxKSIgZmlsbD0ibm9uZSIgZmlsbC1ydWxlPSJldmVub2RkIj4KICAgIDxlbGxpcHNlIGZpbGw9IiNGNUY1RjUiIGN4PSIzMiIgY3k9IjMzIiByeD0iMzIiIHJ5PSI3Ii8+CiAgICA8ZyBmaWxsLXJ1bGU9Im5vbnplcm8iIHN0cm9rZT0iI0Q5RDlEOSI+CiAgICAgIDxwYXRoIGQ9Ik01NSAxMi43Nkw0NC44NTQgMS4yNThDNDQuMzY3LjQ3NCA0My42NTYgMCA0Mi45MDcgMEgyMS4wOTNjLS43NDkgMC0xLjQ2LjQ3NC0xLjk0NyAxLjI1N0w5IDEyLjc2MVYyMmg0NnYtOS4yNHoiLz4KICAgICAgPHBhdGggZD0iTTQxLjYxMyAxNS45MzFjMC0xLjYwNS45OTQtMi45MyAyLjIyNy0yLjkzMUg1NXYxOC4xMzdDNTUgMzMuMjYgNTMuNjggMzUgNTIuMDUgMzVoLTQwLjFDMTAuMzIgMzUgOSAzMy4yNTkgOSAzMS4xMzdWMTNoMTEuMTZjMS4yMzMgMCAyLjIyNyAxLjMyMyAyLjIyNyAyLjkyOHYuMDIyYzAgMS42MDUgMS4wMDUgMi45MDEgMi4yMzcgMi45MDFoMTQuNzUyYzEuMjMyIDAgMi4yMzctMS4zMDggMi4yMzctMi45MTN2LS4wMDd6IiBmaWxsPSIjRkFGQUZBIi8+CiAgICA8L2c+CiAgPC9nPgo8L3N2Zz4K"
+                                />
+                              </div>
+                              <p
+                                className="ant-empty-description"
+                              >
+                                No Data
+                              </p>
+                            </div>
+                          </LocaleReceiver>
+                        </OriginEmpty>
+                      </li>
+                    </ul>
+                  </div>
+                </Menus>
+              </LazyRenderBox>
+            </div>
+          </PopupInner>
+        </Align>
+      </AnimateChild>
+    </Animate>
+  </div>
+</Popup>
+`;
+
 exports[`Cascader support controlled mode 1`] = `
 <span
   class="ant-cascader-picker"

components/cascader/__tests__/index.test.js

@@ -398,6 +398,19 @@ describe('Cascader', () => {
     errorSpy.mockReset();
   });
 
+  it('should show not found content when options.length is 0', () => {
+    const customerOptions = [];
+    const wrapper = mount(<Cascader options={customerOptions} />);
+    wrapper.find('input').simulate('click');
+    const popupWrapper = mount(
+      wrapper
+        .find('Trigger')
+        .instance()
+        .getComponent(),
+    );
+    expect(popupWrapper).toMatchSnapshot();
+  });
+
   describe('limit filtered item count', () => {
     const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
 
@@ -429,4 +442,33 @@ describe('Cascader', () => {
       );
     });
   });
+
+  it('should warning if not find `value` in `options`', () => {
+    const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
+    mount(<Cascader options={[{ label: 'a', value: 'a', children: [{ label: 'b' }] }]} />);
+    expect(errorSpy).toHaveBeenCalledWith(
+      'Warning: [antd: Cascader] Not found `value` in `options`.',
+    );
+    errorSpy.mockRestore();
+  });
+
+  // https://github.com/ant-design/ant-design/issues/17690
+  it('should not breaks when children is null', () => {
+    const optionsWithChildrenNull = [
+      {
+        value: 'zhejiang',
+        label: 'Zhejiang',
+        children: [
+          {
+            value: 'hangzhou',
+            label: 'Hangzhou',
+            children: null,
+          },
+        ],
+      },
+    ];
+    expect(() => {
+      mount(<Cascader options={optionsWithChildrenNull} />);
+    }).not.toThrow();
+  });
 });

components/cascader/index.en-US.md

@@ -14,53 +14,64 @@ Cascade selection box.
 
 ## API
 
-```html
-<Cascader options="{options}" onChange="{onChange}" />
+```jsx
+<Cascader options={options} onChange={onChange} />
 ```
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| allowClear | whether allow clear | boolean | true |
-| autoFocus | get focus when component mounted | boolean | false |
-| changeOnSelect | change value on each selection if set to true, see above demo for details | boolean | false |
-| className | additional css class | string | - |
-| defaultValue | initial selected value | string\[] | \[] |
-| disabled | whether disabled select | boolean | false |
-| displayRender | render function of displaying selected options | `(label, selectedOptions) => ReactNode` | `label => label.join(' / ')` |
-| expandTrigger | expand current item when click or hover, one of 'click' 'hover' | string | 'click' |
-| fieldNames | custom field name for label and value and children (before 3.7.0 it calls `filedNames` which is typo）) | object | `{ label: 'label', value: 'value', children: 'children' }` |
-| getPopupContainer | Parent Node which the selector should be rendered to. Default to `body`. When position issues happen, try to modify it into scrollable content and position it relative.[example](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | () => document.body |
-| loadData | To load option lazily, and it cannot work with `showSearch` | `(selectedOptions) => void` | - |
-| notFoundContent | Specify content to show when no result matches. | string | 'Not Found' |
-| options | data options of cascade | object | - |
-| placeholder | input placeholder | string | 'Please select' |
-| popupClassName | additional className of popup overlay | string | - |
-| popupPlacement | use preset popup align config from builtinPlacements：`bottomLeft` `bottomRight` `topLeft` `topRight` | string | `bottomLeft` |
-| popupVisible | set visible of cascader popup | boolean | - |
-| showSearch | Whether show search input in single mode. | boolean\|object | false |
-| size | input size, one of `large` `default` `small` | string | `default` |
-| style | additional style | string | - |
-| suffixIcon | The custom suffix icon | ReactNode | - |
-| value | selected value | string\[] | - |
-| onChange | callback when finishing cascader select | `(value, selectedOptions) => void` | - |
-| onPopupVisibleChange | callback when popup shown or hidden | `(value) => void` | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| allowClear | whether allow clear | boolean | true |  |
+| autoFocus | get focus when component mounted | boolean | false |  |
+| changeOnSelect | change value on each selection if set to true, see above demo for details | boolean | false |  |
+| className | additional css class | string | - |  |
+| defaultValue | initial selected value | string\[] | \[] |  |
+| disabled | whether disabled select | boolean | false |  |
+| displayRender | render function of displaying selected options | `(label, selectedOptions) => ReactNode` | `label => label.join(' / ')` |  |
+| expandTrigger | expand current item when click or hover, one of 'click' 'hover' | string | 'click' |  |
+| fieldNames | custom field name for label and value and children (before 3.7.0 it calls `filedNames` which is typo）) | object | `{ label: 'label', value: 'value', children: 'children' }` | 3.7.0 |
+| getPopupContainer | Parent Node which the selector should be rendered to. Default to `body`. When position issues happen, try to modify it into scrollable content and position it relative.[example](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | () => document.body |  |
+| loadData | To load option lazily, and it cannot work with `showSearch` | `(selectedOptions) => void` | - |  |
+| notFoundContent | Specify content to show when no result matches. | string | 'Not Found' |  |
+| options | data options of cascade | [Option](#Option)[] | - |  |
+| placeholder | input placeholder | string | 'Please select' |  |
+| popupClassName | additional className of popup overlay | string | - |  |
+| popupPlacement | use preset popup align config from builtinPlacements：`bottomLeft` `bottomRight` `topLeft` `topRight` | string | `bottomLeft` |  |
+| popupVisible | set visible of cascader popup | boolean | - |  |
+| showSearch | Whether show search input in single mode. | boolean\|object | false |  |
+| size | input size, one of `large` `default` `small` | string | `default` |  |
+| style | additional style | string | - |  |
+| suffixIcon | The custom suffix icon | ReactNode | - | 3.10.0 |
+| value | selected value | string\[] | - |  |
+| onChange | callback when finishing cascader select | `(value, selectedOptions) => void` | - |  |
+| onPopupVisibleChange | callback when popup shown or hidden | `(value) => void` | - |  |
 
 Fields in `showSearch`:
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| filter | The function will receive two arguments, inputValue and option, if the function returns true, the option will be included in the filtered set; Otherwise, it will be excluded. | `function(inputValue, path): boolean` |  |
-| limit | Set the count of filtered items | number \| false | 50 |
-| matchInputWidth | Whether the width of result list equals to input's | boolean |  |
-| render | Used to render filtered options. | `function(inputValue, path): ReactNode` |  |
-| sort | Used to sort filtered options. | `function(a, b, inputValue)` |  |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| filter | The function will receive two arguments, inputValue and option, if the function returns true, the option will be included in the filtered set; Otherwise, it will be excluded. | `function(inputValue, path): boolean` |  |  |
+| limit | Set the count of filtered items | number \| false | 50 | 3.11.0 |
+| matchInputWidth | Whether the width of result list equals to input's | boolean |  |  |
+| render | Used to render filtered options. | `function(inputValue, path): ReactNode` |  |  |
+| sort | Used to sort filtered options. | `function(a, b, inputValue)` |  |  |
+
+### Option
+
+```typescript
+interface Option {
+  value: string;
+  label?: React.ReactNode;
+  disabled?: boolean;
+  children?: Option[];
+}
+```
 
 ## Methods
 
-| Name    | Description  |
-| ------- | ------------ |
-| blur()  | remove focus |
-| focus() | get focus    |
+| Name    | Description  | Version |
+| ------- | ------------ | ------- |
+| blur()  | remove focus |         |
+| focus() | get focus    |         |
 
 <style>
 .ant-cascader-picker {

components/cascader/index.tsx

@@ -15,6 +15,8 @@ export interface CascaderOptionType {
   value?: string;
   label?: React.ReactNode;
   disabled?: boolean;
+  isLeaf?: boolean;
+  loading?: boolean;
   children?: Array<CascaderOptionType>;
   [key: string]: any;
 }
@@ -204,6 +206,14 @@ function flattenTree(
 
 const defaultDisplayRender = (label: string[]) => label.join(' / ');
 
+function warningValueNotExist(list: CascaderOptionType[], fieldNames: FieldNamesType = {}) {
+  (list || []).forEach(item => {
+    const valueFieldName = fieldNames.value || 'value';
+    warning(valueFieldName in item, 'Cascader', 'Not found `value` in `options`.');
+    warningValueNotExist(item[fieldNames.children || 'children'], fieldNames);
+  });
+}
+
 class Cascader extends React.Component<CascaderProps, CascaderState> {
   static defaultProps = {
     placeholder: 'Please select',
@@ -229,6 +239,10 @@ class Cascader extends React.Component<CascaderProps, CascaderState> {
       newState.flattenOptions = flattenTree(nextProps.options, nextProps);
     }
 
+    if (process.env.NODE_ENV !== 'production' && nextProps.options) {
+      warningValueNotExist(nextProps.options, getFieldNames(nextProps));
+    }
+
     return newState;
   }
 
@@ -424,6 +438,7 @@ class Cascader extends React.Component<CascaderProps, CascaderState> {
       allowClear,
       showSearch = false,
       suffixIcon,
+      notFoundContent,
       ...otherProps
     } = props;
 
@@ -481,8 +496,19 @@ class Cascader extends React.Component<CascaderProps, CascaderState> {
     ]);
 
     let options = props.options;
-    if (state.inputValue) {
-      options = this.generateFilteredOptions(prefixCls, renderEmpty);
+    if (options.length > 0) {
+      if (state.inputValue) {
+        options = this.generateFilteredOptions(prefixCls, renderEmpty);
+      }
+    } else {
+      const names: FilledFieldNamesType = getFilledFieldNames(this.props);
+      options = [
+        {
+          [names.label]: notFoundContent || renderEmpty('Cascader'),
+          [names.value]: 'ANT_CASCADER_NOT_FOUND',
+          disabled: true,
+        },
+      ];
     }
     // Dropdown menu should keep previous status until it is fully closed.
     if (!state.popupVisible) {
@@ -500,7 +526,7 @@ class Cascader extends React.Component<CascaderProps, CascaderState> {
     // The default value of `matchInputWidth` is `true`
     const resultListMatchInputWidth =
       (showSearch as ShowSearchType).matchInputWidth === false ? false : true;
-    if (resultListMatchInputWidth && state.inputValue && this.input) {
+    if (resultListMatchInputWidth && (state.inputValue || isNotFound) && this.input) {
       dropdownMenuColumnStyle.width = this.input.input.offsetWidth;
     }
 

components/cascader/index.zh-CN.md

@@ -15,53 +15,64 @@ subtitle: 级联选择
 
 ## API
 
-```html
-<Cascader options="{options}" onChange="{onChange}" />
+```jsx
+<Cascader options={options} onChange={onChange} />
 ```
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| allowClear | 是否支持清除 | boolean | true |
-| autoFocus | 自动获取焦点 | boolean | false |
-| changeOnSelect | 当此项为 true 时，点选每级菜单选项值都会发生变化，具体见上面的演示 | boolean | false |
-| className | 自定义类名 | string | - |
-| defaultValue | 默认的选中项 | string\[] | \[] |
-| disabled | 禁用 | boolean | false |
-| displayRender | 选择后展示的渲染函数 | `(label, selectedOptions) => ReactNode` | `label => label.join(' / ')` |
-| expandTrigger | 次级菜单的展开方式，可选 'click' 和 'hover' | string | 'click' |
-| fieldNames | 自定义 options 中 label name children 的字段（注意，3.7.0 之前的版本为 `filedNames`） | object | `{ label: 'label', value: 'value', children: 'children' }` |
-| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | () => document.body |
-| loadData | 用于动态加载选项，无法与 `showSearch` 一起使用 | `(selectedOptions) => void` | - |
-| notFoundContent | 当下拉列表为空时显示的内容 | string | 'Not Found' |
-| options | 可选项数据源 | object | - |
-| placeholder | 输入框占位文本 | string | '请选择' |
-| popupClassName | 自定义浮层类名 | string | - |
-| popupPlacement | 浮层预设位置：`bottomLeft` `bottomRight` `topLeft` `topRight` | Enum | `bottomLeft` |
-| popupVisible | 控制浮层显隐 | boolean | - |
-| showSearch | 在选择框中显示搜索框 | boolean | false |
-| size | 输入框大小，可选 `large` `default` `small` | string | `default` |
-| style | 自定义样式 | string | - |
-| suffixIcon | 自定义的选择框后缀图标 | ReactNode | - |
-| value | 指定选中项 | string\[] | - |
-| onChange | 选择完成后的回调 | `(value, selectedOptions) => void` | - |
-| onPopupVisibleChange | 显示/隐藏浮层的回调 | `(value) => void` | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| allowClear | 是否支持清除 | boolean | true |  |
+| autoFocus | 自动获取焦点 | boolean | false |  |
+| changeOnSelect | 当此项为 true 时，点选每级菜单选项值都会发生变化，具体见上面的演示 | boolean | false |  |
+| className | 自定义类名 | string | - |  |
+| defaultValue | 默认的选中项 | string\[] | \[] |  |
+| disabled | 禁用 | boolean | false |  |
+| displayRender | 选择后展示的渲染函数 | `(label, selectedOptions) => ReactNode` | `label => label.join(' / ')` |  |
+| expandTrigger | 次级菜单的展开方式，可选 'click' 和 'hover' | string | 'click' |  |
+| fieldNames | 自定义 options 中 label name children 的字段（注意，3.7.0 之前的版本为 `filedNames`） | object | `{ label: 'label', value: 'value', children: 'children' }` | 3.7.0 |
+| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | () => document.body |  |
+| loadData | 用于动态加载选项，无法与 `showSearch` 一起使用 | `(selectedOptions) => void` | - |  |
+| notFoundContent | 当下拉列表为空时显示的内容 | string | 'Not Found' |  |
+| options | 可选项数据源 | [Option](#Option)[] | - |  |
+| placeholder | 输入框占位文本 | string | '请选择' |  |
+| popupClassName | 自定义浮层类名 | string | - |  |
+| popupPlacement | 浮层预设位置：`bottomLeft` `bottomRight` `topLeft` `topRight` | Enum | `bottomLeft` |  |
+| popupVisible | 控制浮层显隐 | boolean | - |  |
+| showSearch | 在选择框中显示搜索框 | boolean | false |  |
+| size | 输入框大小，可选 `large` `default` `small` | string | `default` |  |
+| style | 自定义样式 | string | - |  |
+| suffixIcon | 自定义的选择框后缀图标 | ReactNode | - | 3.10.0 |
+| value | 指定选中项 | string\[] | - |  |
+| onChange | 选择完成后的回调 | `(value, selectedOptions) => void` | - |  |
+| onPopupVisibleChange | 显示/隐藏浮层的回调 | `(value) => void` | - |  |
 
 `showSearch` 为对象时，其中的字段：
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| filter | 接收 `inputValue` `path` 两个参数，当 `path` 符合筛选条件时，应返回 true，反之则返回 false。 | `function(inputValue, path): boolean` |  |
-| limit | 搜索结果展示数量 | number \| false | 50 |
-| matchInputWidth | 搜索结果列表是否与输入框同宽 | boolean |  |
-| render | 用于渲染 filter 后的选项 | `function(inputValue, path): ReactNode` |  |
-| sort | 用于排序 filter 后的选项 | `function(a, b, inputValue)` |  |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| filter | 接收 `inputValue` `path` 两个参数，当 `path` 符合筛选条件时，应返回 true，反之则返回 false。 | `function(inputValue, path): boolean` |  |  |
+| limit | 搜索结果展示数量 | number \| false | 50 | 3.11.0 |
+| matchInputWidth | 搜索结果列表是否与输入框同宽 | boolean |  |  |
+| render | 用于渲染 filter 后的选项 | `function(inputValue, path): ReactNode` |  |  |
+| sort | 用于排序 filter 后的选项 | `function(a, b, inputValue)` |  |  |
+
+### Option
+
+```typescript
+interface Option {
+  value: string;
+  label?: React.ReactNode;
+  disabled?: boolean;
+  children?: Option[];
+}
+```
 
 ## 方法
 
-| 名称    | 描述     |
-| ------- | -------- |
-| blur()  | 移除焦点 |
-| focus() | 获取焦点 |
+| 名称    | 描述     | 版本 |
+| ------- | -------- | ---- |
+| blur()  | 移除焦点 |      |
+| focus() | 获取焦点 |      |
 
 <style>
 .ant-cascader-picker {

components/cascader/style/index.less

@@ -11,6 +11,8 @@
     // Keep it static for https://github.com/ant-design/ant-design/issues/16738
     position: static;
     width: 100%;
+    // https://github.com/ant-design/ant-design/issues/17582
+    padding-right: 24px;
     // Add important to fix https://github.com/ant-design/ant-design/issues/5078
     // because input.less will compile after cascader.less
     background-color: transparent !important;
@@ -60,7 +62,7 @@
       width: 100%;
       height: 20px;
       margin-top: -10px;
-      padding: 0 @control-padding-horizontal;
+      padding: 0 20px 0 @control-padding-horizontal;
       overflow: hidden;
       line-height: 20px;
       white-space: nowrap;
@@ -211,7 +213,7 @@
     }
 
     &-expand &-expand-icon,
-    &-expand &-loading-icon {
+    &-loading-icon {
       .iconfont-size-under-12px(10px);
 
       position: absolute;

components/checkbox/index.en-US.md

@@ -17,31 +17,31 @@ Checkbox component.
 
 #### Checkbox
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| autoFocus | get focus when component mounted | boolean | false |
-| checked | Specifies whether the checkbox is selected. | boolean | false |
-| defaultChecked | Specifies the initial state: whether or not the checkbox is selected. | boolean | false |
-| disabled | Disable checkbox | boolean | false |
-| indeterminate | indeterminate checked state of checkbox | boolean | false |
-| onChange | The callback function that is triggered when the state changes. | Function(e:Event) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| autoFocus | get focus when component mounted | boolean | false | 3.6.2 |
+| checked | Specifies whether the checkbox is selected. | boolean | false | 3.6.2 |
+| defaultChecked | Specifies the initial state: whether or not the checkbox is selected. | boolean | false | 3.6.2 |
+| disabled | Disable checkbox | boolean | false | 3.6.2 |
+| indeterminate | indeterminate checked state of checkbox | boolean | false | 3.6.2 |
+| onChange | The callback function that is triggered when the state changes. | Function(e:Event) | - | 3.6.2 |
 
 #### Checkbox Group
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| defaultValue | Default selected value | string\[] | \[] |
-| disabled | Disable all checkboxes | boolean | false |
-| name | The `name` property of all `input[type="checkbox"]` children | string | - |
-| options | Specifies options | string\[] | \[] |
-| value | Used for setting the currently selected value. | string\[] | \[] |
-| onChange | The callback function that is triggered when the state changes. | Function(checkedValue) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| defaultValue | Default selected value | string\[] | \[] | 3.6.2 |
+| disabled | Disable all checkboxes | boolean | false | 3.6.2 |
+| name | The `name` property of all `input[type="checkbox"]` children | string | - | 3.16.0 |
+| options | Specifies options | string\[] | \[] | 3.6.2 |
+| value | Used for setting the currently selected value. | string\[] | \[] | 3.6.2 |
+| onChange | The callback function that is triggered when the state changes. | Function(checkedValue) | - | 3.6.2 |
 
 ### Methods
 
 #### Checkbox
 
-| Name    | Description  |
-| ------- | ------------ |
-| blur()  | remove focus |
-| focus() | get focus    |
+| Name    | Description  | Version |
+| ------- | ------------ | ------- |
+| blur()  | remove focus | 3.6.2   |
+| focus() | get focus    | 3.6.2   |

components/checkbox/index.zh-CN.md

@@ -18,31 +18,31 @@ title: Checkbox
 
 #### Checkbox
 
-| 参数           | 说明                                    | 类型              | 默认值 |
-| -------------- | --------------------------------------- | ----------------- | ------ |
-| autoFocus      | 自动获取焦点                            | boolean           | false  |
-| checked        | 指定当前是否选中                        | boolean           | false  |
-| defaultChecked | 初始是否选中                            | boolean           | false  |
-| disabled       | 失效状态                                | boolean           | false  |
-| indeterminate  | 设置 indeterminate 状态，只负责样式控制 | boolean           | false  |
-| onChange       | 变化时回调函数                          | Function(e:Event) | -      |
+| 参数           | 说明                                    | 类型              | 默认值 | 版本  |
+| -------------- | --------------------------------------- | ----------------- | ------ | ----- |
+| autoFocus      | 自动获取焦点                            | boolean           | false  | 3.6.2 |
+| checked        | 指定当前是否选中                        | boolean           | false  | 3.6.2 |
+| defaultChecked | 初始是否选中                            | boolean           | false  | 3.6.2 |
+| disabled       | 失效状态                                | boolean           | false  | 3.6.2 |
+| indeterminate  | 设置 indeterminate 状态，只负责样式控制 | boolean           | false  | 3.6.2 |
+| onChange       | 变化时回调函数                          | Function(e:Event) | -      | 3.6.2 |
 
 #### Checkbox Group
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| defaultValue | 默认选中的选项 | string\[] | \[] |
-| disabled | 整组失效 | boolean | false |
-| name | CheckboxGroup 下所有 `input[type="checkbox"]` 的 `name` 属性 | string | - |
-| options | 指定可选项 | string\[] | \[] |
-| value | 指定选中的选项 | string\[] | \[] |
-| onChange | 变化时回调函数 | Function(checkedValue) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| defaultValue | 默认选中的选项 | string\[] | \[] | 3.6.2 |
+| disabled | 整组失效 | boolean | false | 3.6.2 |
+| name | CheckboxGroup 下所有 `input[type="checkbox"]` 的 `name` 属性 | string | - | 3.16.0 |
+| options | 指定可选项 | string\[] | \[] | 3.6.2 |
+| value | 指定选中的选项 | string\[] | \[] | 3.6.2 |
+| onChange | 变化时回调函数 | Function(checkedValue) | - | 3.6.2 |
 
 ### 方法
 
 #### Checkbox
 
-| 名称    | 描述     |
-| ------- | -------- |
-| blur()  | 移除焦点 |
-| focus() | 获取焦点 |
+| 名称    | 描述     | 版本  |
+| ------- | -------- | ----- |
+| blur()  | 移除焦点 | 3.6.2 |
+| focus() | 获取焦点 | 3.6.2 |

components/checkbox/style/mixin.less

@@ -150,7 +150,6 @@
     }
   }
 
-  .@{checkbox-prefix-cls}-wrapper + span,
   .@{checkbox-prefix-cls} + span {
     padding-right: 8px;
     padding-left: 8px;

components/collapse/Collapse.tsx

@@ -9,8 +9,8 @@ import animation from '../_util/openAnimation';
 export type ExpandIconPosition = 'left' | 'right';
 
 export interface CollapseProps {
-  activeKey?: Array<string> | string;
-  defaultActiveKey?: Array<string>;
+  activeKey?: Array<string | number> | string | number;
+  defaultActiveKey?: Array<string | number> | string | number;
   /** 手风琴效果 */
   accordion?: boolean;
   destroyInactivePanel?: boolean;

components/collapse/CollapsePanel.tsx

@@ -4,7 +4,7 @@ import classNames from 'classnames';
 import { ConfigConsumer, ConfigConsumerProps } from '../config-provider';
 
 export interface CollapsePanelProps {
-  key: string;
+  key: string | number;
   header: React.ReactNode;
   disabled?: boolean;
   className?: string;

components/collapse/index.en-US.md

@@ -18,22 +18,22 @@ A content area which can be collapsed and expanded.
 
 | Property | Description | Type | Default | Version |
 | --- | --- | --- | --- | --- |
-| activeKey | Key of the active panel | string\[]\|string | No default value. In `accordion` mode, it's the key of the first panel. |  |
-| defaultActiveKey | Key of the initial active panel | string | - |  |
-| bordered | Toggles rendering of the border around the collapse block | boolean | `true` |  |
-| accordion | If `true`, `Collapse` renders as `Accordion` | boolean | `false` |  |
+| activeKey | Key of the active panel | string\[]\|string\| number\[]\|number | No default value. In `accordion` mode, it's the key of the first panel. |  |
+| defaultActiveKey | Key of the initial active panel | string\[]\|string\| number\[]\|number | - |  |
+| bordered | Toggles rendering of the border around the collapse block | boolean | `true` | 3.6.5 |
+| accordion | If `true`, `Collapse` renders as `Accordion` | boolean | `false` | 3.6.5 |
 | onChange | Callback function executed when active panel is changed | Function | - |  |
-| expandIcon | allow to customize collapse icon | (panelProps) => ReactNode | - |  |
+| expandIcon | allow to customize collapse icon | (panelProps) => ReactNode | - | 3.13.0 |
 | expandIconPosition | Set expand icon position: `left`, `right` | `left` | - | 3.17.0 |
-| destroyInactivePanel | Destroy Inactive Panel | boolean | `false` |  |
+| destroyInactivePanel | Destroy Inactive Panel | boolean | `false` | 3.6.5 |
 
 ### Collapse.Panel
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| disabled | If `true`, panel cannot be opened or closed | boolean | `false` |
-| forceRender | Forced render of content on panel, instead of lazy rending after clicking on header | boolean | `false` |
-| header | Title of the panel | string\|ReactNode | - |
-| key | Unique key identifying the panel from among its siblings | string | - |
-| showArrow | If `false`, panel will not show arrow icon | boolean | `true` |
-| extra | extra element in the corner | ReactNode | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| disabled | If `true`, panel cannot be opened or closed | boolean | `false` |  |
+| forceRender | Forced render of content on panel, instead of lazy rending after clicking on header | boolean | `false` | 3.2.0 |
+| header | Title of the panel | string\|ReactNode | - |  |
+| key | Unique key identifying the panel from among its siblings | string\|number | - |  |
+| showArrow | If `false`, panel will not show arrow icon | boolean | `true` | 3.1.0 |
+| extra | extra element in the corner | ReactNode | - | 3.14.0 |

components/collapse/index.zh-CN.md

@@ -19,22 +19,22 @@ cols: 1
 
 | 参数 | 说明 | 类型 | 默认值 | 版本 |
 | --- | --- | --- | --- | --- |
-| activeKey | 当前激活 tab 面板的 key | string\[]\|string | 默认无，accordion 模式下默认第一个元素 |  |
-| defaultActiveKey | 初始化选中面板的 key | string | 无 |  |
-| bordered | 带边框风格的折叠面板 | boolean | `true` |  |
-| accordion | 手风琴模式 | boolean | `false` |  |
+| activeKey | 当前激活 tab 面板的 key | string\[]\|string\| number\[]\|number | 默认无，accordion 模式下默认第一个元素 |  |
+| defaultActiveKey | 初始化选中面板的 key | string\[]\|string\| number\[]\|number | 无 |  |
+| bordered | 带边框风格的折叠面板 | boolean | `true` | 3.13.0 |
+| accordion | 手风琴模式 | boolean | `false` | 3.13.0 |
 | onChange | 切换面板的回调 | Function | 无 |  |
-| expandIcon | 自定义切换图标 | (panelProps) => ReactNode | - |  |
+| expandIcon | 自定义切换图标 | (panelProps) => ReactNode | - | 3.13.0 |
 | expandIconPosition | 设置图标位置： `left`, `right` | `left` | - | 3.17.0 |
-| destroyInactivePanel | 销毁折叠隐藏的面板 | boolean | `false` |  |
+| destroyInactivePanel | 销毁折叠隐藏的面板 | boolean | `false` | 3.13.0 |
 
 ### Collapse.Panel
 
-| 参数        | 说明                                       | 类型              | 默认值 |
-| ----------- | ------------------------------------------ | ----------------- | ------ |
-| disabled    | 禁用后的面板展开与否将无法通过用户交互改变 | boolean           | false  |
-| forceRender | 被隐藏时是否渲染 DOM 结构                  | boolean           | false  |
-| header      | 面板头内容                                 | string\|ReactNode | 无     |
-| key         | 对应 activeKey                             | string            | 无     |
-| showArrow   | 是否展示当前面板上的箭头                   | boolean           | `true` |
-| extra       | 自定义渲染每个面板右上角的内容             | ReactNode         | -      |
+| 参数        | 说明                                       | 类型              | 默认值 | 版本   |
+| ----------- | ------------------------------------------ | ----------------- | ------ | ------ |
+| disabled    | 禁用后的面板展开与否将无法通过用户交互改变 | boolean           | false  |        |
+| forceRender | 被隐藏时是否渲染 DOM 结构                  | boolean           | false  | 3.2.0  |
+| header      | 面板头内容                                 | string\|ReactNode | 无     |        |
+| key         | 对应 activeKey                             | string\|number            | 无     |        |
+| showArrow   | 是否展示当前面板上的箭头                   | boolean           | `true` | 3.13.0 |
+| extra       | 自定义渲染每个面板右上角的内容             | ReactNode         | -      | 3.14.0 |

components/comment/index.en-US.md

@@ -13,11 +13,11 @@ Comments can be used to enable discussions on an entity such as a page, blog pos
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| actions | List of action items rendered below the comment content | Array<ReactNode> | - |
-| author | The element to display as the comment author | string\|ReactNode | - |
-| avatar | The element to display as the comment avatar - generally an antd `Avatar` or src | string\|ReactNode | - |
-| children | Nested comments should be provided as children of the Comment | ReactNode | - |
-| content | The main content of the comment | string\|ReactNode | - |
-| datetime | A datetime element containing the time to be displayed | string\|ReactNode | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| actions | List of action items rendered below the comment content | Array<ReactNode> | - | 3.11.0 |
+| author | The element to display as the comment author | string\|ReactNode | - | 3.11.0 |
+| avatar | The element to display as the comment avatar - generally an antd `Avatar` or src | string\|ReactNode | - | 3.11.0 |
+| children | Nested comments should be provided as children of the Comment | ReactNode | - | 3.11.0 |
+| content | The main content of the comment | string\|ReactNode | - | 3.11.0 |
+| datetime | A datetime element containing the time to be displayed | string\|ReactNode | - | 3.11.0 |

components/comment/index.zh-CN.md

@@ -14,11 +14,11 @@ cols: 1
 
 ## API
 
-| Property | Description                                            | Type              | Default |
-| -------- | ------------------------------------------------------ | ----------------- | ------- |
-| actions  | 在评论内容下面呈现的操作项列表                         | Array<ReactNode>  | -       |
-| author   | 要显示为注释作者的元素                                 | string\|ReactNode | -       |
-| avatar   | 要显示为评论头像的元素 - 通常是 antd `Avatar` 或者 src | string\|ReactNode | -       |
-| children | 嵌套注释应作为注释的子项提供                           | ReactNode         | -       |
-| content  | 评论的主要内容                                         | string\|ReactNode | -       |
-| datetime | 展示时间描述                                           | string\|ReactNode | -       |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| actions | 在评论内容下面呈现的操作项列表 | Array<ReactNode> | - | 3.11.0 |
+| author | 要显示为注释作者的元素 | string\|ReactNode | - | 3.11.0 |
+| avatar | 要显示为评论头像的元素 - 通常是 antd `Avatar` 或者 src | string\|ReactNode | - | 3.11.0 |
+| children | 嵌套注释应作为注释的子项提供 | ReactNode | - | 3.11.0 |
+| content | 评论的主要内容 | string\|ReactNode | - | 3.11.0 |
+| datetime | 展示时间描述 | string\|ReactNode | - | 3.11.0 |

components/config-provider/__tests__/__snapshots__/components.test.js.snap

@@ -9607,7 +9607,7 @@ exports[`ConfigProvider components Progress configProvider 1`] = `
       >
         <div
           class="config-progress-bg"
-          style="width:0%;height:8px;border-radius:100px"
+          style="width:0%;height:8px;border-radius:"
         />
       </div>
     </div>
@@ -9634,7 +9634,7 @@ exports[`ConfigProvider components Progress normal 1`] = `
       >
         <div
           class="ant-progress-bg"
-          style="width:0%;height:8px;border-radius:100px"
+          style="width:0%;height:8px;border-radius:"
         />
       </div>
     </div>
@@ -9661,7 +9661,7 @@ exports[`ConfigProvider components Progress prefixCls 1`] = `
       >
         <div
           class="prefix-Progress-bg"
-          style="width:0%;height:8px;border-radius:100px"
+          style="width:0%;height:8px;border-radius:"
         />
       </div>
     </div>

components/config-provider/__tests__/components.test.js

@@ -354,7 +354,7 @@ describe('ConfigProvider', () => {
     // Modal
     testPair('Modal', props => (
       <div>
-        <Modal {...props} visible>
+        <Modal {...props} visible getContainer={false}>
           Bamboo is Little Light
         </Modal>
       </div>

components/config-provider/index.en-US.md

@@ -35,10 +35,10 @@ Some component use dynamic style to support wave effect. You can config `csp` pr
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| autoInsertSpaceInButton | Set `false` to remove space between 2 chinese characters on Button | boolean | true |
-| csp | Set [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) config | { nonce: string } | - |
-| renderEmpty | set empty content of components. Ref [Empty](/components/empty/) | Function(componentName: string): ReactNode | - |
-| getPopupContainer | to set the container of the popup element. The default is to create a `div` element in `body`. | Function(triggerNode) | `() => document.body` |
-| prefixCls | set prefix class | string | ant |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| autoInsertSpaceInButton | Set `false` to remove space between 2 chinese characters on Button | boolean | true | 3.13.0 |
+| csp | Set [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) config | { nonce: string } | - | 3.13.1 |
+| renderEmpty | set empty content of components. Ref [Empty](/components/empty/) | Function(componentName: string): ReactNode | - | 3.12.2 |
+| getPopupContainer | to set the container of the popup element. The default is to create a `div` element in `body`. | Function(triggerNode) | `() => document.body` | 3.11.0 |
+| prefixCls | set prefix class | string | ant | 3.12.0 |

components/config-provider/index.zh-CN.md

@@ -36,10 +36,10 @@ return (
 
 ## API
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| autoInsertSpaceInButton | 设置为 `false` 时，移除按钮中 2 个汉字之间的空格 | boolean | true |
-| csp | 设置 [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) 配置 | { nonce: string } | - |
-| renderEmpty | 自定义组件空状态。参考 [空状态](/components/empty/) | Function(componentName: string): ReactNode | - |
-| getPopupContainer | 弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。 | Function(triggerNode) | () => document.body |
-| prefixCls | 设置统一样式前缀 | string | ant |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| autoInsertSpaceInButton | 设置为 `false` 时，移除按钮中 2 个汉字之间的空格 | boolean | true | 3.13.0 |
+| csp | 设置 [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) 配置 | { nonce: string } | - | 3.13.1 |
+| renderEmpty | 自定义组件空状态。参考 [空状态](/components/empty/) | Function(componentName: string): ReactNode | - | 3.12.2 |
+| getPopupContainer | 弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。 | Function(triggerNode) | () => document.body | 3.11.0 |
+| prefixCls | 设置统一样式前缀 | string | ant | 3.12.0 |

components/date-picker/RangePicker.tsx

@@ -150,6 +150,9 @@ class RangePicker extends React.Component<any, RangePickerState> {
         showDate: getShowDateFromValue(value) || showDate,
       }));
     }
+    if (value[0] && value[0].diff(value[1]) > 0) {
+      value[1] = undefined;
+    }
     const [start, end] = value;
     props.onChange(value, [formatDate(start, props.format), formatDate(end, props.format)]);
   };

components/date-picker/__tests__/RangePicker.test.js

@@ -387,4 +387,17 @@ describe('RangePicker', () => {
       ).toBe(false);
     });
   });
+
+  // https://github.com/ant-design/ant-design/issues/17135
+  it('the end time should be less than the start time', () => {
+    const wrapper = mount(
+      <RangePicker defaultValue={[moment(), moment()]} />,
+    );
+    wrapper.find('.ant-calendar-picker-input').simulate('click');
+    const firstInput = wrapper.find('.ant-calendar-input').first();
+    const secondInput = wrapper.find('.ant-calendar-input').last();
+    firstInput.simulate('change', { target: { value: moment().add(1, 'day').format('YYYY-MM-DD')}});
+    expect(firstInput.getDOMNode().value).toBe(moment().add(1, 'day').format('YYYY-MM-DD'));
+    expect(secondInput.getDOMNode().value).toBe('');
+  });
 });

components/date-picker/index.en-US.md

@@ -45,80 +45,80 @@ import 'moment/locale/zh-cn';
 
 The following APIs are shared by DatePicker, MonthPicker, RangePicker, WeekPicker.
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| allowClear | Whether to show clear button | boolean | true |
-| autoFocus | get focus when component mounted | boolean | false |
-| className | picker className | string | '' |
-| dateRender | custom rendering function for date cells | function(currentDate: moment, today: moment) => React.ReactNode | - |
-| disabled | determine whether the DatePicker is disabled | boolean | false |
-| disabledDate | specify the date that cannot be selected | (currentDate: moment) => boolean | - |
-| dropdownClassName | to customize the className of the popup calendar | string | - |
-| getCalendarContainer | to set the container of the floating layer, while the default is to create a `div` element in `body` | function(trigger) | - |
-| locale | localization configuration | object | [default](https://github.com/ant-design/ant-design/blob/master/components/date-picker/locale/example.json) |
-| mode | picker panel mode（[Cannot select year or month anymore?](/docs/react/faq#When-set-mode-to-DatePicker/RangePicker,-cannot-select-year-or-month-anymore?)） | `time|date|month|year|decade` | 'date' |
-| open | open state of picker | boolean | - |
-| placeholder | placeholder of date input | string\|RangePicker\[] | - |
-| popupStyle | to customize the style of the popup calendar | object | {} |
-| size | determine the size of the input box, the height of `large` and `small`, are 40px and 24px respectively, while default size is 32px | string | - |
-| suffixIcon | The custom suffix icon | ReactNode | - |
-| style | to customize the style of the input box | object | {} |
-| onOpenChange | a callback function, can be executed whether the popup calendar is popped up or closed | function(status) | - |
-| onPanelChange | callback when picker panel mode is changed | function(value, mode) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| allowClear | Whether to show clear button | boolean | true |  |
+| autoFocus | get focus when component mounted | boolean | false |  |
+| className | picker className | string | '' |  |
+| dateRender | custom rendering function for date cells | function(currentDate: moment, today: moment) => React.ReactNode | - |  |
+| disabled | determine whether the DatePicker is disabled | boolean | false |  |
+| disabledDate | specify the date that cannot be selected | (currentDate: moment) => boolean | - |  |
+| dropdownClassName | to customize the className of the popup calendar | string | - | 3.3.0 |
+| getCalendarContainer | to set the container of the floating layer, while the default is to create a `div` element in `body` | function(trigger) | - |  |
+| locale | localization configuration | object | [default](https://github.com/ant-design/ant-design/blob/master/components/date-picker/locale/example.json) |  |
+| mode | picker panel mode（[Cannot select year or month anymore?](/docs/react/faq#When-set-mode-to-DatePicker/RangePicker,-cannot-select-year-or-month-anymore?) | `time|date|month|year|decade` | 'date' |  |
+| open | open state of picker | boolean | - |  |
+| placeholder | placeholder of date input | string\|RangePicker\[] | - |  |
+| popupStyle | to customize the style of the popup calendar | object | {} |  |
+| size | determine the size of the input box, the height of `large` and `small`, are 40px and 24px respectively, while default size is 32px | string | - |  |
+| suffixIcon | The custom suffix icon | ReactNode | - | 3.10.0 |
+| style | to customize the style of the input box | object | {} |  |
+| onOpenChange | a callback function, can be executed whether the popup calendar is popped up or closed | function(status) | - |  |
+| onPanelChange | callback when picker panel mode is changed | function(value, mode) | - | 3.5.0 |
 
 ### Common Methods
 
-| Name    | Description  |
-| ------- | ------------ |
-| blur()  | remove focus |
-| focus() | get focus    |
+| Name    | Description  | Version |
+| ------- | ------------ | ------- |
+| blur()  | remove focus |         |
+| focus() | get focus    |         |
 
 ### DatePicker
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| defaultValue | to set default date, if start time or end time is null or undefined, the date range will be an open interval | [moment](http://momentjs.com/) | - |
-| defaultPickerValue | to set default picker date | [moment](http://momentjs.com/) | - |
-| disabledTime | to specify the time that cannot be selected | function(date) | - |
-| format | to set the date format, refer to [moment.js](http://momentjs.com/). When an array is provided, all values are used for parsing and first value is used for formatting. | string \| string[] | "YYYY-MM-DD" |
-| renderExtraFooter | render extra footer in panel | (mode) => React.ReactNode | - |
-| showTime | to provide an additional time selection | object\|boolean | [TimePicker Options](/components/time-picker/#API) |
-| showTime.defaultValue | to set default time of selected date, [demo](#components-date-picker-demo-disabled-date) | [moment](http://momentjs.com/) | moment() |
-| showToday | whether to show "Today" button | boolean | true |
-| value | to set date | [moment](http://momentjs.com/) | - |
-| onChange | a callback function, can be executed when the selected time is changing | function(date: moment, dateString: string) | - |
-| onOk | callback when click ok button | function() | - |
-| onPanelChange | Callback function for panel changing | function(value, mode) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| defaultValue | to set default date, if start time or end time is null or undefined, the date range will be an open interval | [moment](http://momentjs.com/) | - |  |
+| defaultPickerValue | to set default picker date | [moment](http://momentjs.com/) | - | 3.10.8 |
+| disabledTime | to specify the time that cannot be selected | function(date) | - |  |
+| format | to set the date format, refer to [moment.js](http://momentjs.com/). When an array is provided, all values are used for parsing and first value is used for formatting. | string \| string[] | "YYYY-MM-DD" |  |
+| renderExtraFooter | render extra footer in panel | (mode) => React.ReactNode | - |  |
+| showTime | to provide an additional time selection | object\|boolean | [TimePicker Options](/components/time-picker/#API) |  |
+| showTime.defaultValue | to set default time of selected date, [demo](#components-date-picker-demo-disabled-date) | [moment](http://momentjs.com/) | moment() |  |
+| showToday | whether to show "Today" button | boolean | true |  |
+| value | to set date | [moment](http://momentjs.com/) | - |  |
+| onChange | a callback function, can be executed when the selected time is changing | function(date: moment, dateString: string) | - |  |
+| onOk | callback when click ok button | function() | - |  |
+| onPanelChange | Callback function for panel changing | function(value, mode) | - | 3.19.8 |
 
 ### MonthPicker
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| defaultValue | to set default date | [moment](http://momentjs.com/) | - |
-| defaultPickerValue | to set default picker date | [moment](http://momentjs.com/) | - |
-| format | to set the date format, refer to [moment.js](http://momentjs.com/) | string | "YYYY-MM" |
-| monthCellContentRender | Custom month cell content render method | function(date, locale): ReactNode | - |
-| renderExtraFooter | render extra footer in panel | () => React.ReactNode | - |
-| value | to set date | [moment](http://momentjs.com/) | - |
-| onChange | a callback function, can be executed when the selected time is changing | function(date: moment, dateString: string) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| defaultValue | to set default date | [moment](http://momentjs.com/) | - |  |
+| defaultPickerValue | to set default picker date | [moment](http://momentjs.com/) | - | 3.10.8 |
+| format | to set the date format, refer to [moment.js](http://momentjs.com/) | string | "YYYY-MM" |  |
+| monthCellContentRender | Custom month cell content render method | function(date, locale): ReactNode | - |  |
+| renderExtraFooter | render extra footer in panel | () => React.ReactNode | - |  |
+| value | to set date | [moment](http://momentjs.com/) | - |  |
+| onChange | a callback function, can be executed when the selected time is changing | function(date: moment, dateString: string) | - |  |
 
 ### WeekPicker
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| defaultValue | to set default date | [moment](http://momentjs.com/) | - |
-| defaultPickerValue | to set default picker date | [moment](http://momentjs.com/) | - |
-| format | to set the date format, refer to [moment.js](http://momentjs.com/) | string | "YYYY-wo" |
-| value | to set date | [moment](http://momentjs.com/) | - |
-| onChange | a callback function, can be executed when the selected time is changing | function(date: moment, dateString: string) | - |
-| renderExtraFooter | render extra footer in panel | (mode) => React.ReactNode | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| defaultValue | to set default date | [moment](http://momentjs.com/) | - |  |
+| defaultPickerValue | to set default picker date | [moment](http://momentjs.com/) | - | 3.10.8 |
+| format | to set the date format, refer to [moment.js](http://momentjs.com/) | string | "YYYY-wo" |  |
+| value | to set date | [moment](http://momentjs.com/) | - |  |
+| onChange | a callback function, can be executed when the selected time is changing | function(date: moment, dateString: string) | - |  |
+| renderExtraFooter | render extra footer in panel | (mode) => React.ReactNode | - | 3.12.0 |
 
 ### RangePicker
 
 | Property | Description | Type | Default | Version |
 | --- | --- | --- | --- | --- |
 | defaultValue | to set default date | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)] | - |  |
-| defaultPickerValue | to set default picker date | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)\] | - |  |
+| defaultPickerValue | to set default picker date | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)\] | - | 3.10.8 |
 | disabledTime | to specify the time that cannot be selected | function(dates: \[moment, moment], partial: `'start'|'end'`) | - |  |
 | format | to set the date format, refer to [moment.js](http://momentjs.com/). When an array is provided, all values are used for parsing and first value is used for formatting. | string \| string[] | "YYYY-MM-DD HH:mm:ss" |  |
 | ranges | preseted ranges for quick selection | { \[range: string]: [moment](http://momentjs.com/)\[] } \| { \[range: string]: () => [moment](http://momentjs.com/)\[] } | - |  |
@@ -127,7 +127,7 @@ The following APIs are shared by DatePicker, MonthPicker, RangePicker, WeekPicke
 | showTime | to provide an additional time selection | object\|boolean | [TimePicker Options](/components/time-picker/#API) |  |
 | showTime.defaultValue | to set default time of selected date, [demo](#components-date-picker-demo-disabled-date) | [moment](http://momentjs.com/)\[] | \[moment(), moment()] |  |
 | value | to set date | \[[moment](http://momentjs.com/), [moment](http://momentjs.com/)] | - |  |
-| onCalendarChange | a callback function, can be executed when the start time or the end time of the range is changing | function(dates: \[moment, moment], dateStrings: \[string, string]) | - |  |
+| onCalendarChange | a callback function, can be executed when the start time or the end time of the range is changing | function(dates: \[moment, moment], dateStrings: \[string, string]) | - | 3.10.9 |
 | onChange | a callback function, can be executed when the selected time is changing | function(dates: \[moment, moment], dateStrings: \[string, string]) | - |  |
 | onOk | callback when click ok button | function(dates: [moment](http://momentjs.com/)\[]) | - |  |
 

components/date-picker/index.zh-CN.md

@@ -47,80 +47,80 @@ moment.locale('zh-cn');
 
 以下 API 为 DatePicker、MonthPicker、RangePicker, WeekPicker 共享的 API。
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| allowClear | 是否显示清除按钮 | boolean | true |
-| autoFocus | 自动获取焦点 | boolean | false |
-| className | 选择器 className | string | '' |
-| dateRender | 自定义日期单元格的内容 | function(currentDate: moment, today: moment) => React.ReactNode | - |
-| disabled | 禁用 | boolean | false |
-| disabledDate | 不可选择的日期 | (currentDate: moment) => boolean | 无 |
-| dropdownClassName | 额外的弹出日历 className | string | - |
-| getCalendarContainer | 定义浮层的容器，默认为 body 上新建 div | function(trigger) | 无 |
-| locale | 国际化配置 | object | [默认配置](https://github.com/ant-design/ant-design/blob/master/components/date-picker/locale/example.json) |
-| mode | 日期面板的状态（[设置后无法选择年份/月份？](/docs/react/faq#当我指定了-DatePicker/RangePicker-的-mode-属性后，点击后无法选择年份/月份？)） | `time|date|month|year|decade` | 'date' |
-| open | 控制弹层是否展开 | boolean | - |
-| placeholder | 输入框提示文字 | string\|RangePicker\[] | - |
-| popupStyle | 额外的弹出日历样式 | object | {} |
-| size | 输入框大小，`large` 高度为 40px，`small` 为 24px，默认是 32px | string | 无 |
-| suffixIcon | 自定义的选择框后缀图标 | ReactNode | - |
-| style | 自定义输入框样式 | object | {} |
-| onOpenChange | 弹出日历和关闭日历的回调 | function(status) | 无 |
-| onPanelChange | 日历面板切换的回调 | function(value, mode) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| allowClear | 是否显示清除按钮 | boolean | true |  |
+| autoFocus | 自动获取焦点 | boolean | false |  |
+| className | 选择器 className | string | '' |  |
+| dateRender | 自定义日期单元格的内容 | function(currentDate: moment, today: moment) => React.ReactNode | - |  |
+| disabled | 禁用 | boolean | false |  |
+| disabledDate | 不可选择的日期 | (currentDate: moment) => boolean | 无 |  |
+| dropdownClassName | 额外的弹出日历 className | string | - | 3.3.0 |
+| getCalendarContainer | 定义浮层的容器，默认为 body 上新建 div | function(trigger) | 无 |  |
+| locale | 国际化配置 | object | [默认配置](https://github.com/ant-design/ant-design/blob/master/components/date-picker/locale/example.json) |  |
+| mode | 日期面板的状态（[设置后无法选择年份/月份？](/docs/react/faq#当我指定了-DatePicker/RangePicker-的-mode-属性后，点击后无法选择年份/月份？)） | `time|date|month|year|decade` | 'date' |  |
+| open | 控制弹层是否展开 | boolean | - |  |
+| placeholder | 输入框提示文字 | string\|RangePicker\[] | - |  |
+| popupStyle | 额外的弹出日历样式 | object | {} |  |
+| size | 输入框大小，`large` 高度为 40px，`small` 为 24px，默认是 32px | string | 无 |  |
+| suffixIcon | 自定义的选择框后缀图标 | ReactNode | - | 3.10.0 |
+| style | 自定义输入框样式 | object | {} |  |
+| onOpenChange | 弹出日历和关闭日历的回调 | function(status) | 无 |  |
+| onPanelChange | 日历面板切换的回调 | function(value, mode) | - | 3.12.0 |
 
 ### 共同的方法
 
-| 名称    | 描述     |
-| ------- | -------- |
-| blur()  | 移除焦点 |
-| focus() | 获取焦点 |
+| 名称    | 描述     | 版本 |
+| ------- | -------- | ---- |
+| blur()  | 移除焦点 |      |
+| focus() | 获取焦点 |      |
 
 ### DatePicker
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| defaultValue | 默认日期，如果开始时间或结束时间为 `null` 或者 `undefined`，日期范围将是一个开区间 | [moment](http://momentjs.com/) | 无 |
-| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/) | 无 |
-| disabledTime | 不可选择的时间 | function(date) | 无 |
-| format | 设置日期格式，为数组时支持多格式匹配，展示以第一个为准。配置参考 [moment.js](http://momentjs.com/) | string \| string[] | "YYYY-MM-DD" |
-| renderExtraFooter | 在面板中添加额外的页脚 | (mode) => React.ReactNode | - |
-| showTime | 增加时间选择功能 | Object\|boolean | [TimePicker Options](/components/time-picker/#API) |
-| showTime.defaultValue | 设置用户选择日期时默认的时分秒，[例子](#components-date-picker-demo-disabled-date) | [moment](http://momentjs.com/) | moment() |
-| showToday | 是否展示“今天”按钮 | boolean | true |
-| value | 日期 | [moment](http://momentjs.com/) | 无 |
-| onChange | 时间发生变化的回调 | function(date: moment, dateString: string) | 无 |
-| onOk | 点击确定按钮的回调 | function() | - |
-| onPanelChange | 日期面板变化时的回调 | function(value, mode) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| defaultValue | 默认日期，如果开始时间或结束时间为 `null` 或者 `undefined`，日期范围将是一个开区间 | [moment](http://momentjs.com/) | 无 |  |
+| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/) | 无 | 3.10.8 |
+| disabledTime | 不可选择的时间 | function(date) | 无 |  |
+| format | 设置日期格式，为数组时支持多格式匹配，展示以第一个为准。配置参考 [moment.js](http://momentjs.com/) | string \| string[] | "YYYY-MM-DD" |  |
+| renderExtraFooter | 在面板中添加额外的页脚 | (mode) => React.ReactNode | - |  |
+| showTime | 增加时间选择功能 | Object\|boolean | [TimePicker Options](/components/time-picker/#API) |  |
+| showTime.defaultValue | 设置用户选择日期时默认的时分秒，[例子](#components-date-picker-demo-disabled-date) | [moment](http://momentjs.com/) | moment() |  |
+| showToday | 是否展示“今天”按钮 | boolean | true |  |
+| value | 日期 | [moment](http://momentjs.com/) | 无 |  |
+| onChange | 时间发生变化的回调 | function(date: moment, dateString: string) | 无 |  |
+| onOk | 点击确定按钮的回调 | function() | - |  |
+| onPanelChange | 日期面板变化时的回调 | function(value, mode) | - | 3.5.0 |
 
 ### MonthPicker
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| defaultValue | 默认日期 | [moment](http://momentjs.com/) | 无 |
-| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/) | 无 |
-| format | 展示的日期格式，配置参考 [moment.js](http://momentjs.com/) | string | "YYYY-MM" |
-| monthCellContentRender | 自定义的月份内容渲染方法 | function(date, locale): ReactNode | - |
-| renderExtraFooter | 在面板中添加额外的页脚 | () => React.ReactNode | - |
-| value | 日期 | [moment](http://momentjs.com/) | 无 |
-| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: moment, dateString: string) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| defaultValue | 默认日期 | [moment](http://momentjs.com/) | 无 |  |
+| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/) | 无 | 3.10.8 |
+| format | 展示的日期格式，配置参考 [moment.js](http://momentjs.com/) | string | "YYYY-MM" |  |
+| monthCellContentRender | 自定义的月份内容渲染方法 | function(date, locale): ReactNode | - |  |
+| renderExtraFooter | 在面板中添加额外的页脚 | () => React.ReactNode | - |  |
+| value | 日期 | [moment](http://momentjs.com/) | 无 |  |
+| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: moment, dateString: string) | - |  |
 
 ### WeekPicker
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| defaultValue | 默认日期 | [moment](http://momentjs.com/) | - |
-| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/) | 无 |
-| format | 展示的日期格式，配置参考 [moment.js](http://momentjs.com/) | string | "YYYY-wo" |
-| value | 日期 | [moment](http://momentjs.com/) | - |
-| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: moment, dateString: string) | - |
-| renderExtraFooter | 在面板中添加额外的页脚 | (mode) => React.ReactNode | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| defaultValue | 默认日期 | [moment](http://momentjs.com/) | - |  |
+| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/) | 无 | 3.10.8 |
+| format | 展示的日期格式，配置参考 [moment.js](http://momentjs.com/) | string | "YYYY-wo" |  |
+| value | 日期 | [moment](http://momentjs.com/) | - |  |
+| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: moment, dateString: string) | - |  |
+| renderExtraFooter | 在面板中添加额外的页脚 | (mode) => React.ReactNode | - | 3.12.0 |
 
 ### RangePicker
 
 | 参数 | 说明 | 类型 | 默认值 | 版本 |
 | --- | --- | --- | --- | --- |
 | defaultValue | 默认日期 | [moment](http://momentjs.com/)\[] | 无 |  |
-| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/)\[] | 无 |  |
+| defaultPickerValue | 默认面板日期 | [moment](http://momentjs.com/)\[] | 无 | 3.10.8 |
 | disabledTime | 不可选择的时间 | function(dates: \[moment, moment\], partial: `'start'|'end'`) | 无 |  |
 | format | 展示的日期格式 | string | "YYYY-MM-DD HH:mm:ss" |  |
 | ranges | 预设时间范围快捷选择 | { \[range: string]: [moment](http://momentjs.com/)\[] } \| { \[range: string]: () => [moment](http://momentjs.com/)\[] } | 无 |  |

components/date-picker/style/Picker.less

@@ -55,7 +55,7 @@
   }
 
   &:hover &-input:not(.@{ant-prefix}-input-disabled) {
-    border-color: @primary-color;
+    border-color: @input-hover-border-color;
   }
 
   &:focus &-input:not(.@{ant-prefix}-input-disabled) {

components/descriptions/__tests__/__snapshots__/demo.test.js.snap

@@ -278,7 +278,7 @@ exports[`renders ./components/descriptions/demo/border.md correctly 1`] = `
 exports[`renders ./components/descriptions/demo/responsive.md correctly 1`] = `
 <div>
   <div
-    class="ant-descriptions"
+    class="ant-descriptions ant-descriptions-bordered"
   >
     <div
       class="ant-descriptions-title"
@@ -293,128 +293,100 @@ exports[`renders ./components/descriptions/demo/responsive.md correctly 1`] = `
           <tr
             class="ant-descriptions-row"
           >
+            <th
+              class="ant-descriptions-item-label"
+            >
+              Product
+            </th>
             <td
-              class="ant-descriptions-item"
+              class="ant-descriptions-item-content"
               colspan="1"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                Product
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                Cloud Database
-              </span>
+              Cloud Database
             </td>
+            <th
+              class="ant-descriptions-item-label"
+            >
+              Billing
+            </th>
             <td
-              class="ant-descriptions-item"
+              class="ant-descriptions-item-content"
               colspan="1"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                Billing
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                Prepaid
-              </span>
+              Prepaid
             </td>
+            <th
+              class="ant-descriptions-item-label"
+            >
+              time
+            </th>
             <td
-              class="ant-descriptions-item"
+              class="ant-descriptions-item-content"
               colspan="1"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                time
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                18:00:00
-              </span>
+              18:00:00
             </td>
           </tr>
           <tr
             class="ant-descriptions-row"
           >
+            <th
+              class="ant-descriptions-item-label"
+            >
+              Amount
+            </th>
             <td
-              class="ant-descriptions-item"
+              class="ant-descriptions-item-content"
               colspan="1"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                Amount
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                $80.00
-              </span>
+              $80.00
             </td>
+            <th
+              class="ant-descriptions-item-label"
+            >
+              Discount
+            </th>
             <td
-              class="ant-descriptions-item"
+              class="ant-descriptions-item-content"
               colspan="1"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                Discount
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                $20.00
-              </span>
+              $20.00
             </td>
+            <th
+              class="ant-descriptions-item-label"
+            >
+              Official
+            </th>
             <td
-              class="ant-descriptions-item"
+              class="ant-descriptions-item-content"
               colspan="1"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                Official
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                $60.00
-              </span>
+              $60.00
             </td>
           </tr>
           <tr
             class="ant-descriptions-row"
           >
-            <td
-              class="ant-descriptions-item"
-              colspan="3"
+            <th
+              class="ant-descriptions-item-label"
             >
-              <span
-                class="ant-descriptions-item-label"
-              >
-                Config Info
-              </span>
-              <span
-                class="ant-descriptions-item-content"
-              >
-                Data disk type: MongoDB
-                <br />
-                Database version: 3.4
-                <br />
-                Package: dds.mongo.mid
-                <br />
-                Storage space: 10 GB
-                <br />
-                Replication_factor:3
-                <br />
-                Region: East China 1
-              </span>
+              Config Info
+            </th>
+            <td
+              class="ant-descriptions-item-content"
+              colspan="5"
+            >
+              Data disk type: MongoDB
+              <br />
+              Database version: 3.4
+              <br />
+              Package: dds.mongo.mid
+              <br />
+              Storage space: 10 GB
+              <br />
+              Replication_factor:3
+              <br />
+              Region: East China 1
             </td>
           </tr>
         </tbody>

components/descriptions/__tests__/__snapshots__/index.test.js.snap

@@ -1,5 +1,64 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`Descriptions Descriptions support style 1`] = `
+<Descriptions
+  column={
+    Object {
+      "lg": 3,
+      "md": 3,
+      "sm": 2,
+      "xl": 3,
+      "xs": 1,
+      "xxl": 3,
+    }
+  }
+  size="default"
+  style={
+    Object {
+      "backgroundColor": "#e8e8e8",
+    }
+  }
+>
+  <div
+    className="ant-descriptions"
+    style={
+      Object {
+        "backgroundColor": "#e8e8e8",
+      }
+    }
+  >
+    <div
+      className="ant-descriptions-view"
+    >
+      <table>
+        <tbody>
+          <tr
+            className="ant-descriptions-row"
+            key="0"
+          >
+            <td
+              className="ant-descriptions-item"
+              colSpan={1}
+            >
+              <span
+                className="ant-descriptions-item-label ant-descriptions-item-no-label"
+                key="label"
+              />
+              <span
+                className="ant-descriptions-item-content"
+                key="content"
+              >
+                Cloud Database
+              </span>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</Descriptions>
+`;
+
 exports[`Descriptions Descriptions.Item support className 1`] = `
 <Descriptions
   column={

components/descriptions/__tests__/index.test.js

@@ -151,4 +151,13 @@ describe('Descriptions', () => {
     );
     expect(wrapper).toMatchSnapshot();
   });
+
+  it('Descriptions support style', () => {
+    const wrapper = mount(
+      <Descriptions style={{ backgroundColor: '#e8e8e8' }}>
+        <Descriptions.Item>Cloud Database</Descriptions.Item>
+      </Descriptions>,
+    );
+    expect(wrapper).toMatchSnapshot();
+  });
 });

components/descriptions/demo/responsive.md

@@ -21,7 +21,7 @@ const Demo = () => {
     <div>
       <Descriptions
         title="Responsive Descriptions"
-        border
+        bordered
         column={{ xxl: 4, xl: 3, lg: 3, md: 3, sm: 2, xs: 1 }}
       >
         <Descriptions.Item label="Product">Cloud Database</Descriptions.Item>

components/descriptions/index.en-US.md

@@ -15,17 +15,17 @@ Commonly displayed on the details page.
 
 ### Descriptions
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| title | The title of the description list, placed at the top | ReactNode | - |
-| bordered | whether to display the border | boolean | false |
-| column | the number of `DescriptionItems` in a row,could be a number or a object like `{ xs: 8, sm: 16, md: 24}`,(Only set `bordered={true}` to take effect) | number | 3 |
-| size | set the size of the list. Can be set to `middle`,`small`, or not filled | `default | middle | small` | false |
-| layout | Define description layout | `horizontal | vertical` | `horizontal` |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| title | The title of the description list, placed at the top | ReactNode | - | 3.19.0 |
+| bordered | whether to display the border | boolean | false | 3.19.0 |
+| column | the number of `DescriptionItems` in a row,could be a number or a object like `{ xs: 8, sm: 16, md: 24}`,(Only set `bordered={true}` to take effect) | number | 3 | 3.19.0 |
+| size | set the size of the list. Can be set to `middle`,`small`, or not filled | `default | middle | small` | false | 3.19.0 |
+| layout | Define description layout | `horizontal | vertical` | `horizontal` | 3.19.8 |
 
 ### DescriptionItem
 
-| Property | Description                    | Type      | Default |
-| -------- | ------------------------------ | --------- | ------- |
-| label    | description of the content     | ReactNode | -       |
-| span     | The number of columns included | number    | 1       |
+| Property | Description                    | Type      | Default | Version |
+| -------- | ------------------------------ | --------- | ------- | ------- |
+| label    | description of the content     | ReactNode | -       | 3.19.0  |
+| span     | The number of columns included | number    | 1       | 3.19.0  |

components/descriptions/index.tsx

@@ -26,7 +26,7 @@ export interface DescriptionsProps {
   bordered?: boolean;
   size?: 'middle' | 'small' | 'default';
   children?: React.ReactNode;
-  title?: string;
+  title?: React.ReactNode;
   column?: number | Partial<Record<Breakpoint, number>>;
   layout?: 'horizontal' | 'vertical';
 }
@@ -281,6 +281,7 @@ class Descriptions extends React.Component<
             children,
             bordered = false,
             layout = 'horizontal',
+            style,
           } = this.props;
           const prefixCls = getPrefixCls('descriptions', customizePrefixCls);
 
@@ -306,6 +307,7 @@ class Descriptions extends React.Component<
                 [`${prefixCls}-${size}`]: size !== 'default',
                 [`${prefixCls}-bordered`]: !!bordered,
               })}
+              style={style}
             >
               {title && <div className={`${prefixCls}-title`}>{title}</div>}
               <div className={`${prefixCls}-view`}>

components/descriptions/index.zh-CN.md

@@ -16,17 +16,17 @@ cols: 1
 
 ### Descriptions
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| title | 描述列表的标题，显示在最顶部 | ReactNode | - |
-| bordered | 是否展示边框 | boolean | false |
-| column | 一行的 `DescriptionItems` 数量，可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number | 3 |
-| size | 设置列表的大小。可以设置为 `middle` 、`small`, 或不填（只有设置 `bordered={true}` 生效） | `default | middle | small` | false |
-| layout | 描述布局 | `horizontal | vertical` | `horizontal` |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| title | 描述列表的标题，显示在最顶部 | ReactNode | - | 3.19.0 |
+| bordered | 是否展示边框 | boolean | false | 3.19.0 |
+| column | 一行的 `DescriptionItems` 数量，可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number | 3 | 3.19.0 |
+| size | 设置列表的大小。可以设置为 `middle` 、`small`, 或不填（只有设置 `bordered={true}` 生效） | `default | middle | small` | false | 3.19.0 |
+| layout | 描述布局 | `horizontal | vertical` | `horizontal` | 3.19.8 |
 
 ### DescriptionItem
 
-| 参数  | 说明         | 类型      | 默认值 |
-| ----- | ------------ | --------- | ------ |
-| label | 内容的描述   | ReactNode | -      |
-| span  | 包含列的数量 | number    | 1      |
+| 参数  | 说明         | 类型      | 默认值 | 版本   |
+| ----- | ------------ | --------- | ------ | ------ |
+| label | 内容的描述   | ReactNode | -      | 3.19.0 |
+| span  | 包含列的数量 | number    | 1      | 3.19.0 |

components/descriptions/style/index.less

@@ -53,8 +53,8 @@
 
   &-item-no-label {
     &::after {
-      content: '';
       margin: 0;
+      content: '';
     }
   }
 

components/divider/index.en-US.md

@@ -16,10 +16,10 @@ A divider line separates different content.
 
 ### Divider
 
-| Property    | Description                      | Type                          | Default      |
-| ----------- | -------------------------------- | ----------------------------- | ------------ |
-| className   | className of container           | string                        | -            |
-| dashed      | whether line is dashed           | boolean                       | false        |
-| orientation | position of title inside divider | enum: `left` `right` `center` | `center`     |
-| style       | style object of container        | object                        | -            |
-| type        | direction type of divider        | enum: `horizontal` `vertical` | `horizontal` |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| className | className of container | string | - | 3.5.4 |
+| dashed | whether line is dashed | boolean | false |  |
+| orientation | position of title inside divider | enum: `left` `right` `center` | `center` | 3.3.0 |
+| style | style object of container | object | - | 3.5.4 |
+| type | direction type of divider | enum: `horizontal` `vertical` | `horizontal` |  |

components/divider/index.zh-CN.md

@@ -14,10 +14,10 @@ subtitle: 分割线
 
 ## API
 
-| 参数        | 说明             | 类型                          | 默认值       |
-| ----------- | ---------------- | ----------------------------- | ------------ |
-| className   | 分割线样式类     | string                        | -            |
-| dashed      | 是否虚线         | boolean                       | false        |
-| orientation | 分割线标题的位置 | enum: `left` `right`          | `center`     |
-| style       | 分割线样式对象   | object                        | -            |
-| type        | 水平还是垂直类型 | enum: `horizontal` `vertical` | `horizontal` |
+| 参数        | 说明             | 类型                          | 默认值       | 版本  |
+| ----------- | ---------------- | ----------------------------- | ------------ | ----- |
+| className   | 分割线样式类     | string                        | -            | 3.5.4 |
+| dashed      | 是否虚线         | boolean                       | false        |       |
+| orientation | 分割线标题的位置 | enum: `left` `right`          | `center`     | 3.4.1 |
+| style       | 分割线样式对象   | object                        | -            | 3.5.4 |
+| type        | 水平还是垂直类型 | enum: `horizontal` `vertical` | `horizontal` |       |

components/drawer/__tests__/MultiDrawer.test.js

@@ -4,11 +4,12 @@ import Drawer from '..';
 import Button from '../../button';
 
 class MultiDrawer extends React.Component {
-  state = { visible: false, childrenDrawer: false };
+  state = { visible: false, childrenDrawer: false, hasChildren: true };
 
   showDrawer = () => {
     this.setState({
       visible: true,
+      hasChildren: true,
     });
   };
 
@@ -21,6 +22,7 @@ class MultiDrawer extends React.Component {
   showChildrenDrawer = () => {
     this.setState({
       childrenDrawer: true,
+      hasChildren: true,
     });
   };
 
@@ -30,14 +32,23 @@ class MultiDrawer extends React.Component {
     });
   };
 
+  onRemoveChildDrawer = () => {
+    this.setState({
+      hasChildren: false,
+    });
+  };
+
   render() {
-    const { childrenDrawer, visible } = this.state;
+    const { childrenDrawer, visible, hasChildren } = this.state;
     const { placement } = this.props;
     return (
       <div>
         <Button type="primary" id="open_drawer" onClick={this.showDrawer}>
           Open drawer
         </Button>
+        <Button type="primary" id="remove_drawer" onClick={this.onRemoveChildDrawer}>
+          rm child drawer
+        </Button>
         <Drawer
           title="Multi-level drawer"
           className="test_drawer"
@@ -50,17 +61,19 @@ class MultiDrawer extends React.Component {
           <Button type="primary" id="open_two_drawer" onClick={this.showChildrenDrawer}>
             Two-level drawer
           </Button>
-          <Drawer
-            title="Two-level Drawer"
-            width={320}
-            className="Two-level"
-            getContainer={false}
-            placement={placement}
-            onClose={this.onChildrenDrawerClose}
-            visible={childrenDrawer}
-          >
-            <div id="two_drawer_text">This is two-level drawer</div>
-          </Drawer>
+          {hasChildren && (
+            <Drawer
+              title="Two-level Drawer"
+              width={320}
+              className="Two-level"
+              getContainer={false}
+              placement={placement}
+              onClose={this.onChildrenDrawerClose}
+              visible={childrenDrawer}
+            >
+              <div id="two_drawer_text">This is two-level drawer</div>
+            </Drawer>
+          )}
           <div
             style={{
               position: 'absolute',
@@ -121,4 +134,17 @@ describe('Drawer', () => {
     expect(translateX).toEqual('translateY(180px)');
     expect(wrapper.find('#two_drawer_text').exists()).toBe(true);
   });
+
+  it('render MultiDrawer is child in unmount', () => {
+    const wrapper = mount(<MultiDrawer placement="top" mask={false} />);
+    wrapper.find('button#open_drawer').simulate('click');
+    wrapper.find('button#open_two_drawer').simulate('click');
+    wrapper.find('button#remove_drawer').simulate('click');
+    let translateX = wrapper.find('.ant-drawer.test_drawer').get(0).props.style.transform;
+    expect(translateX).toEqual(undefined);
+    wrapper.find('button#open_two_drawer').simulate('click');
+    translateX = wrapper.find('.ant-drawer.test_drawer').get(0).props.style.transform;
+    expect(translateX).toEqual('translateY(180px)');
+    expect(wrapper.find('#two_drawer_text').exists()).toBe(true);
+  });
 });

components/drawer/index.en-US.md

@@ -17,26 +17,26 @@ A Drawer is a panel that is typically overlaid on top of a page and slides in fr
 
 ## API
 
-| Props | Description | Type | Default |
-| --- | --- | --- | --- |
-| closable | Whether a close (x) button is visible on top right of the Drawer dialog or not. | boolean | true |
-| destroyOnClose | Whether to unmount child components on closing drawer or not. | boolean | false |
-| getContainer | Return the mounted node for Drawer. | HTMLElement \| `() => HTMLElement` \| Selectors | 'body' |
-| mask | Whether to show mask or not. | Boolean | true |
-| maskClosable | Clicking on the mask (area outside the Drawer) to close the Drawer or not. | boolean | true |
-| maskStyle | Style for Drawer's mask element. | object | {} |
-| style | Style of drawer wrapper | object | - |
-| bodyStyle | Style of floating layer, typically used for adjusting its position. | object | - |
-| title | The title for Drawer. | string\|ReactNode | - |
-| visible | Whether the Drawer dialog is visible or not. | boolean | false |
-| width | Width of the Drawer dialog. | string\|number | 256 |
-| height | placement is `top` or `bottom`, height of the Drawer dialog. | string\|number | - |
-| className | The class name of the container of the Drawer dialog. | string | - |
-| zIndex | The `z-index` of the Drawer. | Number | 1000 |
-| placement | The placement of the Drawer. | 'top' \| 'right' \| 'bottom' \| 'left' | 'right' |
-| onClose | Specify a callback that will be called when a user clicks mask, close button or Cancel button. | function(e) | - |
-| afterVisibleChange | Callback after the animation ends when switching drawers. | function(visible) | - |
-| keyboard | Whether support press esc to close | Boolean | true |
+| Props | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| closable | Whether a close (x) button is visible on top right of the Drawer dialog or not. | boolean | true | 3.7.0 |
+| destroyOnClose | Whether to unmount child components on closing drawer or not. | boolean | false | 3.7.0 |
+| getContainer | Return the mounted node for Drawer. | HTMLElement \| `() => HTMLElement` \| Selectors \| false | 'body' | 3.7.0 |
+| mask | Whether to show mask or not. | Boolean | true | 3.7.0 |
+| maskClosable | Clicking on the mask (area outside the Drawer) to close the Drawer or not. | boolean | true | 3.7.0 |
+| maskStyle | Style for Drawer's mask element. | object | {} | 3.7.0 |
+| style | Style of drawer wrapper | object | - | 3.7.0 |
+| bodyStyle | Style of floating layer, typically used for adjusting its position. | object | - | 3.12.0 |
+| title | The title for Drawer. | string\|ReactNode | - | 3.7.0 |
+| visible | Whether the Drawer dialog is visible or not. | boolean | false | 3.7.0 |
+| width | Width of the Drawer dialog. | string\|number | 256 | 3.7.0 |
+| height | placement is `top` or `bottom`, height of the Drawer dialog. | string\|number | - | 3.9.0 |
+| className | The class name of the container of the Drawer dialog. | string | - | 3.8.0 |
+| zIndex | The `z-index` of the Drawer. | Number | 1000 | 3.7.0 |
+| placement | The placement of the Drawer. | 'top' \| 'right' \| 'bottom' \| 'left' | 'right' | 3.7.0 |
+| onClose | Specify a callback that will be called when a user clicks mask, close button or Cancel button. | function(e) | - | 3.7.0 |
+| afterVisibleChange | Callback after the animation ends when switching drawers. | function(visible) | - | 3.17.0 |
+| keyboard | Whether support press esc to close | Boolean | true | 3.19.8 |
 
 <style>
 #_hj_feedback_container {

components/drawer/index.tsx

@@ -20,7 +20,7 @@ type placementType = (typeof PlacementTypes)[number];
 export interface DrawerProps {
   closable?: boolean;
   destroyOnClose?: boolean;
-  getContainer?: string | HTMLElement | getContainerFunc;
+  getContainer?: string | HTMLElement | getContainerFunc | false;
   maskClosable?: boolean;
   mask?: boolean;
   maskStyle?: React.CSSProperties;
@@ -63,9 +63,19 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
     push: false,
   };
 
-  parentDrawer: Drawer;
+  parentDrawer: Drawer | null;
+
   destroyClose: boolean;
 
+  public componentDidMount() {
+    // fix: delete drawer in child and re-render, no push started.
+    // <Drawer>{show && <Drawer />}</Drawer>
+    const { visible } = this.props;
+    if (visible && this.parentDrawer) {
+      this.parentDrawer.push();
+    }
+  }
+
   public componentDidUpdate(preProps: DrawerProps) {
     const { visible } = this.props;
     if (preProps.visible !== visible && this.parentDrawer) {
@@ -77,19 +87,13 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
     }
   }
 
-  close = (e: EventType) => {
-    const { visible, onClose } = this.props;
-    if (visible !== undefined && onClose) {
-      onClose(e);
+  public componentWillUnmount() {
+    // unmount drawer in child, clear push.
+    if (this.parentDrawer) {
+      this.parentDrawer.pull();
+      this.parentDrawer = null;
     }
-  };
-
-  onMaskClick = (e: EventType) => {
-    if (!this.props.maskClosable && !(e.nativeEvent instanceof KeyboardEvent)) {
-      return;
-    }
-    this.close(e);
-  };
+  }
 
   push = () => {
     this.setState({
@@ -116,7 +120,7 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
 
   getDestroyOnClose = () => this.props.destroyOnClose && !this.props.visible;
 
-  // get drawar push width or height
+  // get drawer push width or height
   getPushTransform = (placement?: placementType) => {
     if (placement === 'left' || placement === 'right') {
       return `translateX(${placement === 'left' ? 180 : -180}px)`;
@@ -152,10 +156,10 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
   }
 
   renderCloseIcon() {
-    const { closable, prefixCls } = this.props;
+    const { closable, prefixCls, onClose } = this.props;
     return (
       closable && (
-        <button onClick={this.close} aria-label="Close" className={`${prefixCls}-close`}>
+        <button onClick={onClose} aria-label="Close" className={`${prefixCls}-close`}>
           <Icon type="close" />
         </button>
       )
@@ -200,7 +204,7 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
     );
   };
 
-  // render Provider for Multi-level drawe
+  // render Provider for Multi-level drawer
   renderProvider = (value: Drawer) => {
     const {
       prefixCls,
@@ -214,11 +218,9 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
       closable,
       destroyOnClose,
       mask,
-      maskClosable,
       bodyStyle,
       title,
       push,
-      onClose,
       visible,
       // ConfigConsumerProps
       getPopupContainer,
@@ -250,7 +252,6 @@ class Drawer extends React.Component<DrawerProps & ConfigConsumerProps, IDrawerS
           {...offsetStyle}
           prefixCls={prefixCls}
           open={this.props.visible}
-          onMaskClick={this.onMaskClick}
           showMask={mask}
           placement={placement}
           style={this.getRcDrawerStyle()}

components/drawer/index.zh-CN.md

@@ -16,26 +16,26 @@ title: Drawer
 
 ## API
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| closable | 是否显示右上角的关闭按钮 | boolean | true |
-| destroyOnClose | 关闭时销毁 Drawer 里的子元素 | boolean | false |
-| getContainer | 指定 Drawer 挂载的 HTML 节点 | HTMLElement \| `() => HTMLElement` \| Selectors | 'body' |
-| maskClosable | 点击蒙层是否允许关闭 | boolean | true |
-| mask | 是否展示遮罩 | Boolean | true |
-| maskStyle | 遮罩样式 | object | {} |
-| style | 可用于设置 Drawer 最外层容器的样式 | object | - |
-| bodyStyle | 可用于设置 Drawer 的样式，调整浮层位置等 | object | - |
-| title | 标题 | string \| ReactNode | - |
-| visible | Drawer 是否可见 | boolean | - |
-| width | 宽度 | string \| number | 256 |
-| height | 高度, 在 `placement` 为 `top` 或 `bottom` 时使用 | string \| number | 256 |
-| className | 对话框外层容器的类名 | string | - |
-| zIndex | 设置 Drawer 的 `z-index` | Number | 1000 |
-| placement | 抽屉的方向 | 'top' \| 'right' \| 'bottom' \| 'left' | 'right' |
-| onClose | 点击遮罩层或右上角叉或取消按钮的回调 | function(e) | 无 |
-| afterVisibleChange | 切换抽屉时动画结束后的回调 | function(visible) | 无 |
-| keyboard | 是否支持键盘 esc 关闭 | boolean | true |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| closable | 是否显示右上角的关闭按钮 | boolean | true | 3.7.0 |
+| destroyOnClose | 关闭时销毁 Drawer 里的子元素 | boolean | false | 3.7.0 |
+| getContainer | 指定 Drawer 挂载的 HTML 节点, false 为挂载在当前 dom | HTMLElement \| `() => HTMLElement` \| Selectors \| false | 'body' | 3.7.0 |
+| maskClosable | 点击蒙层是否允许关闭 | boolean | true | 3.7.0 |
+| mask | 是否展示遮罩 | Boolean | true | 3.7.0 |
+| maskStyle | 遮罩样式 | object | {} | 3.7.0 |
+| style | 可用于设置 Drawer 最外层容器的样式 | object | - | 3.7.0 |
+| bodyStyle | 可用于设置 Drawer 的样式，调整浮层位置等 | object | - | 3.12.0 |
+| title | 标题 | string \| ReactNode | - | 3.7.0 |
+| visible | Drawer 是否可见 | boolean | - | 3.7.0 |
+| width | 宽度 | string \| number | 256 | 3.7.0 |
+| height | 高度, 在 `placement` 为 `top` 或 `bottom` 时使用 | string \| number | 256 | 3.9.0 |
+| className | 对话框外层容器的类名 | string | - | 3.8.0 |
+| zIndex | 设置 Drawer 的 `z-index` | Number | 1000 | 3.7.0 |
+| placement | 抽屉的方向 | 'top' \| 'right' \| 'bottom' \| 'left' | 'right' | 3.7.0 |
+| onClose | 点击遮罩层或右上角叉或取消按钮的回调 | function(e) | 无 | 3.7.0 |
+| afterVisibleChange | 切换抽屉时动画结束后的回调 | function(visible) | 无 | 3.17.0 |
+| keyboard | 是否支持键盘 esc 关闭 | boolean | true | 3.19.8 |
 
 <style>
 #_hj_feedback_container {

components/drawer/style/drawer.less

@@ -11,10 +11,10 @@
   z-index: @zindex-modal;
   width: 0%;
   height: 100%;
-
+  transition: transform @animation-duration-slow @ease-base-out;
   > * {
-    transition: transform @animation-duration-slow @ease-base-in,
-      box-shadow @animation-duration-slow @ease-base-in;
+    transition: transform @animation-duration-slow @ease-base-out,
+      box-shadow @animation-duration-slow @ease-base-out;
   }
 
   &-content-wrapper {
@@ -197,7 +197,6 @@
     transition: opacity @animation-duration-slow linear, height 0s ease @animation-duration-slow;
   }
   &-open {
-    transition: transform @animation-duration-slow @ease-base-out;
     &-content {
       box-shadow: @shadow-2;
     }

components/dropdown/index.en-US.md

@@ -14,17 +14,17 @@ If there are too many operations to display, you can wrap them in a `Dropdown`.
 
 ### Dropdown
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| disabled | whether the dropdown menu is disabled | boolean | - |
-| getPopupContainer | to set the container of the dropdown menu. The default is to create a `div` element in `body`, you can reset it to the scrolling area and make a relative reposition. [example](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | `() => document.body` |
-| overlay | the dropdown menu | [Menu](/components/menu) \| () => Menu | - |
-| overlayClassName | Class name of the dropdown root element | string | - |
-| overlayStyle | Style of the dropdown root element | object | - |
-| placement | placement of pop menu: `bottomLeft` `bottomCenter` `bottomRight` `topLeft` `topCenter` `topRight` | String | `bottomLeft` |
-| trigger | the trigger mode which executes the drop-down action, hover doesn't work on mobile device | Array<`click`\|`hover`\|`contextMenu`> | `['hover']` |
-| visible | whether the dropdown menu is visible | boolean | - |
-| onVisibleChange | a callback function takes an argument: `visible`, is executed when the visible state is changed | Function(visible) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| disabled | whether the dropdown menu is disabled | boolean | - |  |
+| getPopupContainer | to set the container of the dropdown menu. The default is to create a `div` element in `body`, you can reset it to the scrolling area and make a relative reposition. [example](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | `() => document.body` |  |
+| overlay | the dropdown menu | [Menu](/components/menu) \| () => Menu | - |  |
+| overlayClassName | Class name of the dropdown root element | string | - | 3.11.0 |
+| overlayStyle | Style of the dropdown root element | object | - | 3.11.0 |
+| placement | placement of pop menu: `bottomLeft` `bottomCenter` `bottomRight` `topLeft` `topCenter` `topRight` | String | `bottomLeft` |  |
+| trigger | the trigger mode which executes the drop-down action, hover doesn't work on mobile device | Array<`click`\|`hover`\|`contextMenu`> | `['hover']` |  |
+| visible | whether the dropdown menu is visible | boolean | - |  |
+| onVisibleChange | a callback function takes an argument: `visible`, is executed when the visible state is changed | Function(visible) | - |  |
 
 You should use [Menu](/components/menu/) as `overlay`. The menu items and dividers are also available by using `Menu.Item` and `Menu.Divider`.
 

components/dropdown/index.zh-CN.md

@@ -15,17 +15,17 @@ title: Dropdown
 
 属性如下
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| disabled | 菜单是否禁用 | boolean | - |
-| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | `() => document.body` |
-| overlay | 菜单 | [Menu](/components/menu) \| () => Menu | - |
-| overlayClassName | 下拉根元素的类名称 | string | - |
-| overlayStyle | 下拉根元素的样式 | object | - |
-| placement | 菜单弹出位置：`bottomLeft` `bottomCenter` `bottomRight` `topLeft` `topCenter` `topRight` | String | `bottomLeft` |
-| trigger | 触发下拉的行为, 移动端不支持 hover | Array<`click`\|`hover`\|`contextMenu`> | `['hover']` |
-| visible | 菜单是否显示 | boolean | - |
-| onVisibleChange | 菜单显示状态改变时调用，参数为 visible | Function(visible) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| disabled | 菜单是否禁用 | boolean | - |  |
+| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。[示例](https://codepen.io/afc163/pen/zEjNOy?editors=0010) | Function(triggerNode) | `() => document.body` |  |
+| overlay | 菜单 | [Menu](/components/menu) \| () => Menu | - |  |
+| overlayClassName | 下拉根元素的类名称 | string | - | 3.11.0 |
+| overlayStyle | 下拉根元素的样式 | object | - | 3.11.0 |
+| placement | 菜单弹出位置：`bottomLeft` `bottomCenter` `bottomRight` `topLeft` `topCenter` `topRight` | String | `bottomLeft` |  |
+| trigger | 触发下拉的行为, 移动端不支持 hover | Array<`click`\|`hover`\|`contextMenu`> | `['hover']` |  |
+| visible | 菜单是否显示 | boolean | - |  |
+| onVisibleChange | 菜单显示状态改变时调用，参数为 visible | Function(visible) | - |  |
 
 `overlay` 菜单使用 [Menu](/components/menu/)，还包括菜单项 `Menu.Item`，分割线 `Menu.Divider`。
 
@@ -37,7 +37,7 @@ title: Dropdown
 
 | 参数 | 说明 | 类型 | 默认值 | 版本 |
 | --- | --- | --- | --- | --- |
-| disabled | 菜单是否禁用 | boolean | - |  |  |
+| disabled | 菜单是否禁用 | boolean | - |  |
 | icon | 右侧的 icon | ReactNode | - | 3.17.0 |
 | overlay | 菜单 | [Menu](/components/menu/) | - |  |
 | placement | 菜单弹出位置：`bottomLeft` `bottomCenter` `bottomRight` `topLeft` `topCenter` `topRight` | String | `bottomLeft` |  |

components/empty/__tests__/__snapshots__/demo.test.js.snap

@@ -531,6 +531,21 @@ exports[`renders ./components/empty/demo/customize.md correctly 1`] = `
 </div>
 `;
 
+exports[`renders ./components/empty/demo/description.md correctly 1`] = `
+<div
+  class="ant-empty"
+>
+  <div
+    class="ant-empty-image"
+  >
+    <img
+      alt="empty"
+      src="data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTg0IiBoZWlnaHQ9IjE1MiIgdmlld0JveD0iMCAwIDE4NCAxNTIiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CiAgPGcgZmlsbD0ibm9uZSIgZmlsbC1ydWxlPSJldmVub2RkIj4KICAgIDxnIHRyYW5zZm9ybT0idHJhbnNsYXRlKDI0IDMxLjY3KSI+CiAgICAgIDxlbGxpcHNlIGZpbGwtb3BhY2l0eT0iLjgiIGZpbGw9IiNGNUY1RjciIGN4PSI2Ny43OTciIGN5PSIxMDYuODkiIHJ4PSI2Ny43OTciIHJ5PSIxMi42NjgiLz4KICAgICAgPHBhdGggZD0iTTEyMi4wMzQgNjkuNjc0TDk4LjEwOSA0MC4yMjljLTEuMTQ4LTEuMzg2LTIuODI2LTIuMjI1LTQuNTkzLTIuMjI1aC01MS40NGMtMS43NjYgMC0zLjQ0NC44MzktNC41OTIgMi4yMjVMMTMuNTYgNjkuNjc0djE1LjM4M2gxMDguNDc1VjY5LjY3NHoiIGZpbGw9IiNBRUI4QzIiLz4KICAgICAgPHBhdGggZD0iTTEwMS41MzcgODYuMjE0TDgwLjYzIDYxLjEwMmMtMS4wMDEtMS4yMDctMi41MDctMS44NjctNC4wNDgtMS44NjdIMzEuNzI0Yy0xLjU0IDAtMy4wNDcuNjYtNC4wNDggMS44NjdMNi43NjkgODYuMjE0djEzLjc5Mmg5NC43NjhWODYuMjE0eiIgZmlsbD0idXJsKCNsaW5lYXJHcmFkaWVudC0xKSIgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMTMuNTYpIi8+CiAgICAgIDxwYXRoIGQ9Ik0zMy44MyAwaDY3LjkzM2E0IDQgMCAwIDEgNCA0djkzLjM0NGE0IDQgMCAwIDEtNCA0SDMzLjgzYTQgNCAwIDAgMS00LTRWNGE0IDQgMCAwIDEgNC00eiIgZmlsbD0iI0Y1RjVGNyIvPgogICAgICA8cGF0aCBkPSJNNDIuNjc4IDkuOTUzaDUwLjIzN2EyIDIgMCAwIDEgMiAyVjM2LjkxYTIgMiAwIDAgMS0yIDJINDIuNjc4YTIgMiAwIDAgMS0yLTJWMTEuOTUzYTIgMiAwIDAgMSAyLTJ6TTQyLjk0IDQ5Ljc2N2g0OS43MTNhMi4yNjIgMi4yNjIgMCAxIDEgMCA0LjUyNEg0Mi45NGEyLjI2MiAyLjI2MiAwIDAgMSAwLTQuNTI0ek00Mi45NCA2MS41M2g0OS43MTNhMi4yNjIgMi4yNjIgMCAxIDEgMCA0LjUyNUg0Mi45NGEyLjI2MiAyLjI2MiAwIDAgMSAwLTQuNTI1ek0xMjEuODEzIDEwNS4wMzJjLS43NzUgMy4wNzEtMy40OTcgNS4zNi02LjczNSA1LjM2SDIwLjUxNWMtMy4yMzggMC01Ljk2LTIuMjktNi43MzQtNS4zNmE3LjMwOSA3LjMwOSAwIDAgMS0uMjIyLTEuNzlWNjkuNjc1aDI2LjMxOGMyLjkwNyAwIDUuMjUgMi40NDggNS4yNSA1LjQydi4wNGMwIDIuOTcxIDIuMzcgNS4zNyA1LjI3NyA1LjM3aDM0Ljc4NWMyLjkwNyAwIDUuMjc3LTIuNDIxIDUuMjc3LTUuMzkzVjc1LjFjMC0yLjk3MiAyLjM0My01LjQyNiA1LjI1LTUuNDI2aDI2LjMxOHYzMy41NjljMCAuNjE3LS4wNzcgMS4yMTYtLjIyMSAxLjc4OXoiIGZpbGw9IiNEQ0UwRTYiLz4KICAgIDwvZz4KICAgIDxwYXRoIGQ9Ik0xNDkuMTIxIDMzLjI5MmwtNi44MyAyLjY1YTEgMSAwIDAgMS0xLjMxNy0xLjIzbDEuOTM3LTYuMjA3Yy0yLjU4OS0yLjk0NC00LjEwOS02LjUzNC00LjEwOS0xMC40MDhDMTM4LjgwMiA4LjEwMiAxNDguOTIgMCAxNjEuNDAyIDAgMTczLjg4MSAwIDE4NCA4LjEwMiAxODQgMTguMDk3YzAgOS45OTUtMTAuMTE4IDE4LjA5Ny0yMi41OTkgMTguMDk3LTQuNTI4IDAtOC43NDQtMS4wNjYtMTIuMjgtMi45MDJ6IiBmaWxsPSIjRENFMEU2Ii8+CiAgICA8ZyB0cmFuc2Zvcm09InRyYW5zbGF0ZSgxNDkuNjUgMTUuMzgzKSIgZmlsbD0iI0ZGRiI+CiAgICAgIDxlbGxpcHNlIGN4PSIyMC42NTQiIGN5PSIzLjE2NyIgcng9IjIuODQ5IiByeT0iMi44MTUiLz4KICAgICAgPHBhdGggZD0iTTUuNjk4IDUuNjNIMEwyLjg5OC43MDR6TTkuMjU5LjcwNGg0Ljk4NVY1LjYzSDkuMjU5eiIvPgogICAgPC9nPgogIDwvZz4KPC9zdmc+Cg=="
+    />
+  </div>
+</div>
+`;
+
 exports[`renders ./components/empty/demo/simple.md correctly 1`] = `
 <div
   class="ant-empty ant-empty-normal"

components/empty/__tests__/index.test.js

@@ -7,4 +7,9 @@ describe('Empty', () => {
     const wrapper = mount(<Empty imageStyle={{ height: 20 }} />);
     expect(wrapper.find('.ant-empty-image').props().style.height).toBe(20);
   });
+
+  it('description can be false', () => {
+    const wrapper = mount(<Empty description={false} />);
+    expect(wrapper.find('.ant-empty-description').length).toBe(0);
+  });
 });

components/empty/demo/description.md

@@ -0,0 +1,20 @@
+---
+order: 4
+title:
+  zh-CN: 无描述
+  en-US: No description
+---
+
+## zh-CN
+
+无描述展示。
+
+## en-US
+
+Simplest Usage with no description.
+
+```jsx
+import { Empty } from 'antd';
+
+ReactDOM.render(<Empty description={false} />, mountNode);
+```

components/empty/index.en-US.md

@@ -20,11 +20,11 @@ Empty state placeholder.
 </Empty>
 ```
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| description | Customize description | string \| ReactNode | - |
-| imageStyle | style of image | CSSProperties | - |
-| image | Customize image. Will tread as image url when string provided. | string \| ReactNode | `Empty.PRESENTED_IMAGE_DEFAULT` |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| description | Customize description | string \| ReactNode | - | 3.12.0 |
+| imageStyle | style of image | CSSProperties | - | 3.16.0 |
+| image | Customize image. Will tread as image url when string provided. | string \| ReactNode | `Empty.PRESENTED_IMAGE_DEFAULT` | 3.12.0 |
 
 ## Built-in images
 

components/empty/index.tsx

@@ -39,7 +39,7 @@ const OriginEmpty: React.SFC<EmptyProps> = (props: EmptyProps) => (
         <LocaleReceiver componentName="Empty">
           {(locale: TransferLocale) => {
             const prefixCls = getPrefixCls('empty', customizePrefixCls);
-            const des = description || locale.description;
+            const des = typeof description !== 'undefined' ? description : locale.description;
             const alt = typeof des === 'string' ? des : 'empty';
 
             let imageNode: React.ReactNode = null;
@@ -64,7 +64,7 @@ const OriginEmpty: React.SFC<EmptyProps> = (props: EmptyProps) => (
                 <div className={`${prefixCls}-image`} style={imageStyle}>
                   {imageNode}
                 </div>
-                <p className={`${prefixCls}-description`}>{des}</p>
+                {des && <p className={`${prefixCls}-description`}>{des}</p>}
                 {children && <div className={`${prefixCls}-footer`}>{children}</div>}
               </div>
             );

components/empty/index.zh-CN.md

@@ -21,11 +21,11 @@ cols: 1
 </Empty>
 ```
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| description | 自定义描述内容 | string \| ReactNode | - |
-| imageStyle | 图片样式 | CSSProperties | - |
-| image | 设置显示图片，为 string 时表示自定义图片地址。 | string \| ReactNode | `Empty.PRESENTED_IMAGE_DEFAULT` |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| description | 自定义描述内容 | string \| ReactNode | - | 3.12.0 |
+| imageStyle | 图片样式 | CSSProperties | - | 3.16.0 |
+| image | 设置显示图片，为 string 时表示自定义图片地址。 | string \| ReactNode | `Empty.PRESENTED_IMAGE_DEFAULT` | 3.12.0 |
 
 ## 内置图片 (3.16.0 以上版本)
 

components/form/Form.tsx

@@ -141,7 +141,7 @@ export type WrappedFormUtils<V = any> = {
   /** 获取一个输入控件的值 */
   getFieldValue(fieldName: string): any;
   /** 设置一组输入控件的值 */
-  setFieldsValue(obj: Object): void;
+  setFieldsValue(obj: Object, callback?: Function): void;
   /** 设置一组输入控件的值 */
   setFields(obj: Object): void;
   /** 校验并获取一组输入域的值与 Error */

components/form/index.en-US.md

@@ -34,16 +34,16 @@ A form consists of one or more form fields whose type includes input, textarea,
 
 **more example [rc-form](http://react-component.github.io/form/)**。
 
-| Property | Description | Type | Default Value |
-| --- | --- | --- | --- |
-| form | Decorated by `Form.create()` will be automatically set `this.props.form` property | object | n/a |
-| hideRequiredMark | Hide required mark of all form items | Boolean | false |
-| labelAlign | Label text align | 'left' \| 'right' | 'right' |
-| labelCol | (Added in 3.14.0. Previous version can only set on FormItem.) The layout of label. You can set `span` `offset` to something like `{span: 3, offset: 12}` or `sm: {span: 3, offset: 12}` same as with `<Col>` | [object](https://ant.design/components/grid/#Col) |  |
-| layout | Define form layout | 'horizontal'\|'vertical'\|'inline' | 'horizontal' |
-| onSubmit | Defines a function will be called if form data validation is successful. | Function(e:Event) |  |
-| wrapperCol | (Added in 3.14.0. Previous version can only set on FormItem.) The layout for input controls, same as `labelCol` | [object](https://ant.design/components/grid/#Col) |  |
-| colon | change default props colon value of Form.Item | boolean | true |
+| Property | Description | Type | Default Value | Version |
+| --- | --- | --- | --- | --- |
+| form | Decorated by `Form.create()` will be automatically set `this.props.form` property | object | n/a |  |
+| hideRequiredMark | Hide required mark of all form items | Boolean | false |  |
+| labelAlign | Label text align | 'left' \| 'right' | 'right' | 3.15.0 |
+| labelCol | (Added in 3.14.0. Previous version can only set on FormItem.) The layout of label. You can set `span` `offset` to something like `{span: 3, offset: 12}` or `sm: {span: 3, offset: 12}` same as with `<Col>` | [object](https://ant.design/components/grid/#Col) |  | 3.14.0 |
+| layout | Define form layout | 'horizontal'\|'vertical'\|'inline' | 'horizontal' |  |
+| onSubmit | Defines a function will be called if form data validation is successful. | Function(e:Event) |  |  |
+| wrapperCol | (Added in 3.14.0. Previous version can only set on FormItem.) The layout for input controls, same as `labelCol` | [object](https://ant.design/components/grid/#Col) |  | 3.14.0 |
+| colon | change default props colon value of Form.Item | boolean | true | 3.15.0 |
 
 ### Form.create(options)
 
@@ -57,13 +57,13 @@ CustomizedForm = Form.create({})(CustomizedForm);
 
 The following `options` are available:
 
-| Property | Description | Type |
-| --- | --- | --- |
-| mapPropsToFields | Convert props to field value(e.g. reading the values from Redux store). And you must mark returned fields with [`Form.createFormField`](#Form.createFormField). Please note that the form fields will become controlled components. Properties like errors will not be automatically mapped and need to be manually passed in. | (props) => ({ \[fieldName\]: FormField { value } }) |
-| name | Set the id prefix of fields under form | - |
-| validateMessages | Default validate message. And its format is similar with [newMessages](https://github.com/yiminghe/async-validator/blob/master/src/messages.js)'s returned value | Object { \[nested.path]: String } |
-| onFieldsChange | Specify a function that will be called when the fields (including errors) of a `Form.Item` gets changed. Usage example: saving the field's value to Redux store. | Function(props, changedFields, allFields) |
-| onValuesChange | A handler while value of any field is changed | (props, changedValues, allValues) => void |
+| Property | Description | Type | Version |
+| --- | --- | --- | --- |
+| mapPropsToFields | Convert props to field value(e.g. reading the values from Redux store). And you must mark returned fields with [`Form.createFormField`](#Form.createFormField). Please note that the form fields will become controlled components. Properties like errors will not be automatically mapped and need to be manually passed in. | (props) => ({ \[fieldName\]: FormField { value } }) |  |
+| name | Set the id prefix of fields under form | - | 3.12.0 |
+| validateMessages | Default validate message. And its format is similar with [newMessages](https://github.com/yiminghe/async-validator/blob/master/src/messages.js)'s returned value | Object { \[nested.path]: String } |  |
+| onFieldsChange | Specify a function that will be called when the fields (including errors) of a `Form.Item` gets changed. Usage example: saving the field's value to Redux store. | Function(props, changedFields, allFields) |  |
+| onValuesChange | A handler while value of any field is changed | (props, changedValues, allValues) => void |  |
 
 If you want to get `ref` after `Form.create`, you can use `wrappedComponentRef` provided by `rc-form`, [details can be viewed here](https://github.com/react-component/form#note-use-wrappedcomponentref-instead-of-withref-after-rc-form140).
 
@@ -80,21 +80,21 @@ If the form has been decorated by `Form.create` then it has `this.props.form` pr
 
 > Note: Before using `getFieldsValue` `getFieldValue` `setFieldsValue` and so on, please make sure that corresponding field had been registered with `getFieldDecorator`.
 
-| Method | Description | Type |
-| --- | --- | --- |
+| Method | Description | Type | Version |
+| --- | --- | --- | --- |
 | getFieldDecorator | Two-way binding for form, please read below for details. |  |
-| getFieldError | Get the error of a field. | Function(name) |
-| getFieldsError | Get the specified fields' error. If you don't specify a parameter, you will get all fields' error. | Function(\[names: string\[]]) |
-| getFieldsValue | Get the specified fields' values. If you don't specify a parameter, you will get all fields' values. | Function(\[fieldNames: string\[]]) |
-| getFieldValue | Get the value of a field. | Function(fieldName: string) |
-| isFieldsTouched | Check whether any of fields is touched by `getFieldDecorator`'s `options.trigger` event | (names?: string\[]) => boolean |
-| isFieldTouched | Check whether a field is touched by `getFieldDecorator`'s `options.trigger` event | (name: string) => boolean |
-| isFieldValidating | Check if the specified field is being validated. | Function(name) |
-| resetFields | Reset the specified fields' value(to `initialValue`) and status. If you don't specify a parameter, all the fields will be reset. | Function(\[names: string\[]]) |
-| setFields | Set value and error state of fields. [Code Sample](https://github.com/react-component/form/blob/3b9959b57ab30b41d8890ff30c79a7e7c383cad3/examples/server-validate.js#L74-L79) | ({<br />&nbsp;&nbsp;\[fieldName\]: {value: any, errors: \[Error\] }<br />}) => void |
-| setFieldsValue | Set the value of a field. (Note: please don't use it in `componentWillReceiveProps`, otherwise, it will cause an endless loop, [reason](https://github.com/ant-design/ant-design/issues/2985)) | ({ \[fieldName\]&#x3A; value }) => void |
-| validateFields | Validate the specified fields and get theirs values and errors. If you don't specify the parameter of fieldNames, you will validate all fields. | (<br />&nbsp;&nbsp;\[fieldNames: string\[]],<br />&nbsp;&nbsp;\[options: object\],<br />&nbsp;&nbsp;callback(errors, values)<br />) => void |
-| validateFieldsAndScroll | This function is similar to `validateFields`, but after validation, if the target field is not in visible area of form, form will be automatically scrolled to the target field area. | same as `validateFields` |
+| getFieldError | Get the error of a field. | Function(name) |  |
+| getFieldsError | Get the specified fields' error. If you don't specify a parameter, you will get all fields' error. | Function(\[names: string\[]]) |  |
+| getFieldsValue | Get the specified fields' values. If you don't specify a parameter, you will get all fields' values. | Function(\[fieldNames: string\[]]) |  |
+| getFieldValue | Get the value of a field. | Function(fieldName: string) |  |
+| isFieldsTouched | Check whether any of fields is touched by `getFieldDecorator`'s `options.trigger` event | (names?: string\[]) => boolean |  |
+| isFieldTouched | Check whether a field is touched by `getFieldDecorator`'s `options.trigger` event | (name: string) => boolean |  |
+| isFieldValidating | Check if the specified field is being validated. | Function(name) |  |
+| resetFields | Reset the specified fields' value(to `initialValue`) and status. If you don't specify a parameter, all the fields will be reset. | Function(\[names: string\[]]) |  |
+| setFields | Set value and error state of fields. [Code Sample](https://github.com/react-component/form/blob/3b9959b57ab30b41d8890ff30c79a7e7c383cad3/examples/server-validate.js#L74-L79) | ({<br />&nbsp;&nbsp;\[fieldName\]: {value: any, errors: \[Error\] }<br />}) => void |  |
+| setFieldsValue | Set the value of a field. (Note: please don't use it in `componentWillReceiveProps`, otherwise, it will cause an endless loop, [reason](https://github.com/ant-design/ant-design/issues/2985)) | (<br />&nbsp;&nbsp;{ \[fieldName\]&#x3A; value },<br />&nbsp;&nbsp;callback: Function<br />) => void |  |
+| validateFields | Validate the specified fields and get theirs values and errors. If you don't specify the parameter of fieldNames, you will validate all fields. | (<br />&nbsp;&nbsp;\[fieldNames: string\[]],<br />&nbsp;&nbsp;\[options: object\],<br />&nbsp;&nbsp;callback(errors, values)<br />) => void |  |
+| validateFieldsAndScroll | This function is similar to `validateFields`, but after validation, if the target field is not in visible area of form, form will be automatically scrolled to the target field area. | same as `validateFields` |  |
 
 ### validateFields/validateFieldsAndScroll
 
@@ -113,12 +113,12 @@ validateFields(['field1', 'field2'], options, (errors, values) => {
 });
 ```
 
-| Method | Description | Type | Default |
-| --- | --- | --- | --- |
-| options.first | If `true`, every field will stop validation at first failed rule | boolean | false |
-| options.firstFields | Those fields will stop validation at first failed rule | String\[] | \[] |
-| options.force | Should validate validated field again when `validateTrigger` is been triggered again | boolean | false |
-| options.scroll | Config scroll behavior of `validateFieldsAndScroll`, more: [dom-scroll-into-view's config](https://github.com/yiminghe/dom-scroll-into-view#function-parameter) | Object | {} |
+| Method | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| options.first | If `true`, every field will stop validation at first failed rule | boolean | false | 3.9.3 |
+| options.firstFields | Those fields will stop validation at first failed rule | String\[] | \[] | 3.9.3 |
+| options.force | Should validate validated field again when `validateTrigger` is been triggered again | boolean | false | 3.9.3 |
+| options.scroll | Config scroll behavior of `validateFieldsAndScroll`, more: [dom-scroll-into-view's config](https://github.com/yiminghe/dom-scroll-into-view#function-parameter) | Object | {} | 3.9.3 |
 
 #### Callback arguments example of validateFields
 
@@ -172,19 +172,19 @@ If you use `react@<15.3.0`, then, you can't use `getFieldDecorator` in stateless
 
 #### getFieldDecorator(id, options) parameters
 
-| Property | Description | Type | Default Value |
-| --- | --- | --- | --- |
-| id | The unique identifier is required. support [nested fields format](https://github.com/react-component/form/pull/48). | string |  |
-| options.getValueFromEvent | Specify how to get value from event or other onChange arguments | function(..args) | [reference](https://github.com/react-component/form#option-object) |
-| options.getValueProps | Get the component props according to field value. | function(value): any | [reference](https://github.com/react-component/form#option-object) |
-| options.initialValue | You can specify initial value, type, optional value of children node. (Note: Because `Form` will test equality with `===` internally, we recommend to use variable as `initialValue`, instead of literal) |  | n/a |
-| options.normalize | Normalize value to form component, [a select-all example](https://codepen.io/afc163/pen/JJVXzG?editors=001) | function(value, prevValue, allValues): any | - |
-| options.preserve | Keep the field even if field removed | boolean | - |
-| options.rules | Includes validation rules. Please refer to "Validation Rules" part for details. | object\[] | n/a |
-| options.trigger | When to collect the value of children node | string | 'onChange' |
-| options.validateFirst | Whether stop validate on first rule of error for this field. | boolean | false |
-| options.validateTrigger | When to validate the value of children node. | string\|string\[] | 'onChange' |
-| options.valuePropName | Props of children node, for example, the prop of Switch is 'checked'. | string | 'value' |
+| Property | Description | Type | Default Value | Version |
+| --- | --- | --- | --- | --- |
+| id | The unique identifier is required. support [nested fields format](https://github.com/react-component/form/pull/48). | string |  |  |
+| options.getValueFromEvent | Specify how to get value from event or other onChange arguments | function(..args) | [reference](https://github.com/react-component/form#option-object) |  |
+| options.getValueProps | Get the component props according to field value. | function(value): any | [reference](https://github.com/react-component/form#option-object) | 3.9.0 |
+| options.initialValue | You can specify initial value, type, optional value of children node. (Note: Because `Form` will test equality with `===` internally, we recommend to use variable as `initialValue`, instead of literal) |  | n/a |  |
+| options.normalize | Normalize value to form component, [a select-all example](https://codepen.io/afc163/pen/JJVXzG?editors=001) | function(value, prevValue, allValues): any | - |  |
+| options.preserve | Keep the field even if field removed | boolean | - | 3.12.0 |
+| options.rules | Includes validation rules. Please refer to "Validation Rules" part for details. | object\[] | n/a |  |
+| options.trigger | When to collect the value of children node | string | 'onChange' |  |
+| options.validateFirst | Whether stop validate on first rule of error for this field. | boolean | false |  |
+| options.validateTrigger | When to validate the value of children node. | string\|string\[] | 'onChange' |  |
+| options.valuePropName | Props of children node, for example, the prop of Switch is 'checked'. | string | 'value' |  |
 
 More option at [rc-form option](https://github.com/react-component/form#option-object)。
 
@@ -207,19 +207,19 @@ Note: if Form.Item has multiple children that had been decorated by `getFieldDec
 
 ### Validation Rules
 
-| Property | Description | Type | Default Value |
-| --- | --- | --- | --- |
-| enum | validate a value from a list of possible values | string | - |
-| len | validate an exact length of a field | number | - |
-| max | validate a max length of a field | number | - |
-| message | validation error message | string\|ReactNode | - |
-| min | validate a min length of a field | number | - |
-| pattern | validate from a regular expression | RegExp | - |
-| required | indicates whether field is required | boolean | `false` |
-| transform | transform a value before validation | function(value) => transformedValue:any | - |
-| type | built-in validation type, [available options](https://github.com/yiminghe/async-validator#type) | string | 'string' |
-| validator | custom validate function (Note: [callback must be called](https://github.com/ant-design/ant-design/issues/5155)) | function(rule, value, callback) | - |
-| whitespace | treat required fields that only contain whitespace as errors | boolean | `false` |
+| Property | Description | Type | Default Value | Version |
+| --- | --- | --- | --- | --- |
+| enum | validate a value from a list of possible values | string | - |  |
+| len | validate an exact length of a field | number | - |  |
+| max | validate a max length of a field | number | - |  |
+| message | validation error message | string\|ReactNode | - |  |
+| min | validate a min length of a field | number | - |  |
+| pattern | validate from a regular expression | RegExp | - |  |
+| required | indicates whether field is required | boolean | `false` |  |
+| transform | transform a value before validation | function(value) => transformedValue:any | - |  |
+| type | built-in validation type, [available options](https://github.com/yiminghe/async-validator#type) | string | 'string' |  |
+| validator | custom validate function (Note: [callback must be called](https://github.com/ant-design/ant-design/issues/5155)) | function(rule, value, callback) | - |  |
+| whitespace | treat required fields that only contain whitespace as errors | boolean | `false` |  |
 
 See more advanced usage at [async-validator](https://github.com/yiminghe/async-validator).
 

components/form/index.zh-CN.md

@@ -37,16 +37,16 @@ title: Form
 
 **更多示例参考 [rc-form](http://react-component.github.io/form/)**。
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| form | 经 `Form.create()` 包装过的组件会自带 `this.props.form` 属性 | object | - |
-| hideRequiredMark | 隐藏所有表单项的必选标记 | Boolean | false |
-| labelAlign | label 标签的文本对齐方式 | 'left' \| 'right' | 'right' |
-| labelCol | （3.14.0 新增，之前的版本只能设置到 FormItem 上。）label 标签布局，同 `<Col>` 组件，设置 `span` `offset` 值，如 `{span: 3, offset: 12}` 或 `sm: {span: 3, offset: 12}` | [object](https://ant.design/components/grid/#Col) |  |
-| layout | 表单布局 | 'horizontal'\|'vertical'\|'inline' | 'horizontal' |
-| onSubmit | 数据验证成功后回调事件 | Function(e:Event) |  |
-| wrapperCol | （3.14.0 新增，之前的版本只能设置到 FormItem 上。）需要为输入控件设置布局样式时，使用该属性，用法同 labelCol | [object](https://ant.design/components/grid/#Col) |  |
-| colon | 配置 Form.Item 的 colon 的默认值 | boolean | true |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| form | 经 `Form.create()` 包装过的组件会自带 `this.props.form` 属性 | object | - |  |
+| hideRequiredMark | 隐藏所有表单项的必选标记 | Boolean | false |  |
+| labelAlign | label 标签的文本对齐方式 | 'left' \| 'right' | 'right' | 3.15.0 |
+| labelCol | （3.14.0 新增，之前的版本只能设置到 FormItem 上。）label 标签布局，同 `<Col>` 组件，设置 `span` `offset` 值，如 `{span: 3, offset: 12}` 或 `sm: {span: 3, offset: 12}` | [object](https://ant.design/components/grid/#Col) |  | 3.14.0 |
+| layout | 表单布局 | 'horizontal'\|'vertical'\|'inline' | 'horizontal' |  |
+| onSubmit | 数据验证成功后回调事件 | Function(e:Event) |  |  |
+| wrapperCol | （3.14.0 新增，之前的版本只能设置到 FormItem 上。）需要为输入控件设置布局样式时，使用该属性，用法同 labelCol | [object](https://ant.design/components/grid/#Col) |  | 3.14.0 |
+| colon | 配置 Form.Item 的 colon 的默认值 | boolean | true | 3.15.0 |
 
 ### Form.create(options)
 
@@ -60,13 +60,13 @@ CustomizedForm = Form.create({})(CustomizedForm);
 
 `options` 的配置项如下。
 
-| 参数 | 说明 | 类型 |
-| --- | --- | --- |
-| mapPropsToFields | 把父组件的属性映射到表单项上（如：把 Redux store 中的值读出），需要对返回值中的表单域数据用 [`Form.createFormField`](#Form.createFormField) 标记，注意表单项将变成受控组件, error 等也需要一并手动传入 | (props) => ({ \[fieldName\]: FormField { value } }) |
-| name | 设置表单域内字段 id 的前缀 | - |
-| validateMessages | 默认校验信息，可用于把默认错误信息改为中文等，格式与 [newMessages](https://github.com/yiminghe/async-validator/blob/master/src/messages.js) 返回值一致 | Object { \[nested.path]: String } |
-| onFieldsChange | 当 `Form.Item` 子节点的值（包括 error）发生改变时触发，可以把对应的值转存到 Redux store | Function(props, changedFields, allFields) |
-| onValuesChange | 任一表单域的值发生改变时的回调 | (props, changedValues, allValues) => void |
+| 参数 | 说明 | 类型 | 版本 |
+| --- | --- | --- | --- |
+| mapPropsToFields | 把父组件的属性映射到表单项上（如：把 Redux store 中的值读出），需要对返回值中的表单域数据用 [`Form.createFormField`](#Form.createFormField) 标记，注意表单项将变成受控组件, error 等也需要一并手动传入 | (props) => ({ \[fieldName\]: FormField { value } }) |  |
+| name | 设置表单域内字段 id 的前缀 | - | 3.12.0 |
+| validateMessages | 默认校验信息，可用于把默认错误信息改为中文等，格式与 [newMessages](https://github.com/yiminghe/async-validator/blob/master/src/messages.js) 返回值一致 | Object { \[nested.path]: String } |  |
+| onFieldsChange | 当 `Form.Item` 子节点的值（包括 error）发生改变时触发，可以把对应的值转存到 Redux store | Function(props, changedFields, allFields) |  |
+| onValuesChange | 任一表单域的值发生改变时的回调 | (props, changedValues, allValues) => void |  |
 
 经过 `Form.create` 之后如果要拿到 `ref`，可以使用 `rc-form` 提供的 `wrappedComponentRef`，[详细内容可以查看这里](https://github.com/react-component/form#note-use-wrappedcomponentref-instead-of-withref-after-rc-form140)。
 
@@ -83,21 +83,21 @@ this.form // => The instance of CustomizedForm
 
 > 注意：使用 `getFieldsValue` `getFieldValue` `setFieldsValue` 等时，应确保对应的 field 已经用 `getFieldDecorator` 注册过了。
 
-| 方法       | 说明                                     | 类型       |
-| --- | --- | --- |
+| 方法       | 说明                                     | 类型       | 版本 |
+| --- | --- | --- | --- |
 | getFieldDecorator | 用于和表单进行双向绑定，详见下方描述 |  |
-| getFieldError | 获取某个输入控件的 Error | Function(name) |
-| getFieldsError | 获取一组输入控件的 Error ，如不传入参数，则获取全部组件的 Error | Function(\[names: string\[]]) |
-| getFieldsValue | 获取一组输入控件的值，如不传入参数，则获取全部组件的值 | Function(\[fieldNames: string\[]]) |
-| getFieldValue | 获取一个输入控件的值 | Function(fieldName: string) |
-| isFieldsTouched | 判断是否任一输入控件经历过 `getFieldDecorator` 的值收集时机 `options.trigger` | (names?: string\[]) => boolean |
-| isFieldTouched | 判断一个输入控件是否经历过 `getFieldDecorator` 的值收集时机 `options.trigger` | (name: string) => boolean |
-| isFieldValidating | 判断一个输入控件是否在校验状态 | Function(name) |
-| resetFields | 重置一组输入控件的值（为 `initialValue`）与状态，如不传入参数，则重置所有组件 | Function(\[names: string\[]]) |
-| setFields | 设置一组输入控件的值与错误状态：[代码](https://github.com/react-component/form/blob/3b9959b57ab30b41d8890ff30c79a7e7c383cad3/examples/server-validate.js#L74-L79) | ({<br />&nbsp;&nbsp;\[fieldName\]: {value: any, errors: \[Error\] }<br />}) => void |
-| setFieldsValue | 设置一组输入控件的值（注意：不要在 `componentWillReceiveProps` 内使用，否则会导致死循环，[原因](https://github.com/ant-design/ant-design/issues/2985)） | ({ \[fieldName\]&#x3A; value }) => void |
-| validateFields | 校验并获取一组输入域的值与 Error，若 fieldNames 参数为空，则校验全部组件 | (<br />&nbsp;&nbsp;\[fieldNames: string\[]],<br />&nbsp;&nbsp;\[options: object\],<br />&nbsp;&nbsp;callback(errors, values)<br />) => void |
-| validateFieldsAndScroll | 与 `validateFields` 相似，但校验完后，如果校验不通过的菜单域不在可见范围内，则自动滚动进可见范围 | 参考 `validateFields` |
+| getFieldError | 获取某个输入控件的 Error | Function(name) |  |
+| getFieldsError | 获取一组输入控件的 Error ，如不传入参数，则获取全部组件的 Error | Function(\[names: string\[]]) |  |
+| getFieldsValue | 获取一组输入控件的值，如不传入参数，则获取全部组件的值 | Function(\[fieldNames: string\[]]) |  |
+| getFieldValue | 获取一个输入控件的值 | Function(fieldName: string) |  |
+| isFieldsTouched | 判断是否任一输入控件经历过 `getFieldDecorator` 的值收集时机 `options.trigger` | (names?: string\[]) => boolean |  |
+| isFieldTouched | 判断一个输入控件是否经历过 `getFieldDecorator` 的值收集时机 `options.trigger` | (name: string) => boolean |  |
+| isFieldValidating | 判断一个输入控件是否在校验状态 | Function(name) |  |
+| resetFields | 重置一组输入控件的值（为 `initialValue`）与状态，如不传入参数，则重置所有组件 | Function(\[names: string\[]]) |  |
+| setFields | 设置一组输入控件的值与错误状态：[代码](https://github.com/react-component/form/blob/3b9959b57ab30b41d8890ff30c79a7e7c383cad3/examples/server-validate.js#L74-L79) | ({<br />&nbsp;&nbsp;\[fieldName\]: {value: any, errors: \[Error\] }<br />}) => void |  |
+| setFieldsValue | 设置一组输入控件的值（注意：不要在 `componentWillReceiveProps` 内使用，否则会导致死循环，[原因](https://github.com/ant-design/ant-design/issues/2985)） | (<br />&nbsp;&nbsp;{ \[fieldName\]&#x3A; value },<br />&nbsp;&nbsp;callback: Function<br />) => void |  |
+| validateFields | 校验并获取一组输入域的值与 Error，若 fieldNames 参数为空，则校验全部组件 | (<br />&nbsp;&nbsp;\[fieldNames: string\[]],<br />&nbsp;&nbsp;\[options: object\],<br />&nbsp;&nbsp;callback(errors, values)<br />) => void |  |
+| validateFieldsAndScroll | 与 `validateFields` 相似，但校验完后，如果校验不通过的菜单域不在可见范围内，则自动滚动进可见范围 | 参考 `validateFields` |  |
 
 ### validateFields/validateFieldsAndScroll
 
@@ -116,12 +116,12 @@ validateFields(['field1', 'field2'], options, (errors, values) => {
 });
 ```
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| options.first | 若为 true，则每一表单域的都会在碰到第一个失败了的校验规则后停止校验 | boolean | false |
-| options.firstFields | 指定表单域会在碰到第一个失败了的校验规则后停止校验 | String\[] | \[] |
-| options.force | 对已经校验过的表单域，在 validateTrigger 再次被触发时是否再次校验 | boolean | false |
-| options.scroll | 定义 validateFieldsAndScroll 的滚动行为，详细配置见 [dom-scroll-into-view config](https://github.com/yiminghe/dom-scroll-into-view#function-parameter) | Object | {} |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| options.first | 若为 true，则每一表单域的都会在碰到第一个失败了的校验规则后停止校验 | boolean | false | 3.9.3 |
+| options.firstFields | 指定表单域会在碰到第一个失败了的校验规则后停止校验 | String\[] | \[] | 3.9.3 |
+| options.force | 对已经校验过的表单域，在 validateTrigger 再次被触发时是否再次校验 | boolean | false | 3.9.3 |
+| options.scroll | 定义 validateFieldsAndScroll 的滚动行为，详细配置见 [dom-scroll-into-view config](https://github.com/yiminghe/dom-scroll-into-view#function-parameter) | Object | {} | 3.9.3 |
 
 #### validateFields 的 callback 参数示例
 
@@ -175,18 +175,18 @@ validateFields(['field1', 'field2'], options, (errors, values) => {
 
 #### getFieldDecorator(id, options) 参数
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| id | 必填输入控件唯一标志。支持嵌套式的[写法](https://github.com/react-component/form/pull/48)。 | string |  |
-| options.getValueFromEvent | 可以把 onChange 的参数（如 event）转化为控件的值 | function(..args) | [reference](https://github.com/react-component/form#option-object) |
-| options.initialValue | 子节点的初始值，类型、可选值均由子节点决定(注意：由于内部校验时使用 `===` 判断是否变化，建议使用变量缓存所需设置的值而非直接使用字面量)) |  |  |
-| options.normalize | 转换默认的 value 给控件，[一个选择全部的例子](https://codepen.io/afc163/pen/JJVXzG?editors=001) | function(value, prevValue, allValues): any | - |
-| options.preserve | 即便字段不再使用，也保留该字段的值 | boolean | - |
-| options.rules | 校验规则，参考下方文档 | object\[] |  |
-| options.trigger | 收集子节点的值的时机 | string | 'onChange' |
-| options.validateFirst | 当某一规则校验不通过时，是否停止剩下的规则的校验 | boolean | false |
-| options.validateTrigger | 校验子节点值的时机 | string\|string\[] | 'onChange' |
-| options.valuePropName | 子节点的值的属性，如 Switch 的是 'checked' | string | 'value' |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| id | 必填输入控件唯一标志。支持嵌套式的[写法](https://github.com/react-component/form/pull/48)。 | string |  |  |
+| options.getValueFromEvent | 可以把 onChange 的参数（如 event）转化为控件的值 | function(..args) | [reference](https://github.com/react-component/form#option-object) |  |
+| options.initialValue | 子节点的初始值，类型、可选值均由子节点决定(注意：由于内部校验时使用 `===` 判断是否变化，建议使用变量缓存所需设置的值而非直接使用字面量)) |  |  |  |
+| options.normalize | 转换默认的 value 给控件，[一个选择全部的例子](https://codepen.io/afc163/pen/JJVXzG?editors=001) | function(value, prevValue, allValues): any | - |  |
+| options.preserve | 即便字段不再使用，也保留该字段的值 | boolean | - | 3.12.0 |
+| options.rules | 校验规则，参考下方文档 | object\[] |  |  |
+| options.trigger | 收集子节点的值的时机 | string | 'onChange' |  |
+| options.validateFirst | 当某一规则校验不通过时，是否停止剩下的规则的校验 | boolean | false |  |
+| options.validateTrigger | 校验子节点值的时机 | string\|string\[] | 'onChange' |  |
+| options.valuePropName | 子节点的值的属性，如 Switch 的是 'checked' | string | 'value' |  |
 
 更多参数请查看 [rc-form option](https://github.com/react-component/form#option-object)。
 
@@ -205,23 +205,23 @@ validateFields(['field1', 'field2'], options, (errors, values) => {
 | labelCol | label 标签布局，同 `<Col>` 组件，设置 `span` `offset` 值，如 `{span: 3, offset: 12}` 或 `sm: {span: 3, offset: 12}`。在 3.14.0 之后，你可以通过 Form 的 labelCol 进行统一设置。当和 Form 同时设置时，以 FormItem 为准。 | [object](https://ant.design/components/grid/#Col) |  |  |
 | required | 是否必填，如不设置，则会根据校验规则自动生成 | boolean | false |  |
 | validateStatus | 校验状态，如不设置，则会根据校验规则自动生成，可选：'success' 'warning' 'error' 'validating' | string |  |  |
-| wrapperCol | 需要为输入控件设置布局样式时，使用该属性，用法同 labelCol。在 3.14.0 之后，你可以通过 Form 的 labelCol 进行统一设置。当和 Form 同时设置时，以 FormItem 为准。 | [object](https://ant.design/components/grid/#Col) |  |  |
+| wrapperCol | 需要为输入控件设置布局样式时，使用该属性，用法同 labelCol。在 3.14.0 之后，你可以通过 Form 的 wrapperCol 进行统一设置。当和 Form 同时设置时，以 FormItem 为准。 | [object](https://ant.design/components/grid/#Col) |  |  |
 
 ### 校验规则
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| enum | 枚举类型 | string | - |
-| len | 字段长度 | number | - |
-| max | 最大长度 | number | - |
-| message | 校验文案 | string\|ReactNode | - |
-| min | 最小长度 | number | - |
-| pattern | 正则表达式校验 | RegExp | - |
-| required | 是否必选 | boolean | `false` |
-| transform | 校验前转换字段值 | function(value) => transformedValue:any | - |
-| type | 内建校验类型，[可选项](https://github.com/yiminghe/async-validator#type) | string | 'string' |
-| validator | 自定义校验（注意，[callback 必须被调用](https://github.com/ant-design/ant-design/issues/5155)） | function(rule, value, callback) | - |
-| whitespace | 必选时，空格是否会被视为错误 | boolean | `false` |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| enum | 枚举类型 | string | - |  |
+| len | 字段长度 | number | - |  |
+| max | 最大长度 | number | - |  |
+| message | 校验文案 | string\|ReactNode | - |  |
+| min | 最小长度 | number | - |  |
+| pattern | 正则表达式校验 | RegExp | - |  |
+| required | 是否必选 | boolean | `false` |  |
+| transform | 校验前转换字段值 | function(value) => transformedValue:any | - |  |
+| type | 内建校验类型，[可选项](https://github.com/yiminghe/async-validator#type) | string | 'string' |  |
+| validator | 自定义校验（注意，[callback 必须被调用](https://github.com/ant-design/ant-design/issues/5155)） | function(rule, value, callback) | - |  |
+| whitespace | 必选时，空格是否会被视为错误 | boolean | `false` |  |
 
 更多高级用法可研究 [async-validator](https://github.com/yiminghe/async-validator)。
 

components/grid/index.en-US.md

@@ -88,28 +88,28 @@ If the Ant Design grid layout component does not meet your needs, you can use th
 
 ### Row
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| align | the vertical alignment of the flex layout: `top` `middle` `bottom` | string | `top` |
-| gutter | spacing between grids, could be a number or a object like `{ xs: 8, sm: 16, md: 24}` | number/object | 0 |
-| justify | horizontal arrangement of the flex layout: `start` `end` `center` `space-around` `space-between` | string | `start` |
-| type | layout mode, optional `flex`, [browser support](http://caniuse.com/#search=flex) | string |  |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| align | the vertical alignment of the flex layout: `top` `middle` `bottom` | string | `top` |  |
+| gutter | spacing between grids, could be a number or a object like `{ xs: 8, sm: 16, md: 24}` | number/object | 0 |  |
+| justify | horizontal arrangement of the flex layout: `start` `end` `center` `space-around` `space-between` | string | `start` |  |
+| type | layout mode, optional `flex`, [browser support](http://caniuse.com/#search=flex) | string |  |  |
 
 ### Col
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| offset | the number of cells to offset Col from the left | number | 0 |
-| order | raster order, used in `flex` layout mode | number | 0 |
-| pull | the number of cells that raster is moved to the left | number | 0 |
-| push | the number of cells that raster is moved to the right | number | 0 |
-| span | raster number of cells to occupy, 0 corresponds to `display: none` | number | none |
-| xs | `<576px` and also default setting, could be a `span` value or an object containing above props | number\|object | - |
-| sm | `≥576px`, could be a `span` value or an object containing above props | number\|object | - |
-| md | `≥768px`, could be a `span` value or an object containing above props | number\|object | - |
-| lg | `≥992px`, could be a `span` value or an object containing above props | number\|object | - |
-| xl | `≥1200px`, could be a `span` value or an object containing above props | number\|object | - |
-| xxl | `≥1600px`, could be a `span` value or an object containing above props | number\|object | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| offset | the number of cells to offset Col from the left | number | 0 |  |
+| order | raster order, used in `flex` layout mode | number | 0 |  |
+| pull | the number of cells that raster is moved to the left | number | 0 |  |
+| push | the number of cells that raster is moved to the right | number | 0 |  |
+| span | raster number of cells to occupy, 0 corresponds to `display: none` | number | none |  |
+| xs | `<576px` and also default setting, could be a `span` value or an object containing above props | number\|object | - |  |
+| sm | `≥576px`, could be a `span` value or an object containing above props | number\|object | - |  |
+| md | `≥768px`, could be a `span` value or an object containing above props | number\|object | - |  |
+| lg | `≥992px`, could be a `span` value or an object containing above props | number\|object | - |  |
+| xl | `≥1200px`, could be a `span` value or an object containing above props | number\|object | - |  |
+| xxl | `≥1600px`, could be a `span` value or an object containing above props | number\|object | - |  |
 
 The breakpoints of responsive grid follow [BootStrap 4 media queries rules](https://getbootstrap.com/docs/4.0/layout/overview/#responsive-breakpoints)(not including `occasionally part`).
 

components/grid/index.zh-CN.md

@@ -87,28 +87,28 @@ Ant Design 的布局组件若不能满足你的需求，你也可以直接使用
 
 ### Row
 
-| 成员 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| align | flex 布局下的垂直对齐方式：`top` `middle` `bottom` | string | `top` |
-| gutter | 栅格间隔，可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number/object | 0 |
-| justify | flex 布局下的水平排列方式：`start` `end` `center` `space-around` `space-between` | string | `start` |
-| type | 布局模式，可选 `flex`，[现代浏览器](http://caniuse.com/#search=flex) 下有效 | string |  |
+| 成员 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| align | flex 布局下的垂直对齐方式：`top` `middle` `bottom` | string | `top` |  |
+| gutter | 栅格间隔，可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number/object | 0 |  |
+| justify | flex 布局下的水平排列方式：`start` `end` `center` `space-around` `space-between` | string | `start` |  |
+| type | 布局模式，可选 `flex`，[现代浏览器](http://caniuse.com/#search=flex) 下有效 | string |  |  |
 
 ### Col
 
-| 成员   | 说明                                                     | 类型           | 默认值 |
-| ------ | -------------------------------------------------------- | -------------- | ------ |
-| offset | 栅格左侧的间隔格数，间隔内不可以有栅格                   | number         | 0      |
-| order  | 栅格顺序，`flex` 布局模式下有效                          | number         | 0      |
-| pull   | 栅格向左移动格数                                         | number         | 0      |
-| push   | 栅格向右移动格数                                         | number         | 0      |
-| span   | 栅格占位格数，为 0 时相当于 `display: none`              | number         | -      |
-| xs     | `<576px` 响应式栅格，可为栅格数或一个包含其他属性的对象  | number\|object | -      |
-| sm     | `≥576px` 响应式栅格，可为栅格数或一个包含其他属性的对象  | number\|object | -      |
-| md     | `≥768px` 响应式栅格，可为栅格数或一个包含其他属性的对象  | number\|object | -      |
-| lg     | `≥992px` 响应式栅格，可为栅格数或一个包含其他属性的对象  | number\|object | -      |
-| xl     | `≥1200px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | -      |
-| xxl    | `≥1600px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | -      |
+| 成员 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| offset | 栅格左侧的间隔格数，间隔内不可以有栅格 | number | 0 |  |
+| order | 栅格顺序，`flex` 布局模式下有效 | number | 0 |  |
+| pull | 栅格向左移动格数 | number | 0 |  |
+| push | 栅格向右移动格数 | number | 0 |  |
+| span | 栅格占位格数，为 0 时相当于 `display: none` | number | - |  |
+| xs | `<576px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | - |  |
+| sm | `≥576px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | - |  |
+| md | `≥768px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | - |  |
+| lg | `≥992px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | - |  |
+| xl | `≥1200px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | - |  |
+| xxl | `≥1600px` 响应式栅格，可为栅格数或一个包含其他属性的对象 | number\|object | - |  |
 
 响应式栅格的断点扩展自 [BootStrap 4 的规则](https://getbootstrap.com/docs/4.0/layout/overview/#responsive-breakpoints)（不包含链接里 `occasionally` 的部分)。
 

components/grid/style/index.less

@@ -61,6 +61,8 @@
 }
 
 .@{ant-prefix}-col {
+  // Prevent columns from collapsing when empty
+  min-height: 1px;
   position: relative;
 }
 

components/grid/style/mixin.less

@@ -22,8 +22,6 @@
   .col(@index, @list) when (@index > @grid-columns) {
     @{list} {
       position: relative;
-      // Prevent columns from collapsing when empty
-      min-height: 1px;
       padding-right: (@grid-gutter-width / 2);
       padding-left: (@grid-gutter-width / 2);
     }

components/icon/__tests__/index.test.js

@@ -227,23 +227,23 @@ describe('utils', () => {
     ]);
   });
 
-  it('should depracate typo icon name', () => {
+  it('should report an error when there are deprecated typos in icon names', () => {
     const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
     render(<Icon type="interation" />);
     expect(errorSpy).toHaveBeenLastCalledWith(
-      "Warning: [antd: Icon] Icon 'interation' is typo and depracated, please use 'interaction' instead.",
+      "Warning: [antd: Icon] Icon 'interation' was a typo and is now deprecated, please use 'interaction' instead.",
     );
     render(<Icon type="cross" />);
     expect(errorSpy).toHaveBeenLastCalledWith(
-      "Warning: [antd: Icon] Icon 'cross' is typo and depracated, please use 'close' instead.",
+      "Warning: [antd: Icon] Icon 'cross' was a typo and is now deprecated, please use 'close' instead.",
     );
     render(<Icon type="canlendar" theme="twoTone" />);
     expect(errorSpy).toHaveBeenLastCalledWith(
-      "Warning: [antd: Icon] Icon 'canlendar' is typo and depracated, please use 'calendar' instead.",
+      "Warning: [antd: Icon] Icon 'canlendar' was a typo and is now deprecated, please use 'calendar' instead.",
     );
     render(<Icon type="colum-height" />);
     expect(errorSpy).toHaveBeenLastCalledWith(
-      "Warning: [antd: Icon] Icon 'colum-height' is typo and depracated, please use 'column-height' instead.",
+      "Warning: [antd: Icon] Icon 'colum-height' was a typo and is now deprecated, please use 'column-height' instead.",
     );
     expect(errorSpy).toHaveBeenCalledTimes(4);
     errorSpy.mockRestore();

components/icon/index.en-US.md

@@ -16,15 +16,15 @@ ReactDOM.render(<IconDisplay />, mountNode);
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| type | Type of the ant design icon | string | - |
-| style | Style properties of icon, like `fontSize` and `color` | CSSProperties | - |
-| theme | Theme of the ant design icon | 'filled' \| 'outlined' \| 'twoTone' | 'outlined' |
-| spin | Rotate icon with animation | boolean | false |
-| rotate | Rotate degrees (added in 3.13.0, not working in IE9) | number | - |
-| component | The component used for the root node. This will override the **`type`** property. | ComponentType<CustomIconComponentProps\> | - |
-| twoToneColor | Only support the two-tone icon. Specific the primary color. | string (hex color) | - |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| type | Type of the ant design icon | string | - |  |
+| style | Style properties of icon, like `fontSize` and `color` | CSSProperties | - |  |
+| theme | Theme of the ant design icon | 'filled' \| 'outlined' \| 'twoTone' | 'outlined' | 3.9.0 |
+| spin | Rotate icon with animation | boolean | false |  |
+| rotate | Rotate degrees (added in 3.13.0, not working in IE9) | number | - | 3.13.0 |
+| component | The component used for the root node. This will override the **`type`** property. | ComponentType<CustomIconComponentProps\> | - | 3.9.0 |
+| twoToneColor | Only support the two-tone icon. Specific the primary color. | string (hex color) | - | 3.9.0 |
 
 ### SVG icons
 
@@ -80,10 +80,10 @@ It create a component that uses SVG sprites in essence.
 
 The following options are available:
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| scriptUrl | The URL generated by [iconfont.cn](http://iconfont.cn/) project. | string | - |
-| extraCommonProps | Define extra properties to the component | `{ [key: string]: any }` | {} |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| scriptUrl | The URL generated by [iconfont.cn](http://iconfont.cn/) project. | string | - | 3.9.3 |
+| extraCommonProps | Define extra properties to the component | `{ [key: string]: any }` | {} | 3.9.3 |
 
 The property `scriptUrl` should be set to import the SVG sprite symbols.
 
@@ -121,10 +121,10 @@ ReactDOM.render(<Icon component={MessageSvg} />, mountNode);
 
 The following properties are available for the component:
 
-| Property  | Description                                      | Type             | Default        |
-| --------- | ------------------------------------------------ | ---------------- | -------------- |
-| width     | The width of the `svg` element                   | string \| number | '1em'          |
-| height    | The height of the `svg` element                  | string \| number | '1em'          |
-| fill      | Define the color used to paint the `svg` element | string           | 'currentColor' |
-| className | The computed class name of the `svg` element     | string           | -              |
-| style     | The computed style of the `svg` element          | CSSProperties    | -              |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| width | The width of the `svg` element | string \| number | '1em' | 3.10.0 |
+| height | The height of the `svg` element | string \| number | '1em' | 3.10.0 |
+| fill | Define the color used to paint the `svg` element | string | 'currentColor' | 3.10.0 |
+| className | The computed class name of the `svg` element | string | - | 3.10.0 |
+| style | The computed style of the `svg` element | CSSProperties | - | 3.10.0 |

components/icon/index.zh-CN.md

@@ -21,15 +21,15 @@ ReactDOM.render(<IconDisplay />, mountNode);
 
 ## API
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| type | 图标类型。遵循图标的命名规范 | string | - |
-| style | 设置图标的样式，例如 `fontSize` 和 `color` | CSSProperties | - |
-| theme | 图标主题风格。可选实心、描线、双色等主题风格，适用于官方图标 | 'filled' \| 'outlined' \| 'twoTone' | 'outlined' |
-| spin | 是否有旋转动画 | boolean | false |
-| rotate | 图标旋转角度（3.13.0 后新增，IE9 无效） | number | - |
-| component | 控制如何渲染图标，通常是一个渲染根标签为 `<svg>` 的 `React` 组件，**会使 `type` 属性失效** | ComponentType<CustomIconComponentProps\> | - |
-| twoToneColor | 仅适用双色图标。设置双色图标的主要颜色 | string (十六进制颜色) | - |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| type | 图标类型。遵循图标的命名规范 | string | - |  |
+| style | 设置图标的样式，例如 `fontSize` 和 `color` | CSSProperties | - |  |
+| theme | 图标主题风格。可选实心、描线、双色等主题风格，适用于官方图标 | 'filled' \| 'outlined' \| 'twoTone' | 'outlined' | 3.9.0 |
+| spin | 是否有旋转动画 | boolean | false |  |
+| rotate | 图标旋转角度（3.13.0 后新增，IE9 无效） | number | - | 3.13.0 |
+| component | 控制如何渲染图标，通常是一个渲染根标签为 `<svg>` 的 `React` 组件，**会使 `type` 属性失效** | ComponentType<CustomIconComponentProps\> | - | 3.9.0 |
+| twoToneColor | 仅适用双色图标。设置双色图标的主要颜色 | string (十六进制颜色) | - | 3.9.0 |
 
 ### SVG 图标
 
@@ -83,10 +83,10 @@ ReactDOM.render(<MyIcon type="icon-example" />, mountedNode);
 
 `options` 的配置项如下：
 
-| 参数 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| scriptUrl | [iconfont.cn](http://iconfont.cn/) 项目在线生成的 `js` 地址 | string | - |
-| extraCommonProps | 给所有的 `svg` 图标 `<Icon />` 组件设置额外的属性 | `{ [key: string]: any }` | {} |
+| 参数 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| scriptUrl | [iconfont.cn](http://iconfont.cn/) 项目在线生成的 `js` 地址 | string | - | 3.9.3 |
+| extraCommonProps | 给所有的 `svg` 图标 `<Icon />` 组件设置额外的属性 | `{ [key: string]: any }` | {} | 3.9.3 |
 
 在 `scriptUrl` 都设置有效的情况下，组件在渲染前会自动引入 [iconfont.cn](http://iconfont.cn/) 项目中的图标符号集，无需手动引入。
 
@@ -124,10 +124,10 @@ ReactDOM.render(<Icon component={MessageSvg} />, mountNode);
 
 `Icon` 中的 `component` 组件的接受的属性如下：
 
-| 字段      | 说明                    | 类型             | 只读值         |
-| --------- | ----------------------- | ---------------- | -------------- |
-| width     | `svg` 元素宽度          | string \| number | '1em'          |
-| height    | `svg` 元素高度          | string \| number | '1em'          |
-| fill      | `svg` 元素填充的颜色    | string           | 'currentColor' |
-| className | 计算后的 `svg` 类名     | string           | -              |
-| style     | 计算后的 `svg` 元素样式 | CSSProperties    | -              |
+| 字段      | 说明                    | 类型             | 只读值         | 版本   |
+| --------- | ----------------------- | ---------------- | -------------- | ------ |
+| width     | `svg` 元素宽度          | string \| number | '1em'          | 3.10.0 |
+| height    | `svg` 元素高度          | string \| number | '1em'          | 3.10.0 |
+| fill      | `svg` 元素填充的颜色    | string           | 'currentColor' | 3.10.0 |
+| className | 计算后的 `svg` 类名     | string           | -              | 3.10.0 |
+| style     | 计算后的 `svg` 元素样式 | CSSProperties    | -              | 3.10.0 |

components/icon/utils.ts

@@ -72,7 +72,7 @@ export function alias(type: string) {
   warning(
     newType === type,
     'Icon',
-    `Icon '${type}' is typo and depracated, please use '${newType}' instead.`,
+    `Icon '${type}' was a typo and is now deprecated, please use '${newType}' instead.`,
   );
   return newType;
 }

components/input-number/index.en-US.md

@@ -12,25 +12,25 @@ When a numeric value needs to be provided.
 
 ## API
 
-| Property | Description | Type | Default |
-| --- | --- | --- | --- |
-| autoFocus | get focus when component mounted | boolean | false |
-| defaultValue | initial value | number |  |
-| disabled | disable the input | boolean | false |
-| formatter | Specifies the format of the value presented | function(value: number \| string): string | - |
-| max | max value | number | Infinity |
-| min | min value | number | -Infinity |
-| parser | Specifies the value extracted from formatter | function( string): number | - |
-| precision | precision of input value | number | - |
-| decimalSeparator | decimal separator | string | - |
-| size | height of input box | string | - |
-| step | The number to which the current value is increased or decreased. It can be an integer or decimal. | number\|string | 1 |
-| value | current value | number |  |
-| onChange | The callback triggered when the value is changed. | function(value: number \| string) |  |
+| Property | Description | Type | Default | Version |
+| --- | --- | --- | --- | --- |
+| autoFocus | get focus when component mounted | boolean | false |  |
+| defaultValue | initial value | number |  |  |
+| disabled | disable the input | boolean | false |  |
+| formatter | Specifies the format of the value presented | function(value: number \| string): string | - |  |
+| max | max value | number | Infinity |  |
+| min | min value | number | -Infinity |  |
+| parser | Specifies the value extracted from formatter | function( string): number | - |  |
+| precision | precision of input value | number | - |  |
+| decimalSeparator | decimal separator | string | - | 3.10.1 |
+| size | height of input box | string | - |  |
+| step | The number to which the current value is increased or decreased. It can be an integer or decimal. | number\|string | 1 |  |
+| value | current value | number |  |  |
+| onChange | The callback triggered when the value is changed. | function(value: number \| string) |  |  |
 
 ## Methods
 
-| Name    | Description  |
-| ------- | ------------ |
-| blur()  | remove focus |
-| focus() | get focus    |
+| Name    | Description  | Version |
+| ------- | ------------ | ------- |
+| blur()  | remove focus |         |
+| focus() | get focus    |         |