更新日志
antd
严格遵循 Semantic Versioning 2.0.0 语义化版本规范。
发布周期#
修订版本号:每周末会进行日常 bugfix 更新。(如果有紧急的 bugfix,则任何时候都可发布)
次版本号:每月发布一个带有新特性的向下兼容的版本。
主版本号:含有破坏性更新和新特性,不在发布周期内。
3.3.0#
2018-03-12
🌟
Calendar
组件新增validRange
属性,用于设置显示的时间范围。71f65a0 @Rohanhacker🌟
Card
组件新增defaultActiveTabKey
属性,用于初始化选中面板的 key。30fe88d @u3uDatePicker
🌟
Divider
组件新增orientation
属性,用于设置分割线内文本的对齐方式。#9275 @jrvboesch🌟
Modal
组件新增keyboard
属性,用于设置按下Esc
键是否可以关闭Modal
。#8818🌟 优化
Radio
和Checkbox
组件onChange
属性中的事件参数的TypeScript
类型定义的问题。#9574Table
🌟 新增
pagination
属性的配置项position
,用于设置分页的显示位置。#9357 @kanweiwei🌟 新增
rowSelection
属性的配置项onSelect
回调函数的事件参数。#9376 @kanweiwei🌟 新增
rowSelection
属性的配置项columnWidth
,用于设置选择框的列宽。#9474 @SimpleFrontend🐞 修复
Table
组件在Chrome
下圆角边框样式的问题。af8e54f
🌟
Timeline
组件新增pendingDot
属性,用于设置幽灵节点的图标。#9546 @SimpleFrontend🌟
TimePicker
组件新增inputReadOnly
属性,用于设置组件是否只读。4a69446 @JesperWe🐞 修复
Progress
组件的successPercent
属性无法决定组件是否处于success
状态的问题。#9382🐞 修复
Tabs
组件字体尺寸的问题。#9509🐞 修复
Tree
和TreeSelect
组件的父节点在disabled
状态下无法展开的问题。#9539
3.2.1#
2018-02-11
🌟 新增了部分著名产品的图标。c04377e5
Mention
🌟 现在
multiLines
模式的高度将默认自适应内容。🐞 修复指定了
placeholder
时无法粘贴内容的问题。#9215
Table
Select
🐞 修复使用键盘导航时,滚动条不会自动定位的问题。#9276
🐞 修复在 IE11 下的箭头位置。
🐞 修复 Upload
beforeUpload
返回false
时,上传文件仍然显示uploading
以及文件列表被替换的问题。#8020🐞 修复
vertical
布局的 Form 下反馈图标错位的问题。#9153🐞 修复 Card 没有子节点时
loading
样式不生效的问题。#9258🐞 修复 Avatar 的图片不存在时的背景色。#9278 @andriijas
🐞 修复 RangePicker 选择结束时间时报
Cannot read property 'locale' of undefined
的问题。#9267🐞 修复 Dropdown 的子菜单被遮挡的问题。#9218
3.2.0#
2018-02-04
🌟 Tab 新增
tabBarGutter
属性,用于设置 tabs 之间的间隙。#8644 @lixiaoyang1992🌟 Layout 新增
hasSider
属性,用于避免服务端渲染时显示问题。#8937🌟 Progress 新增
successPercent
属性,用于显示分段进度条。例子🌟 DatePicker 新增
id
属性。#8598 @mgrdevport🌟 Collapse 新增
forceRender
属性,用于渲染隐藏的内容。#9192 #Pyroboomka @paulcmasonRangePicker
Select
🌟 改进了
onChange
、onDeselect
方法,现在他们会接受选中的Option
作为第二个参数。🐞 修复自动分词不触发
onSelect
的问题。#9094🐞 修复 Chrome 上下拉框没有滚动条的问题。
🌟 改进 Table 的
rowSelection[getCheckboxProps]
属性,现在可以传任意属性给 chekbox 了。#9054 @mgrdevport🐞 修复 Calendar 的
mode
属性不能从外部控制的问题。#9243 @mgrdevport🐞 修复 AutoComplete 在 Form 中显示错误信息时的边框颜色。9f2b490
🐞 修复 DatePicker 在受控模式下时间显示不正确的问题。#8885
🐞 修复 Tabs 在 card 模式且 tabPosition 是
bottom
时的样式问题。#9165 @ryanhoho🌟 新增库尔德语。
3.1.5#
2018-01-27
🐞 修复了 Select 下拉选择框在 IE11 点击滚动条会无故消失的问题。#7934 @tianlang89757
🐞 修复了 Form 中使用
getFieldDecorator
当 id 重复时引用冲突的问题。#9103 #7351🐞 修复了 RangePicker 在语言切换时会显示上一次的语言的问题。#8970
🐞 修复了 DatePicker 在受控模式下时间显示不正确的问题。#8885
🐞 修复了 Table 在
loading
时显示空提示的问题。#9095 @sallen450🐞 修复写错的字体名称,造成浏览器无法正确识别的问题。commit/506f97
📖 修复了 TypeScript 定义
补充 Notification 缺失的
duration
定义。pull/9120 @duhongjun补充 Steps 缺失的
style
定义。pull/9126 @wanliyunyan
🌟 优化了 Avatar 的默认背景色。commit/275946
🌟 新增了 Slider 以及 Menu 的 less 变量,更加方便的修改主题。pull/9065 pull/9115 @mrgeorgegray
3.1.4#
2018-01-21
🐞 修复 ButtonGroup 错误 z-index 导致的样式问题。#9014
🐞 修复 Dropdown.Button 不能被完全禁用的问题。#8991 @sallen450
🐞 修复 List
grid
不支持 xxl 配置的问题。#9019🐞 修复 RangePicker 关闭选择面板之后无法清空已选开始时间的问题。#8839
🐞 修复 Tabs 错误外边距导致的样式问题。commit/200d6c
🐞 修复 WeekPicker 显示错误周数的问题。#9021
🐞 修复 TypeScript 定义
补充 Menu 缺失的
subMenuCloseDelay
和subMenuOpenDelay
。#8976 @Rohanhacker重构了 DatePicker 相关 type 定义。commit/0bb531
🌟 新增 less 变量
Checkbox 和 Radio 相关:#9003 @mrgeorgegray
Breadcrumb 相关:#9022 @mrgeorgegray
🌟 新增 aliyun 图标。
3.1.2#
2018-01-13
🐞 修复 Button 不能正确显示
0
的问题。#8733 @Cuihongsen🐞 修复 Table 和 List 中由于 Spin 导致的滚动条。#8799
🐞 修复不能传方法给 TableemptyText 的问题。#8871
🐞 修复 DropdowntransitionName 不生效的问题。
🐞 修复 Input 中输入数字时字体会发生变化的问题。 #8636
🐞 修复 import 多个 locale 文件后日期文本显示错误的问题。#8785
🐞 修复 dist/antd-with-locales.js 中的 locale 会多一个 default 字段的问题。#8881
🐞 修复 TypeScript 定义 4cc29bc 693e734 67e956d ecd4177 33119ec 88e0c9b
🌟 优化中文引号的显示。
3.1.1#
2018-01-08
📖 发布了全新的官网和设计文档。
📖 更新了项目实战文档到 roadhog 2.0。5dcf1c0
📖 发布了 Ant Design 3.0 的 sketch 模板包。22dfe88
🐞 修复 Dropdown 组件的 TypeScript 类型定义中 trigger 属性缺少 contextMenu 事件的问题。#8646 @cjahv
🐞 修复 Button 内使用 HOC 组件时两个中文字符间未添加空格的问题。
🐞 修复 List 组件在 IE 11 下的样式兼容问题。#8784
🐞 修复 Select 组件 notFoundContent 属性不生效的问题。#8809
🐞 修复 BackTop 组件在 React 16 下 target 属性出现警告的问题。#8848
🐞 修复当设置 gutter 后 List 组件出现横向滚动条的问题。#8799
🐞 修复 Anchor.Link 的 href 属性不支持完整链接的问题。#8808
🌟 优化中文引号的字体。c6fcc31
3.1.0#
2017-12-29
新年快乐!~ 2018年了,00后都成年了!少年赶紧提个 PR 给我们吧!~
🐞 修复 Table 在设置
size=small
的情况下出现多余 padding 的问题。#8724🐞 修复 Checkbox.Group 在 Form 中和 label 的对齐问题。#8739
🐞 修复 Affix 组件出现滚动条的问题。#8606
🐞 修复组件 List "No Data" 和加载动画重叠的问题. #8647
🌟 为 Input 添加 onKeyUp。#8705 @delesseps
🌟 折叠面板 Collapse 添加
showArrow
来支持隐藏箭头。#8536 @apieceofbart🌟 评分 Rate 组件添加
allowClear
,支持再次点击后重置。#8627🌟 优化 BackTop 组件的响应式效果。#8719 @JetRunner
🌟 Modal 组件添加
destroyOnClose
支持关闭时销毁 Modal 里的子元素。#8769 @Rohanhacker🌟 组件 Pagination 添加
hideOnSinglePage
支持当只有一页时隐藏组件。#8615 @camsong🌟 支持 List 组件自定义加载动画。
👻 你现在可以通过 CodeSandbox 来打开官方文档中的示例了。
3.0.2#
2017-12-17
📝 提供了 3.0 迁移工具。e71b68dd
📝 重写了 开源贡献指南
🌟 优化 notification 在小屏幕下的显示效果。#8631
🌟 优化了 Pagination 的样式和并修复了对齐和边距问题。
🐞 升级 react-slick 到
0.16.0
,修复 peerDependencies 安装警告。#8455🐞 修复固定列头的表格大小设置无效的问题。#8577
🐞 修复 DatePicker 等时间组件的
locale
属性失效的问题。#8635🐞 修复 AutoComponent 的
notFoundContent
设置无效的问题。#8553🐞 微调 RangePicker 的垂直对齐问题。
🐞 Layout.Sider 的响应式断点和栅格系统保持一致。#8620
🐞 修复一个 collapsedWidth 为 0 时,收缩后子菜单依然会显示的问题。#8587
🐞 修复 Card 的
Meta.title
文本无法自动截断的问题。#8597🐞 修复带边框的 List 下的分页样式边距。#8562
🐞 修复一个 Menu 指定了不存在的 defaultOpenKeys 时子菜单无法展开的问题。#8475
🐞 修复 Input、AutoComplete、Transfer 的
InputProps
和SearchProps
TypeScript 类型命名冲突。#8478
3.0.0#
2017-12-04
更多内容见 Ant Design 3.0 发布公告!
主要变化#
全新的色彩系统,组件主色由 『
#108EE9
』 改为 『#1890FF
』,新主色我们称之为『拂晓蓝』。全新的视觉样式和组件尺寸,更现代更美观。
基础字体大小由
12px
增大到14px
。默认语言由中文改为英文。
全面支持 React 16。
更友好的 TypeScript 支持。
新的 List 组件。
新的 Divider 组件。
新增 30 个图标。
不兼容改动#
此版本有部分不兼容的改动,升级时确保修改相应的使用代码。另外由于人肉查找代码中的废弃用法过于低效,所以我们提供了 antd-migration-helper 用于扫描代码中的废弃用法。
Card 的
noHovering
属性重命名为hoverable
,且默认值改为true
。调整了 Grid 的响应式断点值。详见 #7230
Form
getFieldDecorator
的exclusive
参数被移除,此类场景应该由 Radio.Group、Checkbox.Group 之类的组件来完成。新增
Form.createFormField
方法,mapPropsToFields
返回的字段都需要由该方法创建。import { Form } from 'antd'; Form.create({ mapPropsToFields() { return { - name: { value: 'antd' }, + name: Form.createFormField({ value: 'antd' }), }; }, })
优化了全局的重置样式,如果升级后你的全局样式有问题,可以引入我们提供的 2.x 兼容样式。
import 'antd/lib/style/v2-compatible-reset';
或者在 less 里引入
@import '~antd/lib/style/v2-compatible-reset.less';
由于默认语言改为英文,如果你需要显示中文,现在需要配置
LocalProvider
。import { LocaleProvider } from 'antd'; import zhCN from 'antd/lib/locale-provider/zh_CN'; ReactDOM.render( <LocaleProvider locale={zhCN}><YourApp /></LocaleProvider>, document.getElementById('root') );
Form 下的表单控件不再默认为
size="large"
。Input.Search
默认的 🔍 图标只作为装饰,不再响应用户交互。需要添加可交互按钮请使用enterButton
。UMD 版本的
dist/antd.js
不再包含 moment,使用的时候需要自己引入 moment。<html> <head> + <script src="https://unpkg.com/moment@2.19.3/moment.js"></script> <script src="https://unpkg.com/antd@3.0.0/dist/antd.js"></script> </head> </html>
以下在 2.x 中废弃的特性被移除#
🗑 移除了 DatePicker.Calendar, 请直接使用 Calendar 组件。
🗑 移除了 DatePicker 的
toggleOpen
属性, 请使用onOpenChange
代替。🗑 移除了 Form 的
inline
、horizontal
、vertical
属性,请使用layout
代替。🗑 移除了 Select 的
multiple
、tags
、combobox
属性,请使用mode
代替。🗑 移除了 Input 对
type='textarea'
的支持,请直接使用Input.TextArea
组件。🗑 移除了 Mention 的
toEditorState
方法,请使用toContentState
代替。
新增功能及改进#
🌟 Tabs 新增
size="large"
。🌟 Row 的
gutter
属性新增响应式断点的支持,可以使用诸如gutter={{ sm: 16, lg: 32 }}
的设置。🌟 Input.Search 新增
enterButton
用于设置自定义的搜索图标。#7596🌟 Mention 新增
placement
, 用于设置下拉框的弹出方向。🌟 Carousel 新增
next()
、prev()
、goTo(slideNumber)
方法,用于控制面板展示。🌟 Button 新增链接支持,当提供
href
时会自动渲染为<a>
。#8343🌟 Steps 进行了重构,首次渲染的时候不会再闪烁。 #6010
🌟 Switch 新增
loading
属性,用于表现加载中的状态。Menu
🌟 我们使用了 rc-trigger 重构了菜单以支持延迟加载和窗口边缘浮层自适应方向。
🌟 新增
subMenuOpenDelay
和subMenuCloseDelay
,用于设置子菜单打开和关闭的延迟。🌟 新增
forceSubMenuRender
,用于强制渲染子菜单。#5586
Form
🌟 新增显示验证信息时的动画效果。
🌟 新增按条件渲染表单项的支持。#react-component/117
Message
🌟
duration
允许可选 #7857 @monkindey
Badge
🌟 新增
offset
属性,用于设置状态点的位置偏移。🌟
status
允许与children
同时使用。#8164
Card
DatePicker
TimePicker
🌟 新增
hourStep
、minuteStep
、secondStep
,用于设置时间步长。例子🌟 新增
focusOnOpen
,用于设置在打开面板的时候是否聚焦输入框。
Table
🌟 新增
components
属性,用于覆盖表格元素的默认标签。// 支持覆盖的元素 const components = { table: MyTable, header: { wrapper: HeaderWrapper, row: HeaderRow, cell: HeaderCell, }, body: { wrapper: BodyWrapper, row: BodyRow, cell: BodyCell, }, }; <Table components={components} columns={columns} data={data} />
🌟 新增
onRow
属性,用于设置表格列的属性。🌟 新增
onHeaderRow
,用户设置表格头部列的属性。🌟 新增
column[onCell]
,用户设置单元格的属性。🌟 新增
column[onHeaderCell]
,用于设置头部单元格的属性。🌟 新增
column[align]
,用于设置列内文字的对其方向。🌟 新增
rowSelection[fixed]
,用于固定选择列。🙅 废弃
getBodyWrapper
,请使用components
属性代替。🙅 废弃以下属性
onRowClick
,onRowDoubleClick
、onRowContextMenu
、onRowMouseEnter
、onRowMouseLeave
,请使用onRow
代替。<Table onRow={(record) => ({ onClick: () => {}, onDoubleClick: () => {}, onContextMenu: () => {}, onMouseEnter: () => {}, onMouseLeave: () => {}, })} />
Select
🌟 默认和多选模式下 Option 的值允许使用 number。
🌟 新增
maxTagCount 和
maxTagPlaceholder`,用于设置最多可显示的选中项。🌟 新增
showAction
,用于设置出发下拉框打开的事件。🌟 新增
onMouseEnter
和onMouseLeave
事件回调。
LocaleProvider
🇮🇸 新增冰岛语。#7561 @paunovic-stefan
🇪🇬 新增埃及语。#7888 @mohamed-seada-1994
Bug 修复#
Form
🐞 修复输入框的图标会被验证图标覆盖的问题。
🐞 修复使用大尺寸输入框时,验证图标不居中的问题。
🐞 修复 Menu 按键时的报错。#8089
其他#
在 TypeScript 中使用时不再需要设置
allowSyntheticDefaultImports
。从
peerDependencies
中移除了react@0.14
和react@15
,虽然目前 antd 3.0.0 依然可以在旧版本的 React 上使用,但是我们在未来有可能使用 React 16 的新特性,所以强烈建议升级到 React 16,见升级文档。全面支持 ES Module ,antd 及其依赖的底层 react-component 组件全部提供了 ES Module 的构建版本,如果你使用 webpack 3,可以把
babel-plugin-import
的libraryDirectory
设置为es
,以获得 Tree Shaking 的优化效果。最后,我们会继续维护 2.x 的分支到明年 6 月份。