--- order: 6 title: Change Log toc: false timeline: true --- `antd` strictly follows [Semantic Versioning 2.0.0](http://semver.org/). #### Release Schedule * Weekly release: patch version at the end of every week for routine bugfix (anytime for urgent bugfix). * Monthly release: minor version at the end of every month for new features. * Major version release is not included in this schedule for breaking change and new features. --- ## 3.1.4 `2018-01-21` - ๐Ÿž Fix ButtonGroup z-index issue. [#9014](https://github.com/ant-design/ant-design/issues/9014) - ๐Ÿž Fix Dropdown.Button can not be fully disabled. [#8991](https://github.com/ant-design/ant-design/issues/8991) [@sallen450](https://github.com/sallen450) - ๐Ÿž Fix Layout error responsive docs. [#8995](https://github.com/ant-design/ant-design/pull/8995) [@ReedSun](https://github.com/ReedSun) - ๐Ÿž Fix List `grid` do not support xxl. [#9019](https://github.com/ant-design/ant-design/issues/9019) - ๐Ÿž Fix RangePicker can not cancel selected start date when the panel is closed. [#8839](https://github.com/ant-design/ant-design/issues/8839) - ๐Ÿž Fix Tabs error margin. [commit/200d6c](https://github.com/ant-design/ant-design/commit/200d6cb11aba12a488510f957353bbd5bd1dcd1b) - ๐Ÿž Fix WeekPicker shows error weeks. [#9021](https://github.com/ant-design/ant-design/issues/9021) - ๐Ÿž Fix some TypeScript type definitions. - Add `subMenuCloseDelay` and `subMenuOpenDelay` for Menu. [#8976](https://github.com/ant-design/ant-design/issues/8976) [@Rohanhacker](https://github.com/Rohanhacker) - Refactor DatePicker types. [commit/0bb531](https://github.com/ant-design/ant-design/commit/0bb531aca6cb2045d5323196a599c925537a4eb0) - Fix Input `maxLength` type definitions. [#9046](https://github.com/ant-design/ant-design/pull/9046) [@Riokai](https://github.com/Riokai) - ๐ŸŒŸ Add some new less variables. - About Checkbox and Radio: [#9003](https://github.com/ant-design/ant-design/pull/9003) [@mrgeorgegray](https://github.com/mrgeorgegray) - About Breadcrumb: [#9022](https://github.com/ant-design/ant-design/pull/9022) [@mrgeorgegray](https://github.com/mrgeorgegray) - ๐ŸŒŸ Add aliyun icon. ## 3.1.3 `2018-01-14` - ๐Ÿž Fix error when passing `null` `locale` to LocaleProvider. ## 3.1.2 `2018-01-13` - ๐Ÿž Fix Button can not display `0`. [#8733](https://github.com/ant-design/ant-design/pull/8733) [@Cuihongsen](https://github.com/Cuihongsen) - ๐Ÿž Fix extra scrollbar in Table and List caused by Spin. [#8799](https://github.com/ant-design/ant-design/issues/8799) - ๐Ÿž Fix can not pass function to Table[emptyText]. [#8871](https://github.com/ant-design/ant-design/issues/8871) - ๐Ÿž Fix now working Dropdown[transitionName]. - ๐Ÿž Fix issue resulting in font changes when enter number in Input.[#8636](https://github.com/ant-design/ant-design/issues/8636) - ๐Ÿž Fix issue resulting in wrong locale text when import multiple locale files. [#8785](https://github.com/ant-design/ant-design/pull/8785) - ๐Ÿž Fix `locales` in dist/antd-with-locales.js has a `extra` default key. [#8881](https://github.com/ant-design/ant-design/issues/8881) - ๐Ÿž Fix some TypeScript type definitions. [4cc29bc](https://github.com/ant-design/ant-design/commit/4cc29bc11cf7c019c63a25693adff3dbb58b41c3) [693e734](https://github.com/ant-design/ant-design/commit/693e734a82b5e1faf25b025127afca67e75f9c88) [67e956d](https://github.com/ant-design/ant-design/commit/67e956dddd040f63b2a59b8b619123bbb0065780) [ecd4177](https://github.com/ant-design/ant-design/commit/ecd4177638da1eac3a3750fe5ad68b9309865542) [33119ec](https://github.com/ant-design/ant-design/commit/33119ec535e7b819541d4753464871988b37dd6f) [88e0c9b](https://github.com/ant-design/ant-design/commit/88e0c9b436f196def62e737ea72e105aba4b5d4e) - ๐ŸŒŸ Add some new less variables [b9b5aba](https://github.com/ant-design/ant-design/commit/b9b5abab3364bf752e9644415088b142a153e385) [5931b20](https://github.com/ant-design/ant-design/commit/5931b201da58e993227a04128045e627f2b65c46) [c9d7397](https://github.com/ant-design/ant-design/commit/c9d73978dd2694f9d2bd0111f82a20d237f83621) - ๐ŸŒŸ Optimize Chinese quotes displaying. ## 3.1.1 `2018-01-08` - ๐Ÿ“– Published the new site and design guideline. - ๐Ÿ“– Updated the guideline of real project with dva to [roadhog 2.0](https://github.com/sorrycc/blog/issues/55). [5dcf1c0](https://github.com/ant-design/ant-design/commit/5dcf1c015fc2674adb09434bf766549d6f3f0022) - ๐Ÿ“– Published the new sketch resource of Ant Design 3.0. [22dfe88](https://github.com/ant-design/ant-design/commit/22dfe88ab043c1e116382fc96b7d78cabf125054) - ๐Ÿž Fix contextMenu event for trigger prop in the TypeScript definition of Dropdown. [#8646](https://github.com/ant-design/ant-design/issues/8646) [@cjahv](https://github.com/cjahv) - ๐Ÿž Fix HOC in Button not inserted space between chinese words. - ๐Ÿž Fix the style compatibility in IE 11 for List Component. [#8784](https://github.com/ant-design/ant-design/issues/8784) - ๐Ÿž Fix notFoundContent prop not working for Select Component. [#8809](https://github.com/ant-design/ant-design/issues/8809) - ๐Ÿž Fix the warning for BackTop Component in React 16. [#8848](https://github.com/ant-design/ant-design/issues/8848) - ๐Ÿž Fix unexpected scrollbar for List Component when setting gutter. [#8799](https://github.com/ant-design/ant-design/issues/8799) - ๐Ÿž Fix to support complete href link for Anchor.Link Component. [#8808](https://github.com/ant-design/ant-design/issues/8808) - ๐ŸŒŸ Optimize the font family of Chinese quote. [c6fcc31](https://github.com/ant-design/ant-design/commit/c6fcc3121758dfe6ac5b50c1b55790eb42b805c5) ## 3.1.0 `2017-12-29` Happy 2018 !~ 2018 2018 2018 coming!~~~ - ๐Ÿž Fix ant-spin-container overflow resizing for Spin component. [#8602](https://github.com/ant-design/ant-design/issues/8602) [@jhsu](https://github.com/jhsu) - ๐Ÿž Fix extra padding in Table small with fixed columns. [#8724](https://github.com/ant-design/ant-design/issues/8724) - ๐Ÿž Fix Checkbox.Group align issue in Form. [#8739](https://github.com/ant-design/ant-design/issues/8739) - ๐Ÿž Fix unexpected scrollbar in Affix. [#8606](https://github.com/ant-design/ant-design/issues/8606) - ๐Ÿž Fix List component "No Data" mixed with loading. [#8647](https://github.com/ant-design/ant-design/issues/8647) - ๐ŸŒŸ Add onKeyUp TypeScript definition to Input component. [#8705](https://github.com/ant-design/ant-design/issues/8705) [@delesseps](https://github.com/delesseps) - ๐ŸŒŸ Add `showArrow` for disabling arrow icon in collapse panel. [#8536](https://github.com/ant-design/ant-design/pull/8536) [@apieceofbart](https://github.com/apieceofbart) - ๐ŸŒŸ Rate add `allowClear` for reset when click again. [#8627](https://github.com/ant-design/ant-design/issues/8627) - ๐ŸŒŸ Add responsive for BackTop. [#8719](https://github.com/ant-design/ant-design/issues/8719) [@JetRunner](https://github.com/JetRunner) - ๐ŸŒŸ Add `destroyOnClose` to Modal component to support unmount child compenents on onClose. [#8769](https://github.com/ant-design/ant-design/pull/8769) [@Rohanhacker](https://github.com/Rohanhacker) - ๐ŸŒŸ Pagination add `hideOnSinglePage` for support hide it when only one page. [#8615](https://github.com/ant-design/ant-design/pull/8615) [@camsong](https://github.com/camsong) - ๐ŸŒŸ Support customize spin for List component. - ๐Ÿ‘ป Support open official demo in CodeSandbox. ## 3.0.3 `2017-12-22` - ๐Ÿž Add React.SFC type for Form.create return value. [#8672](https://github.com/ant-design/ant-design/issues/8672) - ๐Ÿž Fix form item height and align problem. [#8701](https://github.com/ant-design/ant-design/issues/8701) - ๐Ÿž Improve input addon size. [#8680](https://github.com/ant-design/ant-design/issues/8680) - ๐Ÿž Fix table size of fixed column. [#8660](https://github.com/ant-design/ant-design/issues/8660) ## 3.0.2 `2017-12-17` - ๐Ÿ“ Provide a migration helper for antd@3.0. [e71b68dd](https://github.com/ant-design/ant-design/commit/e71b68dd1d2ff91200fea6dd9d56e6aa5653edbc) - ๐Ÿ“ Rewrite [CONTRIBUTING Guideline](https://github.com/ant-design/ant-design/blob/master/.github/CONTRIBUTING.md) - ๐ŸŒŸ Optimize notification display in small screen. [#8631](https://github.com/ant-design/ant-design/issues/8631) - ๐ŸŒŸ Optimize Pagination design and fix some issues of alignment and margin. - ๐Ÿž Upgrade to `react-slick@0.16.0` for peerDependencies warning. [#8455](https://github.com/ant-design/ant-design/issues/8455) - ๐Ÿž Fix not working `size` property in fixed-header Table. [#8577](https://github.com/ant-design/ant-design/issues/8577) - ๐Ÿž Fix not working `locale` property of DatePicker/RangePicker. [#8635](https://github.com/ant-design/ant-design/issues/8635) - ๐Ÿž Fix Popover arrow position and size cannot be overrided by less variable. [#8548](https://github.com/ant-design/ant-design/issues/8548) [#8549](https://github.com/ant-design/ant-design/issues/8549) - ๐Ÿž Fix not working `notFoundContent` of AutoComponent. [#8553](https://github.com/ant-design/ant-design/issues/8553) - ๐Ÿž Tweak RangePicker vertical align position. - ๐Ÿž Layout.Sider breakpoints is same as Grid's now. [#8620](https://github.com/ant-design/ant-design/issues/8620) - ๐Ÿž Fix submenu still showing in a collapsed menu when collapsedWidth is `0`. [#8587](https://github.com/ant-design/ant-design/issues/8587) - ๐Ÿž Fix Card's `Meta.title` text overflow not working. [#8597](https://github.com/ant-design/ant-design/issues/8597) - ๐Ÿž Fix pagination margin problem of bordered List. [#8562](https://github.com/ant-design/ant-design/issues/8562) - ๐Ÿž Fix Menu's submenu cannot open when specified non-existed `defaultOpenKeys`. [#8475](https://github.com/ant-design/ant-design/issues/8475) - ๐Ÿž Fix type name collisions of `InputProps` and `SearchProps` in Input, AutoComplete, Transfer. [#8478](https://github.com/ant-design/ant-design/issues/8478) ## 3.0.1 `2017-12-11` * Remove useless DOM wrapper of Card, so that Card's DOM structure will be the same as Card of 2.x. * Fix that missing `antd/lib/style/v2-compatible-reset.css`. [28d13e2](https://github.com/ant-design/ant-design/commit/28d13e2539817f87b8a2029ea22d9c30b377167f) * Fix that Affix will be overlap when it is heigher than viewport. [31a0654](https://github.com/ant-design/ant-design/commit/31a0654ef990eb7bae2b18095fa0d5230b9be1da) * Fix the open animation of Collapse. [edd592c](https://github.com/ant-design/ant-design/commit/edd592cb9dd79d534853e7a0c1b648382e3f1a12) * Fix the aligment of large size Input and Button in Form. [#8459](https://github.com/ant-design/ant-design/issues/8459) * Menu * Fix the popup will disappear unexpectly in Safari. [#8453](https://github.com/ant-design/ant-design/issues/8453) * Fix the open animation. [edd592c](https://github.com/ant-design/ant-design/commit/edd592cb9dd79d534853e7a0c1b648382e3f1a12) * Fix compile error of style of Notification. [#8437](https://github.com/ant-design/ant-design/issues/8437) * Fix the background color of mini Pagination. [e13c6d8](https://github.com/ant-design/ant-design/commit/e13c6d87fa6bf7d5cf4b2d5154a85b4793997de5) * Table * Fix broken style in mobile. [#8465](https://github.com/ant-design/ant-design/issues/8465) * Fix broken style when use size and nested Table together. [#8525](https://github.com/ant-design/ant-design/issues/8525) * TypeScript * Fix TypeScript definition of AutoComplete. [#8383](https://github.com/ant-design/ant-design/pull/8383) [@nidhi-ag](https://github.com/nidhi-ag) * Fix TypeScript definition of Divider. [#8504](https://github.com/ant-design/ant-design/pull/8504) [@cyyyu](https://github.com/cyyyu) * Fix TypeScript definition of Dropdown. [#8444](https://github.com/ant-design/ant-design/issues/8444) * Fix TypeScript definition of List. [e27061e](https://github.com/ant-design/ant-design/commit/e27061ea5b2f2d3273b45862d9b87285448f0998) [1b2a955](https://github.com/ant-design/ant-design/commit/1b2a9550d9595dd2f31f79d1bdd52695ec792692) * Fix TypeScript definition of Table. [#8507](https://github.com/ant-design/ant-design/issues/8507) [#8515](https://github.com/ant-design/ant-design/pull/8515) [@danedavid](https://github.com/danedavid) ## 3.0.0 `2017-12-04` Learn more in the [Ant Design 3.0 announcement post](https://medium.com/ant-design/announcing-ant-design-3-0-70e3e65eca0c)! ### Major Changes - New [color system](https://ant.design/docs/spec/colors#Color-Palettes), We changed our primary color from ใ€Ž`#108EE9`ใ€ to ใ€Ž`#1890FF`ใ€, we called the new primary color "ๆ‹‚ๆ™“่“ (Daybreak Blue)" which means the color of the sky at daybreak. - New design of components. - Increased the base font size from 12px to 14px. - Changed default locale to `en_US`. - Support React 16. - Better TypeScript support. - New [List](https://ant.design/components/list/) component. - New [Divider](https://ant.design/components/divider/) component. - 30 New [icons](https://ant.design/components/icon/). ### Breaking Changes We provide a [migration tool](https://github.com/ant-design/antd-migration-helper) to help you find deprecated usages in your codebase. - Card's `noHovering` has been renamed to `hoverable`๏ผŒand its default value now is `true`. - Added new Grid breakpoints. [#7230](https://github.com/ant-design/ant-design/pull/7230) - Form `getFieldDecorator`'s `exclusive` option has been removeed. - Added `Form.createFormField`, and you must use it to wrap field data returned in `option.mapPropsToFields`: ```diff import { Form } from 'antd'; Form.create({ mapPropsToFields() { return { - name: { value: 'antd' }, + name: Form.createFormField({ value: 'antd' }), }; }, }) ``` - Improved global reset style, if you encounter style problem after upgrading, you can try import our v2 compatible style. ```javascript import 'antd/lib/style/v2-compatible-reset'; ``` Or use less ```less @import '~antd/lib/style/v2-compatible-reset.less'; ``` - Since we changed default locale to en_US, LocalProvider is not required any more for English users. - We don't set `size="large"` to `Input` in `Form` by default any more. - `Input.Search` ๐Ÿ” icon don't be interactive anymore, you can use new `enterButton` prop to add a button after input. - UMD version of `dist/antd.js` doesn't include moment any more, you need add moment by yourself if you are using the UMD version. ```diff + ``` ### Removed Deprecations - ๐Ÿ—‘ DatePicker.Calendar has been removed, you can use Calendar directly. - ๐Ÿ—‘ DatePicker's `toggleOpen` prop has been removed, use `onOpenChange` instead. - ๐Ÿ—‘ Form's `inline`, `horizontal`, `vertical` props has been removed, use `layout` instead. - ๐Ÿ—‘ Input's `type` prop has dropped textarea support, please use Input.TextArea instead. - ๐Ÿ—‘ Mention's `toEditorState` has been removed. - ๐Ÿ—‘ Select's `multiple`, `combobox`, `tags` props has been removed, use `mode` instead. ### Features and Improvements - ๐ŸŒŸ Tabs added new size `size="large"`ใ€‚ - ๐ŸŒŸ Row's `gutter` now support responsive setting, you can write `gutter={{ sm: 16, lg: 32 }}`. - ๐ŸŒŸ Spin added new `indicator` prop to allow setting custom indicator. [#7977](https://github.com/ant-design/ant-design/pull/7977) [@kossel](https://github.com/ant-design/ant-design/pull/7977) - ๐ŸŒŸ Input.Search added new `enterButton` prop to allow setting custom search button.[#7596](https://github.com/ant-design/ant-design/issues/7596) - ๐ŸŒŸ Mention added new `placement` prop to allow setting the popup direction. - ๐ŸŒŸ Carousel added new `next()`, `prev()`, `goTo(slideNumber)` methods to allow controlling slides programmatically. - ๐ŸŒŸ Button added link support๏ผŒButton with `href` prop will render to ``. [#8343](https://github.com/ant-design/ant-design/pull/8343) - ๐ŸŒŸ Steps was refactored, first rendering won't flash. [#6010](https://github.com/ant-design/ant-design/issues/6010) - ๐ŸŒŸ Switch added new `loading` prop to show a loading status. - Menu - ๐ŸŒŸ We refactored it with [rc-trigger](https://github.com/react-component/trigger) for delay popup and auto overflow in viewport. - ๐ŸŒŸ Added new `subMenuOpenDelay` and `subMenuCloseDelay` props to allow setting delay time for submenu toggling. - ๐ŸŒŸ Added new `forceSubMenuRender` prop to render submenu even if it's collapsed. [#5586](https://github.com/ant-design/ant-design/issues/5586) - Form - ๐ŸŒŸ Added animations for validation message showing. - ๐ŸŒŸ Added field conditional rendering support. [#react-component/117](https://github.com/react-component/form/issues/117) - Message - ๐ŸŒŸ Allow `duration` optional. [#7857](https://github.com/ant-design/ant-design/issues/7857) [@monkindey](https://github.com/monkindey) - Badge - ๐ŸŒŸ Added new `offset` prop to allow setting the offset of status point. - ๐ŸŒŸ `status` can use whith `children` now. [#8164](https://github.com/ant-design/ant-design/issues/8164) - Card - ๐ŸŒŸ Added new `inner` type. [Demo](https://ant.design/components/card/#components-card-demo-inner)ใ€‚ - ๐ŸŒŸ Added `cover`ใ€`actions` and a new `Meta` component. [Demo](https://ant.design/components/card/#components-card-demo-meta)ใ€‚ - DatePicker - ๐ŸŒŸ Added `mode` and `onPanelChange`๏ผŒto allow controlling the panel mode. [Demo](https://ant.design/components/date-picker/#components-date-picker-demo-mode)ใ€‚ - ๐ŸŒŸ Added `WeekPicker` component. [Demo](https://ant.design/components/date-picker/#components-date-picker-demo-basic) - ๐ŸŒŸ Added new `dateRender` prop to allow customizing date cell. - TimePicker - ๐ŸŒŸ Added new `hourStep`, `minuteStep`, `secondStep` props to allow customizing time setps. [Demo](https://ant.design/components/time-picker/#components-time-picker-demo-interval-options) - ๐ŸŒŸ Added new `focusOnOpen` prop to focus input after panel is open. - Table - ๐ŸŒŸ Added new `components` prop to allow overriding default table elements. ```javascript // You can override following elements const components = { table: MyTable, header: { wrapper: HeaderWrapper, row: HeaderRow, cell: HeaderCell, }, body: { wrapper: BodyWrapper, row: BodyRow, cell: BodyCell, }, }; ``` - ๐ŸŒŸ Added new `onRow` prop to allow passing custom props to table body row. - ๐ŸŒŸ Added new `onHeaderRow` props to allow passing custom props to table header row. - ๐ŸŒŸ Added `column[onCell]` to allow passing custom props to table body cell. - ๐ŸŒŸ Added `column[onHeaderCell]` to allow passing custom props to table header cell. - ๐ŸŒŸ Added `column[align]` to allow setting how text aligns. - ๐ŸŒŸ Added `column[defaultSortOrder]` to allow setting default sort order. [#8111](https://github.com/ant-design/ant-design/pull/8111) [@megawac](https://github.com/megawac) - ๐ŸŒŸ Added `rowSelection[fixed]` to allow fixing the selection column.ใ€‚ - ๐Ÿ™… Deprecated `getBodyWrapper`, please use `components` instead. - ๐Ÿ™… Deprecated `onRowClick`๏ผŒ`onRowDoubleClick`ใ€`onRowContextMenu`ใ€`onRowMouseEnter`ใ€`onRowMouseLeave`, please use `onRow` instead. ```javascript
({ onClick: () => {}, onDoubleClick: () => {}, onContextMenu: () => {}, onMouseEnter: () => {}, onMouseLeave: () => {}, })} /> ``` - Select - ๐ŸŒŸ Option's value can be a number in single or multiple mode. - ๐ŸŒŸ Added new `maxTagCount` and `maxTagPlaceholder` props. - ๐ŸŒŸ Added new `showAction` prop to allow setting the trigger action for popup. - ๐ŸŒŸ Added new `onMouseEnter` and `onMouseLeave` callback. - LocaleProvider - ๐Ÿ‡ฎ๐Ÿ‡ธ Added Icelandic. [#7561](https://github.com/ant-design/ant-design/pull/7561) [@paunovic-stefan](https://github.com/paunovic-stefan) - ๐Ÿ‡ช๐Ÿ‡ฌ Added Egyptian Arabic. [#7888](https://github.com/ant-design/ant-design/pull/7888) [@mohamed-seada-1994](https://github.com/mohamed-seada-1994) - ๐Ÿ‡บ๐Ÿ‡ฆ Added Ukrainian. [#8169](https://github.com/ant-design/ant-design/pull/8169) [@anxolerd](https://github.com/anxolerd) ### Bug fixes - Form - ๐Ÿž Fixed issue result in Input icon is hovered by feedback icon. - ๐Ÿž Fixed feedback icon not centered in large input. - ๐Ÿž Fix Menu key press error. [#8089](https://github.com/ant-design/ant-design/issues/8089) ### Other things - Don't need set `allowSyntheticDefaultImports` when using in TypeScript. - We removed `react@0.14` and `react@15` from `peerDependencies`, though `antd@3.0` still works on old React versions, but we highly recommend you upgrading to React 16 since we may use the new features only exists in React 16 in the future. See [React 16](https://reactjs.org/blog/2017/09/26/react-v16.0.html) - Fully es module support, if you are using webpack 3, you can set babel-plugin-import's `libraryDirectory` to `es` to enable tree shaking . - We will support 2.x branch until June in next year. ## 2.x Visit [GitHub](https://github.com/ant-design/ant-design/blob/2.x-stable/CHANGELOG.en-US.md) to read `2.x` change logs. ## 1.11.4 Visit [GitHub](https://github.com/ant-design/ant-design/blob/1.x-stable/CHANGELOG.md) to read change logs from `0.x` to `1.x`.