39 KiB
order | title | toc | timeline |
---|---|---|---|
3 | 更新日志 | false | true |
如果需要查看 0.12.x
及之前的更新日志,请移步 GitHub。
2.0.0
2016-09-28
很高兴的通知各位,经过四个月时间的紧密开发,antd@2.0.0
终于发布了。这个版本我们重构了底层代码,持续完善现有组件功能和优化细节,并提供了英文版的文档,其中很多都来自社区的贡献,无法一一感谢,欢迎各位持续关注和鞭策。在升级过程中遇到任何问题,请及时 反馈给我们。
2.x 主要变化
- 开发语言改为 TypeScript,提供 官方支持的
.d.ts
文件,感谢 #1846 中所有参与到这次重构的人以及后期 @infeng 对其的完善。 - 新增英文文档, 以后将同时提供中英双语文档,感谢 #1471 里所有参与到翻译、review 中的人。
- 时间类组件 DatePicker、TimePicker、Calendar 等的底层 使用 moment 替换 gregorian-calendar。
- 全新设计的 图标。
- 新增提及组件 Mention。
- 新增自动完成组件 AutoComplete。
- Form 新增
getFieldDecorator
作为getFieldProps
的替代,对于不正确的使用方式getFieldDecorator
会给出提示,可以降低踩坑的概率。相关讨论见 #1533。 - Table 支持 表头分组。@yesmeck
- 完全移除
antd@1.x
中已经废弃的 QueueAnim、Validation、Form.ValueMixin、Progress.Line、Progress.Circle、Popover[overlay] 及 Slider[marks] 对数组的支持。
2.x 不兼容改动
此版本有部分不兼容的改动,升级时确保修改相应的使用代码。
- 时间类组件的
value
和defaultValue
不再支持String/Date
类型,请使用 moment。- <TimePicker defaultValue="12:08:23" /> + <TimePicker defaultValue={moment('12:08:23', 'HH:mm:ss')} /> - <DatePicker defaultValue="2015/01/01" /> + <DatePicker defaultValue={moment('2015/01/01', 'YYYY/MM/DD')} /> - <Calendar defaultValue={new Date('2010-10-10')} /> + <Calendar defaultValue={moment('2010-10-10', 'YYYY-MM-DD')} />
- 时间类组件的
onChange
和onPanelChange
及其他回调函数中为Date/GregorianCalendar
类型的参数,均修改为 moment 类型,两者 API 有所不同,但功能基本一致,请对照 moment 的 API 文档 和 gregorian-calendar 的文档 进行修改。由于JSON.stringy(date: moment)
返回的值会丢失时区设置,所以要先使用.format
把日期转成字符串,相关 issue 见 #3082:handleSubmit() { const values = this.props.form.getFieldsValue(); values.date = values.date.format('YYYY-MM-DD HH:mm:ss'); // 或其它格式 const data = JSON.stringify(values); // 发送 data 到服务器 }
- 时间类组件的
format
属性配置也调整为与 moment 的一致。 - Breadcrumb 移除
linkRender
和nameRender
,请使用itemRender
。 - Menu 移除
onClose
onOpen
,请使用onOpenChange
。API 差异较大,请先研究 demo。 - Table 移除列分页功能,请使用 固定列。
以下变化升级后旧代码仍然能正常运行,但是控制台会出现警告提示,建议按提示进行修改。
- Form 废弃
getFieldProps
,请使用getFieldDecorator
:+ getFieldDecorator('userName', { ... })( <Input placeholder="请输入账户名" - {...getFieldProps('userName', { ... })} /> + )
- DatePicker 废弃
toggleOpen
,请使用onOpenChange
:- handleToggleOpen({ open }) { + handleOpenChange(open) { ... }
2.x Bug 修复
- 修复 Dropdown.Button
disabled
属性无效的问题。#3070 - 修复 Form.create
withRef
选项失效的问题。#2843 - 修复 Menu inline 模式下子菜单展开的问题。#2701
- 修复 Modal.confirm 之类的弹窗在异步调用时按钮仍可点击的问题。#2684
- 修复 DatePicker[showTime] 参数中的
format
失效的问题。#3123 - 修复 Table[dataSource] 中的项的 key 为
0
时识别错误的问题。#3166 @noonnightstorm - 修复 Tree.Node 无子节点时仍然显示箭头的问题。#2616
- 修复 Tree.Node 箭头隐藏后鼠标 hover 上去光标仍会发生变化的问题。#2748
2.x 其他改进
- Alert 新增
banner
模式。 - BackTop 增加回到顶部的动画效果。
- Badge 新增 状态点模式。
- Cascader 新增 搜索功能。
- Checkbox 新增 indeterminate 状态。
- Form 新增 垂直布局。
- InputNumber 现在支持长按。#
- notification 支持 自定义 icon。
- Spin 现在允许 自定义文案与动画共存。@jerrybendy
- Transfer 现在可以监听用户选择了哪些选项。#
- Transfer 现在可以定义哪些选项是 不可选择的。
- 优化 Alert 和 notification 的样式。
- 优化 Modal.confirm 之类的弹窗的键盘交互。@Dafrok
- 优化 DatePicker 的时间选择 交互。
- 优化 Spin 状态切换 时的效果。
- 更新 font-family。
2.x 相关工具发布
- 新增配套网站 AntD Library,提供遵循 Ant Design 设计规范的组件、模式等的 Axure 资源。
babel-plugin-antd
更名为babel-plugin-import
,标志着该插件将作为一个通用的按需加载方案存在,而不再是antd
专有。 请更新package.json
:{ "devDependencies": { - "babel-plugin-antd": "^0.x.x", + "babel-plugin-import": "^1.0.0", } }
同时更新
.babelrc
或你在其它地方对其的配置:{ - "plugins": [["antd", { style: "css" }]] + "plugins": [["import", { libraryName: "antd", style: "css" }]] }
dva@1.0.0
也已经发布,并推荐 在实战项目中使用。- 脚手架工具推荐使用
dva-cli
,原来的antd-init
以后仅会用于学习以及 demo。
1.11.2
2016-09-26
1.11.1
2016-09-14
- 修复 Menu 设置成
theme=dark
后,链接点击无效的问题。#2929 - 修复迷你型 Table 表头与内容不对齐的问题。#2933
- 修复 Cascader hover 样式。#3015
- 修复 Upload 上传多个文件时,
onChange
调用不正确的问题。#3001 - 修复 TimePicker 报错样式的问题。#2973
- 修复 Calendar 控件的年度选择下拉内容截断的问题。#2927
1.11.0
2016-09-01
Tooltip
Popover
Popconfirm
修正默认对齐方式为边缘对齐,增加 arrowPointAtCenter 属性用于箭头指向中心的行为。commit 977e2e3Table
InputNumber
样式问题修复。#2876- 修复手动导入 less 文件时 input error 样式被 focus 样式覆盖的问题。#2916
- index.d.ts 中补充了一些缺失的声明,修复
Form
中 typescript 语法检查报错的问题。#2885 - 升级 react-slick 依赖到
0.13
。
1.10.0
2016-08-20
- Affix 和 BackTop 新增
target
属性,支持指定滚动容器。#2718 - 文档页面加上编辑按钮,方便社区贡献。#2325
- 升级 rc-cascader 依赖,修复一个
loadData
属性和表单结合使用的问题。#2767 - 修复
editable-card
类型的 Tabs 没有关闭图标的问题。#2747 - Menu 修正默认
z-index
。#2762 - 修正 Select 组件在 IE 下的一些样式问题。#2741
1.9.1
2016-08-16
1.9.0
2016-08-15
- Transfer 修复在火狐下 item 文案过长时只显示省略号的问题。#2674
- Input 修复
autosize
模式下特定场景中不能输入中文及光标定位不准的问题。#2666 #2239 - Tabs 修复
type="editable-card"
模式下的children
解析问题。#2658 - Radio 修复若干 less 硬编码问题。#2424
- Upload 的 rc-upload 依赖升级至 2.x,引入的变化有:
- Table
- Popover 修复设定
getTooltipContainer
后会导致内嵌 DatePicker 样式失效的问题。#2675 - Modal 修复重复卸载组件导致的报错。#2688
- 升级 rc-slider 组件依赖。
1.8.0
2016-08-08
- 修复可关闭 Tabs 组件只有一个 Tab 的时候报错的问题。#2559
- 修复 Datepicker 在 IE8 下关闭图标。#2584
- Tags 支持自定义标签颜色。#2585
- TreeSelect 修复未找到内容时的样式。9cee9f
- Modal 适配小屏幕。#2597
- 修复了 Row 组件在同一行闭合会报错的问题。#2603
- Table 的
rowSelection.onChange
的参数selectedRows
现在和selectedRowKeys
保持一致。#2566 - Checkbox 和 Radio 现在支持
onClick
属性。
1.7.0
2016-07-30
友情提示 Ant Design Mobile 已经发布。
- Table
- Form 现在不再需要显式传递
form={this.props.form}
。 - 优化 Breadcrumb.Item 的 hover 效果。
- 优化 Progress 的动画效果。
- DatePicker
- 优化清除按钮样式。
- 修复点击
此刻
时不触发onChange
的问题。#1902
- Menu
- 修复子菜单中的 Item 被选中后,父级元素无样式变化的问题。#2414
- 修复 Menu.Item disabled 后的样式问题。
- TreeSelect
- 修复了 Select 组件 placeholder 溢出的问题。#2480
- 修复 Timeline.Item 无法自定义边框颜色的问题。#2479
- 修复 Spin 显示突兀的问题。#2398
- 修复 Cascader 选项文字过长导致的样式问题。#2515
1.6.5
2016-07-16
- 修复 Input 的
value prop on input should not be null
警告并且导致在表单中无法重置的问题。#2335 - 优化 FormItem 的布局实现,修复表单布局不支持响应式布局的问题。#2305
- 修复带时间的 DatePicker 的 onChange 触发逻辑。#2399
- 修复 Transfer 搜索后全选的问题。#2396
- 修复 Cascader 样式会被 ant-input 样式覆盖的问题。#2400
- 修复 Table 删除数据时导致当前页数溢出的问题。#2301
- 修复 resize 浏览器时 Affix 元素没有和原来的位置同步的问题。#1987
- 给 Affix 元素添加占位,修复固定时页面跳动的问题。
- 修复 Select combobox 模式会导致页面出现横向滚动条的问题。#2353
- 修复 Upload 组件已上传文件链接点击无效的问题。#2331
- 修复 Upload 上传过程中删除图片后的报错问题。#2342
1.6.4
2016-07-08
- 修复组件在 react@15.2.0 下报 Unknown props 警告的问题。#2258
Table
Form
- 修复
FormItem
中带空格后缀的冒号替换问题,关联issue:#1877 - demo 优化。
- 修复
Transfer
- 修复
Steps
最后一步多余横线隐藏的问题。 - 修复
Cascader
small size 样式下沉 1px,以及 hover/click 样式残缺的问题。#2234 - 修复
RangePicker
无清除按钮的问题。#2252
1.6.3
2016-07-04
- 修复 Transfer 的一个 unmount 的错误。#2206
- 修复了 Badge、Alert、Menu、Tag、Checkbox、Radio 组件的一些样式细节问题。
1.6.2
2016-06-27
- 修复 Table、Transfer 的样式错位问题。
- 修复 DatePicker 的一个样式问题。#2182
- 优化 Menu 的 hover 样式响应性能。
1.6.1
2016-06-24
- 回滚一个未完成的 DatePicker 时间选项改造效果。
1.6.0
2016-06-24
- 新增置顶组件 BackTop。
- 全新的 Spin 样式。
- 给
Modal.xxx
系列方法添加了{ destory }
的访问值,方便事后销毁。#2110 - Table 的
rowKey
属性支持直接使用字符串。#2058 - Table 增加
column.filterDropdown
属性用于自定义渲染筛选菜单的浮层。#1736 - 修复 Tooltip、Popover、Popconfirm 设置
onVisibleChange
后失效的问题。#2134 - 修复在 IE8 下 Checkbox 的勾样式变形的问题。#2148
- 优化 Checkbox、Radio 失效状态的文字颜色。#2114
- 优化 Checkbox、Radio 的默认边距过于拥挤的问题。#2137
- 优化 Pagination 在暗色背景下的样式。#2126
- 修复 Table 固定列时内容无法换行和高度对齐的问题,同时修复了一个 Chrome 下的表格内容错位问题。#2130
- 修复一个 Table 的
rowSelection
设为 null 时可能导致报错的问题。#2127 - 修复在 IE8 下点击 Table 选择框报错的问题。#2154
- 小幅优化了 Transfer 的渲染性能。#2112
- 将 DatePicker 的清除按钮从面板上移到外部输入框,解决用户容易误解为关闭的问题。#1708
- Upload 的
onPreview
现在没有file.url
时也能生效。#2163
1.5.1
2016-06-21
- 修复一个 TypeScript 定义文件的语法错误。
- 修复 Table 固定表头高度和滚动条样式问题。
1.5.0
2016-06-17
- 升级
rc-form
到 0.17,支持getFieldProps('xx.yy')
的写法,并支持单多选控件进行关联。# - Input 的
addonBefore
和addonAfter
支持内嵌选择框。#1927 - 优化了两个 DatePicker 组成的时间范围选择演示的体验。
- 优化一个多个对话框的遮罩层高度的问题。#2009
- 优化 Table 的
getCheckboxProps
的调用次数。#2086 - 修复 Table 固定列时,表头无法左右滚动的问题。#2068
- 修复小型表格固定表头的样式。#2023
- 修复 Tabs 的
tabPosition
为左右时样式错位的问题。#2046 - 修复 RangePicker 的日期范围背景丢失的问题。
- 修复 Switch 失效状态下文字颜色太浅的问题。#2051
- 修复一个 Select 的
disabled
选项依然可以被移除的问题。#2034 - 修复官方站点在 IE 下的报错问题。
1.4.1
2016-06-12
- 修复一个展开 Tabs 会导致表格宽度溢出的问题。#2013
- 修复一个某些情况下表格布局被破坏的问题。
1.4.0
2016-06-12
此版本之后你可能会遇到 #2030,请使用 react@15+
或 npm@3+
。
Input[type="textarea"]
支持自动调整高度。 #Breadcrumb
nameRender
新增route
和params
参数。 #1999linkRender
新增paths
参数。
- 再次修复
Table
组件rowSelection.onChange
与onRowClick
冲突问题。 #1470 - 修复
Form.Item
中Input
高度抖动问题。 #1955 - 修复高级搜索的
ant-advanced-search-form
样式丢失的问题。
1.3.2
2016-06-06
- 修复全局模式下引用 antd,IE8 环境报错的问题。 #1970
1.3.1
2016-06-06
- 修复
Message
Notification
找不到的问题。 #1968
1.3.0
2016-06-02
- Transfer 组件增加
rowKey
属性,可自定义数据源主键。 #1900 - Tag 组件
default
类型的样式增加边框,防止淹没在背景中。 #1910 - Table
- 修复筛选为单选时仍旧展示多选框的问题。 #1880
- 修复 fixed left 的固定列会覆盖 rowSelection 的 Checkbox 的问题。 #1829
- 升级 rc-table 依赖
- 修复了 fixed 列中数据重复展示以及一些错位问题。 #1898
dataIndex
支持内嵌属性的写法。 react-component/table#46
- 修复了 v1.2.0 新增加的组件属性的 TypeScript 定义。 #1933
- Form 修复 label中冒号的国际化问题,采用样式实现冒号,不再需要手动输入冒号。 #1877
- 修复 DatePicker 组件点击『此刻』失效的问题,并进行了一些代码优化。 #1902
- 升级 rc-upload 依赖,修复了 IE10 中第二次上传同一文件不触发
onChange
的问题。 058af3c - 文档使用 bisheng 重构。
1.2.1
2016-05-27
- 修复一个 Select 组件的文字重复问题。
1.2.0
2016-05-26
- Input 组件的文档现在和 Form 分离。 3c98d3
- Affix
- Table
- 修复了当 Checkbox 的 label 为数字 0 时, label 不显示的问题 #1811
- 修复 Select combobox 模式下无法重置
optionLabelProp
的问题。#1773 - 修复了 Tag 组件为 closeable 时,内部链接无法点击的问题 #1862
- Tab 组件新增
hideAdd
属性,用于关闭右边的添加按钮 #1750 - 修复了一个在某些情况下找不到
normalize.css/normalize.css
文件的问题。ant-design/antd-init#52 - 修复构建文件在 IE8 下报错的问题。#1804
- 更新了第三方依赖。
1.1.0
2016-05-18
- Cascader 的选择框支持自定义渲染节点,并给
displayRender
方法增加了selectedOptions
参数。#1726 - Input.Group 新增
size
属性,可设置控件尺寸。#1732 - Layout 新增常用布局:侧边导航展开收起模式。#1643
- Transfer 支持自定义渲染行数据。#1664
- Upload 的 children 为空时,不再显示上传按钮。#1610
- Table
- Modal
- 将搜索输入框相关样式移到 Input 组件下。7b7f846
- 修复 Select 获得焦点时的样式问题。#1684
- 修复 TreeSelect 占位符样式问题。#1657
- 修复了类型定义以更好地支持
TypeScript
。#1696 @xujihui1985 - 优化了 LocaleProvider。a3850a4
- 其他组件的样式优化。
1.0.1
2016-05-11
- 修复当 Table 的
rowSelection.type
为 'radio' 时的报错。#1627 - 修复 CheckboxGroup 与
getFieldProps
共用时的问题。#1631 - 修复 RangePicker 中 TimePicker 不会受 locale 控制的问题。#1635
- 修复 Tag 组件缺失的问题。
- 修复 Table 的 className 不在最外层容器上的问题。
- 修复一个样式文件重复打包的问题。
1.0.0
2016-05-09
很高兴的通知各位,经过四个月时间的紧密开发,antd@1.0.0
终于发布了。从去年 5 月 7 日提交第一行代码以来,经过整整一年的开发迭代,antd 受到社区的大量关注,使用的公司和产品持续增加,已经日趋成熟。这个版本我们重构了底层代码和站点,持续完善现有组件功能和优化细节,其中很多都来自社区的贡献,无法一一感谢,欢迎各位持续关注和鞭策。在升级过程中遇到任何问题,请及时反馈给我们。
主要变化
- 兼容 React@15.x。
- 全新单页站点,使用 React 和 antd 进行了彻底重构,加载更快,访问更流畅。
- 样式支持按需加载。可参考 antd-init 的模版代码, 需要配合 babel-plugin-antd 插件和
style
配置进行使用。#900 - 提供独立的构建文件。文档
- 新增卡片组件 Card。
- 新增评分组件 Rate。
- 新增 LocaleProvider 组件,提供组件文案的国际化支持,并新增了英语和俄语的语言配置。#1411
- 更好的服务端渲染支持,修复了 Badge、Spin、Calendar、Upload 等组件服务端渲染的问题。
- 新增 antd.d.ts 以更好的支持 TypeScript。@bang88
- 布局组件支持响应式布局和栅格间隔设置。#1082
- Table 支持固定列和横向滚动。#1265
不兼容改动
此版本有部分不兼容的改动,升级时确保修改相应的使用代码。
-
推荐使用样式按需加载。如果依然需要整体载入样式,样式入口文件已变为
antd/dist/antd.css
和antd/dist/antd.less
。如果你在项目中覆盖了 less 变量,less 文件的引用方式也有 相应变更。- import 'antd/lib/index.css'; // import 'antd/style/index.less'; + import 'antd/dist/antd.css'; // import 'antd/dist/antd.less';
-
完全移除了
0.12
中废弃的 Validation 组件,可以直接 import rc-form-validation 用以代替。#1096 -
Breadcrumb.Item 的
href
属性被移除,请直接用a
标签包裹可点击的内容。 -
Modal 移除了
align
属性,现在可以使用style
属性调整位置。 -
Modal.confirm
等方法的配置项iconClassName
重命名为iconType
。 -
Select 移除了
onChange
中的label
参数,新增了labelInValue
属性。#1695 -
移除了
import { Form } from 'antd/lib/form';
的用法,应统一为import { Form } from 'antd';
或import Form from 'antd/lib/form';
。
有兼容提示的改动
这里的改动在升级后控制台会出现警告提示,请按提示进行修改。
- 废弃 QueueAnim,可以直接 import rc-queue-anim 用以代替。Ant Design 的动效方案已移至 Ant Motion,欢迎前往探索。
- Affix 的
offset
属性重命名为offsetTop
。 - Popover 的
overlay
属性重命名为content
。 - Progress.Line 使用方式改为
<Progress />
或<Progress type="line" />
。 - Progress.Circle 使用方式改为
<Progress type="circle" />
。 - Spin 的
spining
属性更正为spinning
。 - Alert 的 type
warn
重命名为warning
。#1225 - Tree 的
onExpand
参数从function(node, expanded, expandedKeys)
调整为function(expandedKeys, {expanded, node})
。
Bug 修复
- 修复 Table 的
size
为middle
时,分页器大小无法控制的问题。#1396 - 修复 Table 的
pagination.defaultCurrent
失效的问题。 - 修复 Cascader 的
defaultValue
没有被value
覆盖的问题。 - 修复 Select 同时设置
allowClear
disabled
时还是会出现清除按钮的问题。#1480 - 修复 Transfer 的
DataSource
变化时已选中项没有同步的问题。#1587 - 修复 DatePicker 日期格式与国际化配置不同步的问题。#1509
- 修复 Button 禁用时事件仍然会冒泡的问题。#1541
- 修复 Carousel 自动播放时的卡顿和报错问题。#1397
- 修复 Tabs 的 card 类型内嵌标准 Tabs 时的样式问题。#1617
- 修复 Menu
horizontal
和vertical
模式不支持受控openKeys
的问题。
其他改进
- 样式变量梳理,去除了部分无用的变量,另外还有大量样式细节问题修复。
- 依赖的 normalize.css 升级到 4.x。
- 使用 ES2016 classes 重构了代码。@waywardmonkeys
- Popover、Popconfirm 和 Tooltip 组件根据不同的弹出位置有了更精准方向的弹出动画。
- 补充 Select TreeSelect Switch Radio Checkbox 等组件的
focus
表现,增强表单组件的可用性。#1358 - message 和 notification 现在可以全局配置
duration
。#1143 - DatePicker 和 TimePicker 的
onChange(date, dateString)
方法增加第二个参数用于获得格式化后的日期字符串。#1104 - DatePicker 和 DatePicker.RangePicker 现在可以设置内部 TimePikcer 的属性。#1415
- Checkbox
- Breadcrumb
- Modal
- 新增
Modal.warning
方法。 - 弹出时背景不再跟随滚动。#1195
- 新增
- Select
- 搜索框和单选选择框合并,以优化视觉和交互效果。
- 优化多选框的选中效果。
- Spin
- Steps
- Timeline
- 新增
dot
属性,可自定义时间轴点。 - 现在可以设置
className
和style
的问题。 color
属性现在支持自定义色值。
- 新增
- Tree
- 当子节点被选中时,自动展开父节点。
- 新增
checkStrictly
属性,支持父子节点选中关系脱离。
- Upload
- 在上传文件列表中的文件被删除时,将触发
onRemove
事件。#1240 - 增加
onPreview
支持文件的自定义预览方式。#1240 data
属性支持设为一个函数,用于动态修改上传参数。react-component/upload#32
- 在上传文件列表中的文件被删除时,将触发
- Slider
marks
现在支持 JSX 并可以单独设置某个标记的样式。 - Tag 的
onClose
可以使用e.preventDefault()
阻止默认事件。#1267 - Form.Item 在有多个 child 时也可以自动生成错误信息与校验状态,但一个 Form.Item 内仍然只能有一个表单控件。#1287
- Input 新增
onPressEnter
属性监听回车事件。 - Table 现在可以通过
filteredValue
sortOrder
控制筛选和排序的状态。#971 - Button 增加了
icon
属性。#1199 - SubMenu 增加
onTitleClick
属性。 - Affix 增加
offsetBottm
属性,支持固定在底部。#1000
相关工具发布
- antd-init 同步发布
1.0.0
版本,享受最新 ant-tool 工具带来的流畅开发体验。 - Ant Motion 全新的动效设计解决方案。
- Ant UX 发布 1.0 版本,提供多种平台的流程素材支持。
0.12.17
去 GitHub 查看 0.12.x
及之前的更新日志。