143 KiB
		
	
	
	
	
	
	
	
			
		
		
	
	更新日志
提示
当前文档为 Vant 2 的更新日志,如需查询 Vant 3 的更新内容,请访问 Vant 3 更新日志。
介绍
Vant 遵循 Semver 语义化版本规范。
发布节奏
- 修订号:每周发布,包含新特性和问题修复。
 - 次版本号:每隔一至二个月发布,包含新特性和较大的功能更新,向下兼容。
 - 主版本号:无固定发布时间,包含不兼容更新。
 
更新内容
v2.12.39
2022-01-15
Bug Fixes
- DatetimePicker: 修复边界情况下可能报错的问题 #10186
 - ImagePreview: 修复快速缩放导致预览关闭的问题 #10191
 - NavBar: 修复在 safari 上占位元素高度错误的问题 #10190
 - Tabbar: 修复在 safari 上占位元素高度错误的问题 #10185
 
v2.12.38
2022-01-10
Feature
- Slider: 新增 left-button、right-button 插槽 #10053
 
Bug Fixes
- PullRefresh: 修复在个别浏览器上会触发原生回弹效果的问题 #10090
 
v2.12.37
2021-12-14
Feature
- ImagePreview: 新增 overlayStyle 选项 #10043
 
Bug Fixes
- DatetimePicker: 修复调用 Picker 实例方法后日期未正确更新的问题 #10028
 
v2.12.36
2021-12-05
Bug Fixes
v2.12.35
2021-11-27
Bug Fixes
v2.12.34
2021-11-24
Feature
Bug Fixes
- Swipe: 修复开始滑动时未阻止 touchmove 事件行为的问题 #9918
 
v2.12.33
2021-11-16
Bug Fixes
- Picker: 修复 SSR 报错的问题 #9875
 
v2.12.32
2021-11-15
Feature
Bug Fixes
- Field: 修复点击 readonly 的输入框后会触发表单验证的问题 #9863
 - Switch: 修复全局设置 font-size 时样式错误的问题 #9841
 - Tabbar: 修复 before-change 属性在路由模式下不生效的问题 #9855
 
v2.12.31
2021-10-30
Bug Fixes
- Field: 修复 textarea 在聚焦和失焦时未重新计算高度的问题 #9718
 - Progress: 修复窗口高度变化时进度条长度错误的问题 #9757
 - 修复 VueConstructor 类型定义冲突的问题 #9750
 
v2.12.30
2021-10-14
Feature
- Sku: 支持在留言下方定义描述文案 #9651
 
v2.12.29
2021-09-22
Bug Fixes
- Tabs: 修复多个 Tabs 组件同时存在时动画失效的问题 #9542
 
v2.12.28
2021-09-20
Feature
- Icons: 新增 shield-o、guide-o 图标 fc2406
 
Bug Fixes
- Radio: 修复 icon ref 可能为 undefined 导致报错的问题 #9504
 
v2.12.27
2021-09-06
Feature
- Sku: 新增 custom-upload 配置项 #9389
 
Bug Fixes
v2.12.26
2021-08-15
Feature
Bug Fixes
- Field: 修复 Textarea 内容较多时,输入会导致页面滚动到顶部的问题 #9207
 - Rate: 修复星星较多时无法自动换行的问题 #9193
 - Tabs: 修复 card 类型内边距错误的问题 #9169
 
v2.12.25
2021-07-25
Feature
v2.12.24
2021-07-13
Bug Fixes
v2.12.23
2021-07-06
Bug Fixes
- DatetimePicker: 修复设置 max-date、max-hour 等属性时可能导致当前日期不正确的问题 #8977
 - Stepper: 修复开启 async-change 且 blur 后输入值不正确的问题 #8936
 - Toast: 修复长单词换行问题 #8966
 
v2.12.22
2021-06-22
Feature
- Calendar: 新增 top-info、bottom-info 插槽 #8847
 
Bug Fixes
- Slider: 修复设置 step 属性时,输入值格式化错误的问题 #8894
 
v2.12.21
2021-06-03
Feature
- Button: 新增 icon 插槽 #8784
 - CouponList: 新增 list-footer、disabled-list-footer 插槽 #8797
 - Locale: 新增 French 法语语言包 #8795
 
Bug Fixes
- CellGroup: 修复在 
v-for循环内使用时渲染异常的问题 #8787 - Collapse: 修复在 safari 上可能出现渲染异常的问题 #8788
 - List: 移除无效的 @list-icon-margin-right 变量 #8758
 - NoticeBar: 修复在 Popup 内嵌套使用时无法正常播放的问题 #8791
 - Tabs: 修复在 Popup 内嵌套使用时底部条位置错误的问题 #8792
 
v2.12.20
2021-05-23
Feature
- Uploader: max-size 属性支持函数格式 #8745
 
Bug Fixes
v2.12.19
2021-05-17
Feature
v2.12.18
2021-05-10
Bug Fixes
- CouponList: 修复时间为字符串格式时展示错误的问题 c5b4d1
 
v2.12.17
2021-05-08
Feature
- CouponList: 支持通过 customValidPeriod 字段自定义有效期 #8679
 
v2.12.16
2021-05-03
Feature
- Steps: 新增 icon-prefix 属性 #8630
 
Bug Fixes
- DatetimePicker: 修复动态设置 mindate 或 maxdate 时可能导致日期错误的问题 #8640
 
v2.12.15
2021-04-25
Bug Fixes
- Calendar: 修正繁体中文语言包 #8569
 - Tag: 修复使用 plain 和 color 属性时边框颜色不正确的问题 #8602
 - Uploader: 修复使用插槽时 scoped 样式不生效的问题 #8613
 
v2.12.14
2021-04-18
Feature
Bug Fixes
v2.12.13
2021-04-11
Feature
- Sticky: 新增 change 事件 #8479
 
v2.12.12
2021-04-05
Bug Fixes
- 修复 Webstorm 下组件标签提示不正确的问题 #8450
 
v2.12.11
2021-03-30
Bug Fixes
v2.12.10
2021-03-19
Bug Fixes
v2.12.9
2021-03-09
Feature
- AddressList: 新增 tag 插槽 #8311
 
v2.12.8
2021-03-07
Feature
- ImagePreview: 新增 transition 属性 #8273
 - PullRefresh: 新增 pull-distance 属性 #8279
 - Locale: 新增 th-TH 泰语 #8247
 
Bug Fixes
- ActionSheet: 修复返回页面时可能错误地重新打开的问题 #8271
 - ImagePreview: 修复第一次打开时动画缺失的问题 #8274
 - Stepper: 修复在 iOS14 下禁用时输入框文字不可见的问题 #8278
 
v2.12.7
2021-02-28
Feature
Bug Fixes
- DatetimePicker: 修复 v-model 为 null 时初始值不正确的问题 #7832
 - Empty: 修复 linearGradient id 可能导致冲突的问题 #8011
 - GoodsActionIcon: 修复控制台存在 info 属性 warning 的问题 #8040
 - Tabs: 修复 v-model 值为 0 时激活标签可能不正确的问题 #8087
 
v2.12.6
2021-01-26
Feature
- Icons: 新增 wechat 图标, 重命名原 wechat 图标为 wechat-pay b3cd8c
 
Bug Fixes
- 修复部分地区无法访问 CDN 静态资源的问题 #8000
 
perf
- Sku: 优化图标加载性能 #7992
 
v2.12.5
2021-01-24
Feature
- Calendar: reset 方法支持重置到指定日期 #7943
 - ImagePreview: 在调用 swipeTo 方法后自动重置缩放状态 #7974
 - ImagePreview: swipe-duration 属性的默认值调整为 300ms #7973
 - ShareSheet: 新增 wechat-moments 朋友圈图标 4f94dd
 
style
- ShareSheet: 更新 qrcode 图标 335510
 
v2.12.4
2021-01-17
Feature
Bug Fixes
v2.12.3
2021-01-09
Bug Fixes
- Col: 适配 less 4.0 d8a81b
 
v2.12.2
2021-01-02
Feature
- Calendar: 新增 scrollToDate 方法 #7847
 - Form: 新增 disabled 属性 #7829
 - Form: 新增 readonly 属性 #7829
 - Loading: 新增 text-color 属性 #7846
 - IndexBar: 新增 scrollTo 方法 #7845
 - NumberKeyboard: 新增 random-key-order 属性 #7841
 
v2.12.1
2020-12-26
Feature
- Form: valdiate 方法支持校验多个表单项 #7810
 - Form: resetValidation 方法支持重置多个表单项 #7811
 - Stepper: 新增 show-input 属性,用于控制是否显示输入框 #7812
 
Bug Fixes
- CountDown: 修复 SSR 过程中内存泄露的问题 #7808
 - Image: 修复 SSR 时提示 DOM 不匹配的问题 #7822
 - Stepper: 修复 change 事件重复触发的问题 #7820
 - Swipe: 修复 SSR 样式不正确的问题 #7821
 
v2.12.0
2020-12-23
New Component
- 新增 Cascader 级联选择组件 #7771
 
Feature
- uploader: 支持在 fileList 的选项中单独配置 
imageFitdeletablepreviewSizebeforeDelete字段 #7776 
Bug Fixes
- Tab: 修复动态修改标题后标签栏的滚动位置不正确的问题 c919e9
 
v2.11.3
2020-12-18
Feature
v2.11.2
2020-12-10
style
- Circle: 新增 @circle-color Less 变量 1a6cf6
 - Circle: 新增 @circle-layer-color Less 变量 65a5ed
 - Circle: 新增 @circle-size Less 变量 b57f7e
 - IndexBar: 默认高亮颜色调整为红色 65b680 87b0a0
 - IndexBar: 右边距调整为 8px aad055
 
Bug Fixes
v2.11.1
2020-11-26
Feature
- CheckboxGroup: toggleAll 方法新增 skipDisabled 选项,用于跳过禁用的复选框 #7644
 - DatetimePicker: 支持 Picker 的所有插槽 #7645
 - Popover: 新增 trigger 属性,用于控制弹出层的触发时机 #7646
 - Popover: 优化无障碍访问 #7624
 - ShareSheet: 新增小程序码图标 #7635
 
style
Bug Fixes
v2.11.0
2020-11-22
New Component
- 新增 Badge 徽标组件 #7602
 - 新增 Popover 气泡弹出框组件 #7579
 
Feature
- Popup: 新增 click-close-icon 事件 #7599
 
Bug Fixes
- ActionSheet: 修复在 iOS 10 以下版本时选项高度不正确的问题 #7578
 
v2.10.14
2020-11-15
Feature
- ImagePreview: index 插槽新增 index 参数 #7552
 - Popup: 新增 transition-appear 属性 #7525
 - Skeleton: 新增 @skeleton-avatar-size less 变量 #7556
 - Skeleton: 新增 @skeleton-title-width less 变量 #7557
 
Bug Fixes
- Calendar: 修复 month-show 事件触发时机不正确的问题 #7565
 - Calendar: 修复初始化时 lazy-render 不生效的问题 #7564
 - IndexBar: 修复在 Popup 内使用时锚点无法吸顶的问题 #7559
 - NavBar: 修复 safe-area-inset-top 属性未能正确生效的问题 #7534
 - Skeleton: 修复 avatar-size 属性传入 number 类型时报错的问题 #7555
 - Sticky: 修复某些情况下无法正确吸顶的问题 #7561
 - Swipe: 修复宽度为小数时漏边的问题 #7562
 
v2.10.13
2020-11-08
Feature
- Icon: 现在会默认使用 base64 图标,而不是有赞 CDN 上的 iconfont e0ad65
 - NavBar: 新增 safe-area-inset-top 属性,用于开启 iOS 顶部安全区适配 be25a4
 - Sticky: offset-top 属性支持使用 vh 单位 #7498
 
Bug Fixes
- NavBar: 修复按钮文字不居中的问题 #7515
 - NoticeBar: 修复在 iOS14 上无法重复播放的问题 #7516
 - Picker: 修复级联模式下选项禁用时二级选项错误的问题 #7499
 - Picker: 修复禁用所有选项时默认展示的选项不为第一项的问题 #7504
 - Swipe: 修复开启 lazy-render 且 loop 为 false 时渲染节点不正确的问题 #7465
 - Swipe: 修复开启 lazy-render 时子节点被重复挂载的问题 #7466
 - Switch: 修复按钮 z-index 层级过高的问题 #7497
 - Toast: 修复 onClose 选项可以被重复触发的问题 #7496
 
v2.10.12
2020-10-31
Feature
style
- ActionSheet: 当选项较多时,取消按钮现在会固定在底部 #7401
 - Popup: 圆角弹窗的圆角大小从 20px 调整为 16px #7421
 - Sidebar: 修复文本为长数字时无法自动换行的问题 #7456
 
Bug Fixes
- GridItem: 修复使用 badge 属性时会在控制台抛出 warning 的问题 #7433
 - Picker: 修复在 safari 上动画弹出过程中遮罩层闪烁的问题 #7460
 - Tabs: 修复在个别情况下错误地抛出 change 事件的问题 #7461
 - Tabs: 修复动态插入时 active 值可能错误的问题 #7445
 
v2.10.11
2020-10-24
Feature
- Empty: 新增 image-size 属性,用于设置图片大小 #7389
 - Picker: 新增 option 插槽,用于自定义选项 #7380
 - Picker: 新增 cancel 插槽,用于自定义取消按钮 #7377
 - Picker: 新增 confirm 插槽,用于自定义确定按钮 #7377
 
Bug Fixes
- Dialog: 修复将 closeOnPopstate 设置为 false 时不生效的问题 #7357
 - NavBar: 修复左右文字为空时会渲染空节点的问题 #7376
 - Image: 修复 SSR 时会渲染加载中节点的问题 #7383
 - Revert "Field: 占位文字的颜色调整为 gray-6" #7192 #7375
 
v2.10.10
2020-10-18
Feature
Improvement
- 增加 info 属性的废弃提示 #7352 #7347
 - SwitchCell: 增加组件废弃提示 #7350
 - Toast: 新增 mask 选项的废弃提示 #7342
 - TreeSelect: 增加 navclick 和 itemclick 事件的废弃提示 #7351
 
Bug Fixes
- Calendar: 修复在大屏幕上日期展示不全的问题 #7355
 - Tabs: 修复部分标签页内容为空且开启 animated 时展示错误的问题 #7354
 - Field: 修复 label-align 为 right 时 label 只能展示五个字的问题 #7349
 - GridItem: 修复文字未正确换行的问题 #7292
 - Icon: 修复 after-sale 和 cash-back-record 图标在真机上不完整的问题 #7328
 - Picker: 修复加载图标的 z-index 错误的问题 14cd28
 - Row: 修复开启 flex 模式时未能正确换行的问题 #7332
 
v2.10.9
2020-10-01
Feature
- Locale: 新增德语语言包 #7245
 - CollapseItem: 新增 toggle 方法,用于主动控制面板展开或收起 #7281
 - Pagination: 新增 page、prev-text、next-text 插槽 #7222
 - Tab: 当标签页内容为空时,不再渲染空的 
van-tab-pane节点 #7238 
Bug Fixes
- Swipe: 修复 prev、next 方法缺少类型定义的问题 #7270
 - Button: 修复在 v-for 中渲染时 ref 不正确的问题 #7237
 - Field: 修复设置 maxlength 后在中间输入时截断结果不正确的问题 #7284
 - @vant/markdown-vetur: 修复 Windows 系统下的兼容问题 #7277 #7287
 
v2.10.8
2020-09-21
Feature
- SidebarItem: 新增 title 插槽 #7220
 
Bug Fixes
- Calendar: 修复月份标题展示错误的问题 #7205
 - CouponCell: 修复金额为 0 时取值逻辑错误的问题 #7196
 - Field: 修复在 iOS 14 上禁用时文字颜色过浅的问题 #7206
 - List: 修复个别情况下第一个子元素的 scoped 样式不生效的问题 #7202
 - Swipe: 修复宽度为小数时无法禁用循环滚动的问题 #7208
 - Swipe: 修复指示器切换时渐变动画闪烁的问题 #7207
 
v2.10.7
2020-09-17
Feature
Style
- Dialog: 优化无标题弹窗的最小高度 #7191
 - Field: 占位文字的颜色调整为 gray-6 #7192
 - TabbarItem: 新增 @tabbar-item-active-background-color less 变量 #7162
 
Bug Fixes
- Calendar: 修复使用 rem 布局时内容跳动的问题 #7190
 - ImagePreview: 修复在个别场景下图片滑动范围错误的问题 #7142
 - NoticeBar: 修复在 safari 浏览器上返回时无法滚动的问题 #7167
 - NumberKeyboard: 修复 extra-key 包含多个字符时被截断的问题 #7150
 - NumberKeyboard: 修复 extra-key 插槽内无法触发 click 事件的问题 #7193
 - Tabs: 修复 offset-top 属性包含单位时切换标签后滚动位置错误的问题 #7143
 - Tag: 修复标签文字在小米手机上不居中的问题 #7151
 
v2.10.6
2020-09-08
Bug Fixes
- Calendar: 修复 readonly 属性在多选模式下无效的问题 #7127
 - CouponCell: 修复金额取值逻辑错误的问题 #7123
 - List: 修复第一个子元素的 scoped 样式无效的问题 #7128
 
v2.10.5
2020-09-06
Feature
- ActionSheet: 新增 closeable 属性 #7099
 - Area: 新增 readonly 属性 #7106
 - Calendar: 新增 readonly 属性 #7115
 - Calendar: 支持将默认选中的日期设置为空 #7116
 - DatetimePicker: 新增 readonly 属性 #7107
 - Picker: 新增 readonly 属性 #7105
 
Bug Fixes
- Field: 修复 digit 类型可以输入负号的问题 #7114
 - Form: 修复 name 重复时 scrollToError 位置错误的问题 #7102
 - Form: 修复个别情况下校验状态错误的问题 #7103
 - Toast: 修复重复调用时无法清除的问题 #7100
 
v2.10.4
2020-09-03
Feature
- 设计资源:新增 Axure 元件库,感谢 @axure-tczy 同学提供资源
 - ActionSheet: 新增 description 插槽 #7068
 - Icon: 新增 share-o 图标 ea6324
 - Tabbar: 新增 before-change 属性 #7081
 
Bug Fixes
- Calendar: 修复 row-height 对选中的日期不生效的问题 #7046
 - Field: 修复表单项的值为 0 会导致 required 校验不通过的问题 #7050
 - Icon: 修复 calendar-o 图标名称拼写错误 #7080
 
v2.10.3
2020-08-25
Feature
- Uploader: 新增 preview-cover 插槽的 index 参数 #7036
 
Style
Bug Fixes
v2.10.2
2020-08-12
Feature
- Tab: 新增 @tab-line-height less 变量 #6985
 
Bug Fixes
- Sku: 适配 sku.list 为空导致报错的问题 #6991
 
v2.10.1
2020-08-10
Feature
Style
Bug Fixes
- AddressEdit: 修复在 safari 上左侧文字换行的问题 #6969
 - ContactEdit: 修复在 safari 上左侧文字换行的问题 #6969
 - Icon: 修复徽标数字不居中的问题 #6975 #6952
 
v2.10.0
2020-08-07
Feature
- AddressEdit: 新增 tel-maxlength 属性 #6869
 - Calendar: 默认开启 close-on-popstate 属性 #6874
 - Dialog: 默认开启 close-on-popstate 属性 #6873
 - Dialog: 新增 theme 属性,用于展示圆角按钮风格的弹窗 #6921
 - DropdownMenu: 新增 @dropdown-menu-box-shadow 变量 6d0c54
 - Icon: 新增 back-top 图标 #6931
 - Icon: 新增 photo-fail 图标 #6883
 - ImagePreview: 默认开启 close-on-popstate 属性 #6875
 - NumberKeyboard: 新增 get-container 属性 #6870
 
Style
- 新增 line-height 相关 LESS 变量 #6862
 - ActionSheet: 加载图标大小调整为 22px #6847
 - ActionSheet: 取消按钮文字颜色调整为 @gray-7 #6846
 - ActionSheet: 标题栏高度调整为 48px #6856
 - Cell: 图标与文字的间距调整为 4px #6844
 - CouponCell: 优化金额与符号的间隔 #6888
 - Dialog: 确认按钮的默认颜色调整为红色 #6921
 - DropdownMenu: 默认选中态颜色调整为红色 #6863
 - Field: 图标与文字的间距调整为 4px #6849
 - Image: 更新加载图标和错误图标 #6890
 - NumberKeyboard: 增加底部空白区域 #6938
 - NumberKeyboard: 调整按键高度为 28px #6899
 - NumberKeyboard: 标题栏高度调整为 40px #6845
 - Picker: 默认可见的选项个数调整为 6 个 #6827
 - Sidebar: 宽度调整为 80px #6861
 - Sku: 优化价格符号位置,与下方文案对齐 #6911
 - Tag: 更新文字大小和标签大小 #6828
 - Tab: 在横向滚动模式下默认不截断标题的文字 bc0e45
 - Tab: 移除默认边框 69ac60
 - Tab: 优化标签间距 90e678 8027f4
 - Toast: 更新背景色 #6848
 - Toast: 图标大小调整为 36px #6857
 
Bug Fixes
- AddressEdit: 修复个别情况下按钮渲染错误的问题 #6942
 - Calendar: 修复初始化日历时页面滚动条位置错误的问题 #6926
 - Field: 修复 rule 的 message 为空时无法重置表单状态的问题 #6867
 - Icon: 修复图片图标加载过程中高度异常的问题 #6858
 - ImagePreview: 修复 iOS 下旋转屏幕时布局错误的问题 #6825
 - Info: 修复 badge 的数字在 iOS 上不居中的问题 #6952
 - NumberKeyboard: 修复在低版本 safari 上按键高度错误的问题 #6937
 - Picker: 修复 defaultIndex 在个别情况下取值逻辑错误的问题 #6948
 - Sku: 修复价格较长时顶部图片的宽度被压缩的问题 #6949
 
v2.9.4
2020-07-29
Feature
Bug Fixes
v2.9.3
2020-07-19
Feature
- Tabs: 新增 before-change 属性,用于在切换标签前执行校验逻辑 #6817
 - Sticky: offset-top 属性支持传入 vw 单位 #6816
 - Picker: item-height 属性支持传入 vw 单位 #6816
 - Sku: 新增对手机号留言的格式化处理 19e0d0
 - Tab: 新增 scrollTo 方法,用于在滚动导航模式下滚动到特定位置 #6800
 - Uploader: 新增 preview-options 属性,用于自定义全屏图片预览的配置项 #6810
 
Bug Fixes
- Calendar: 修复在个别情况下内容渲染失败的问题 #6812
 - ImagePreview: 修复在个别情况下图片错位的问题 #6811
 - NumberKeyboard: 修复在旧版本 iOS 上按键内容不居中的问题 #6804
 - Slider: 修复垂直模式下滑动动画失效的问题 #6786
 
v2.9.2
2020-07-14
Feature
Bug Fixes
- Tab: 修复标签禁用时仍会触发路由跳转的问题 #6782
 - Sku: 修复留言区域 label 颜色不一致的问题 #6771
 - Sku: 修复留言区域 label 里包含较长的单词时未自动换行的问题 #6777
 
v2.9.1
2020-07-12
Feature
- DatetimePicker: 新增 datehour 类型,用于选择年月日和小时 #6732
 - Field: 新增 clear-trigger 属性,用于控制清除按钮展示时机 #6699
 - Search: 新增 clear-trigger 属性,用于控制清除按钮展示时机 #6700
 - Uploader: 新增 preview-cover 插槽,用于自定义覆盖在预览区域上方的内容 #6707
 - ShareSheet: 新增 click-overlay 事件,在点击遮罩层时触发 #6765
 - Stepper: 新增 allow-empty 属性,用于控制是否允许输入空值 #6759
 - Steps: 新增 inactive-color 属性,用于设置未激活状态颜色 #6758
 - SubmitBar: 新增 button-color 属性,用于设置按钮颜色 #6757
 - Sku: 优化留言栏时间选择交互 8d29e5 7343e5
 
Style
Bug Fixes
- Calendar: 修复个别情况下日历标题不更新的问题 #6723
 - Checkbox: 修复动态设置 bind-group 时不生效的问题 #6730
 - Field: 修复在 iOS 下 label 文字超过 5 个时会换行的问题 #6743
 - Image: 修复 SSR 时 LazyLoad 属性存在内存泄露的问题 #6721
 - ImagePreview: 修复屏幕大小变化时图片宽高比展示错误的问题 #6760
 - ImagePreview: 修复 swipeTo 方法类型定义错误 #6727
 - Picker: 修复惯性滚动过程中点击选项会导致选中结果错误的问题 #6724
 - Popup: 修复 lock-scroll 在个别场景下不生效的问题 #6698
 
v2.9.0
2020-07-03
Feature
- Sku: 新增大图预览模式,可以通过 largeImageMode 选项开启 #6598
 - Sku: 新增 lazy-load 属性,用于控制是否开启大图懒加载 #6598
 - Sku: 新增 show-header-image 属性,用于控制是否显示头部图片 #6598
 - Sku: 默认开启 close-on-click-overlay 属性 #6631
 - Icon: 新增 enlarge 扩大图标 1c97b1
 - Image: 新增 default 默认插槽 #6613
 - ImagePreview: 新增 swipeTo 方法 #6596
 - ImagePreview: 新增 get-container 属性 39b5be
 - NoticeBar: 优化重新开始滚动的间隔 022196
 - TreeSelect: 新增 selected-icon 属性 #6615
 
Style
- Button: 调整 small 和 mini 按钮的样式,移除最小宽度限制 #6371
 - Cell: 内侧边框增加 16px 的右边距 #6686
 - ActionSheet: 顶部描述文字的颜色调整为 gray-6 #6586
 - AddressEdit: 省市区弹窗调整为圆角样式 #6584
 - AddressEdit: 表单文本宽度调整为 4em #6591
 - ContactEdit: 表单文本宽度调整为 4em a77ebe
 - Field: 左侧文本颜色调整为 gray-7 #6581
 - Field: 左侧文本宽度调整为 6em #6589 #6583
 - ImagePreview: 调整页码位置,与关闭图标对齐 #6650
 - Picker: 优化选项禁用时的光标效果 #6579
 - Rate: 默认图标颜色由黄色调整为红色 #6373
 - Uploader: 更新上传失败提示图标 #6653
 
Bug Fixes
- Field: 修复左侧文本中较长的英文单词无法换行的问题 #6590
 - ImagePreview: 修复在 safari 浏览器上长按图标时缩放效果异常的问题 #6660
 - ImagePreview: 修复图片缩放时可能出现位置错误的问题 #6656
 - NumberKeyboard: 修复在 iOS 系统下存在点击延迟的问题 #6667
 - Picker: 修复在级联模式下无法禁用选项的问题 #6580
 - Picker: 修复开启 rem 转换时可能出现选项偏移的问题 #6663
 - Stepper: 修复个别情况下按钮禁用状态计算错误的问题 #6652
 
v2.8.7
2020-06-19
Feature
- Dialog: 新增 allow-html 属性,用于控制是否允许渲染 HTML 内容 #6568
 - Field: 新增 format-trigger 属性,用于控制 formatter 触发时机 #6566
 - Form: 允许在 rules 中不传入 message 字段 #6536
 - Sticky: 支持 offset-top 属性传入 rem 单位 #6556
 
Style
Bug Fixes
v2.8.6
2020-06-13
Feature
Style
- Field: 更新禁用状态下的文本颜色 #6534
 
Bug Fixes
- Calendar: 修复范围选择时无法快捷选择同一天的问题 #6504
 - CollapseItem: 修复无法通过 border 属性隐藏内边框的问题 #6533
 - Field: 修复 v-model 绑定值变化时 formatter 函数没生效的问题 #6490
 - ImagePreview: 修复在 iOS 上放大后图片变模糊的问题 #6496
 - Picker: 修复级联选择时 defaultIndex 在个别情况下取值错误的问题 #6473
 - Tabbar: 修复使用 vue-router 3.3 以上版本时出现重复路由提示的问题 #6474
 
v2.8.5
2020-06-04
Feature
- Notify: 支持组件调用 #6453
 - Skeleton: 新增 round 属性,用于展示圆角风格 #6441
 - ShareSheet: 支持在 option 中配置 description 属性 #6460
 - DropdownItem: 新增 lazy-render 属性,由于控制是否开启延迟渲染 #6454
 
Bug Fixes
- Popup: 修复重复弹出时遮罩层 z-index 未正确更新的问题 #6429
 - Button: 修复设置 loading 时无法与其他按钮垂直对齐的问题 #6413 #6414
 - NoticeBar: 修复在 keep-alive 内重新渲染时无法正确滚动的问题 d21420
 - Field: 修复 value 为 null 且开启 show-word-limit 时出现报错的问题 #6419
 
v2.8.4
2020-05-28
Feature
- AddressList: 增加底部安全区适配 #6355
 - DatetimePicker: 新增 month-day 类型,用于选择月份和日期 #6395
 - Popup: 现在每个弹层会单独创建一个遮罩层,而不是共用一个遮罩层 #6357
 
Style
- ActionSheet: subname 的颜色调整为 gray-6 e54c11
 - ActionSheet: 移除选项之间的分隔线 8db218
 - Cell: 降低边框选择器的 CSS 优先级,便于覆盖样式 #6359
 - Collapse: 调整边框与左右两侧的边距 #6361
 - Collapse: 内容的字号增大为 14px #6358
 
Bug Fixes
- Area: 修复区列表为空时未默认选中第一个城市的问题 #6356
 - Field: 修复设置 error 为 false 无法禁用错误提示颜色的问题 #6382
 - GoodsAction: 修复只有一个按钮时圆角大小错误的问题 #6347
 - Sidebar: 修复 v-model 绑定的值变化时不会触发 change 事件的问题 #6383
 
v2.8.3
2020-05-21
Feature
- Form: 新增 submit-on-enter 属性,用于控制回车时是否提交表单 #6336
 - Form: 优化 scrollToField 方法,支持通过传参来控制滚动位置 #6335
 - Field: 调整 placeholder 的色值为 @gray-5 #6304
 - Field: 使用 digit 类型时,只能在第一位输入减号 #6303
 - Picker: 优化 methods 的类型定义,支持泛型 #6315
 
Bug Fixes
v2.8.2
2020-05-17
Feature
- Field: 新增 extra 插槽 #6290
 - Grid: 新增 direction 属性 #6256
 - Calendar: 新增 month-show 事件 #6292
 - NumberKeyboard: 支持定义两个 extra-key #6276
 - Stepper: 新增 theme 属性,用于展示圆角风格步进器 #6282
 
Style
- Rate: 更新禁用状态下的图标颜色 #6253
 - Sku: 优化内部分割线的布局 #6272
 - Sku: 价格符号由居中对齐调整为底对齐 #6274
 - NoticeBar: 图标宽度由 22px 调整为 24px #6280
 
Bug Fixes
- Field: 修复 textarea 无法通过回车换行的问题 #6263
 - NoticeBar: 修复 replay 事件只能触发一次的问题,内部动画机制由 animation 调整为 transition #6293
 
v2.8.1
2020-05-09
Feature
- Calendar: 新增 lazy-render 属性,用于控制是否开启延迟渲染 #6245
 - Field: 新增 click-input 事件,在点击输入框时触发 #6239
 - Sku: 新增 sku-reset 事件,在规格重置时触发 #6220
 - GoodsActionButton: 适配系统字体放大 b1dcf3
 
Bug Fixes
- Button: 修复文字在部分机型上不居中的问题 8c53db
 - Field: 修复回车键会触发表单提交的问题 #6240
 - Step: 修复 active-color 属性对小圆点颜色不生效的问题 #6229
 - Stepper: 修复输入负数时格式化错误的问题 #6238
 - Stepper: 修复个别情况下会展示 NaN 的问题 7327a4
 - Stepper: 修复设置 disable-input 属性后在部分浏览器上仍会触发 focus 事件的问题 c6024b
 
v2.8.0
2020-05-05
适配系统字体放大
部分手机用户会使用系统或微信提供的字体放大功能,开启该功能后,组件的 font-size 和 line-height 会等比例放大,导致部分组件出现样式偏移的问题,在 2.8.0 版本中,我们针对这个场景进行了适配,使得所有组件在字体缩放后仍保持正确的布局,改动涉及以下组件:
- ActionSheet #6175
 - Checkbox #6168
 - NavBar 7effb7
 - NoticeBar #6177
 - NumberKeyboard #6179
 - Pagination #6178
 - PasswordInput #6176
 - Picker #6174 #6205
 - Radio #6173
 - Tab #6209
 
Style
- Button: 使用 flex 进行内容居中,display 由 inline-block 调整为 inline-flex #6180
 - Picker: 优化顶部操作栏的样式,调整操作按钮颜色 #6214
 - CouponList: 新增 @coupon-list-close-button-height 样式变量 18a0c5
 
Feature
- Calendar: 新增 unselect 事件,在取消选中时触发 #6198
 - Calendar: 支持在多选模式下使用 max-range 属性 #6202
 - Field: 新增 colon 属性,用于配置是否显示冒号 #6195
 - Locale: 新增罗马尼亚语配置文件 #6193
 - ShareSheet: 优化无障碍访问 #6208
 
Bug Fixes
- Layout: 修复设置 gutter 属性后间距错误的问题 #6197 #6143
 - NoticeBar: 修复动态修改 scrollable 属性后未正确生效的问题 #6190
 - ShareSheet: 修复在部分浏览器上底部间距错误的问题 #6207
 - Tab: 修复文字截断时无法正确展示徽标的问题 #6209
 
v2.7.1
2020-04-28
Bug Fixes
- 修复 NavBar 图标不居中的问题 #6147
 
v2.7.0
2020-04-28
Style
- 新增全局默认字体 #6126
 - DropdownMenu: 增加阴影效果 7db744
 - Sidebar: 优化左侧选中条的样式 a31032
 - Toast: 圆角大小由 4px 调整为 8px 2364c4
 - TreeSelect: 选中态的图标从 checked 更换为 success 图标 5b72e4
 
Feature
- NoticeBar: 新增 start 方法 #6069
 - ImagePreview: 双击缩放的间隔从 300 毫秒调整为 250 毫秒 #6136
 - NumberKeyboard: 新增左下角默认的键盘图标,点击后收起键盘 #6152
 - NumberKeyboard: 新增 close-button-loading 属性,用于展示加载中状态 #6158
 - uploader: 多选时自动过滤超出大小限制的图片 #6150
 
Bug Fixes
- Layout: 修复设置 gutter 后元素宽度溢出屏幕的问题 #6143
 - Tab: 修复子组件顺序错误的问题 #6140
 - Uploader: 修复动态修改 file.message 未触发视图更新的问题 #6142
 - NavBar: 修复设置顶部内边距后两侧按钮定位错误的问题 #6147
 - types: 修复在 TSX 中使用组件时提示类型错误的问题 #6148
 
v2.6.3
2020-04-20
Bug Fixes
v2.6.2
2020-04-18
Feature
- Empty: 支持在离线环境下使用 network 图片 #6055
 - NoticeBar: 新增 replay 事件,在每次滚动结束时触发 #6079
 - Overlay: 新增 lock-scroll 属性,用于控制是否锁定背景滚动 #6082
 - Uploader: 新增 lazy-load 属性,用于开启图片懒加载 #6083
 
Bug Fixes
- Checkbox: 修复在 click 事件的回调中获取到的 value 未改变的问题 #6066
 - Picker: 修复级联模式下使用 setColumnValues 方法导致报错的问题 #6080
 - Slider: 修复在垂直模式下使用 bar-height 后样式错误的问题 #6065
 - Swipe: 修复元素隐藏且触发 resize 事件后渲染错误的问题 #6084
 
v2.6.1
2020-04-14
Feature
Bug Fixes
- Calendar: 修复 default-date 默认值为 min-date 而不是今天的问题 #6025 #6028
 - 修复部分组件在 SSR 时报错 
Cannot read property 'children' of null的问题 #6046 
v2.6.0
2020-04-09
Feature
Feature
- Form: 新增 show-error 属性,用于控制展示错误提示 #5941
 - Tabbar: 新增 placeholder 属性,用于在吸底时生成占位元素 #5979
 - Sku: 默认开启底部安全区适配 #5960
 - SubmitBar: 默认开启底部安全区适配 #5956
 - GoodsAction: 默认开启底部安全区适配 #5955
 - Tabbar: 固定在底部时默认开启底部安全区适配 #5968
 - Swipe: 允许一次滚动多页轮播 #5953
 - Calendar: 设置 max-range 后,选择超出范围时会自动选择到最大范围 #5992
 
Improvement
- NavBar: 优化点击反馈效果 #5949
 - Popup: 优化退场动画效果 #5954
 - Picker: 优化惯性滑动速率 #5951
 - Swipe: 优化滚动手势体验,滑动较慢时会回弹到原位置 #6003
 - TreeSelect: 更新左侧栏背景色,增强区分度 #5991
 
Bug Fixes
- Button: 修复 icon-prefix 属性不生效的问题 #5947
 - Calendar: 修复 keep-alive 时可能出现渲染空白的问题 #5978
 - Form: 修复动态插入 Field 时校验顺序错误的问题 b8dea3
 - NavBar: 修复图标在部分机型上不居中的问题 #5948
 - Stepper: 修复 disable-input 属性在低版本 safari 上不生效的问题 #5976
 
v2.5.9
2020-03-31
Feature
Bug Fixes
- NumberKeyboard: 修复 show-delete-key 属性不生效的问题 #5935
 - Toast: 修复在部分机型上高度错误的问题 #5931
 - Sticky: 修复 SSR 时访问 window 对象导致报错的问题 #5958
 
v2.5.8
2020-03-27
Feature
- 新增 Webstorm 的 web-types.json 定义文件,提供智能提示 #5900
 - Form: 新增 show-error-message 属性 #5927
 - ImagePreview: 开启延迟渲染,提高渲染性能 #5879
 - Swipe: 新增 lazy-render 属性 365f2b
 
Improvement
Bug Fixes
- Calendar: 修复 multiple 模式下 default-date 格式错误的问题 #5907
 - PullRefresh: 修复内部元素高度未填满容器的问题 #5878
 - Sticky: 修复切换显示状态时可能出现定位错误的问题 #5888
 - Swipe: 修复屏幕 resize 后可能导致轮播位置错误的问题 #5922
 
v2.5.7
2020-03-20
Bug Fixes
- Locale: 修复日语配置文件命名错误的问题 e8c88a
 
v2.5.6
2020-03-20
Feature
- Calendar: 新增 allow-same-day 属性 #5688
 - GoodsAction: 新增 badge 属性 0dea9e
 - GridItem: 新增 badge 属性 db94b2
 - Icon: 新增 badge 属性 575577
 - ImagePreview: 新增 closed 事件 5b279a
 - locale: 新增日语配置文件 #5853 #5854
 - SidebarItem: 新增 badge 属性 01482f
 - Tab: 新增 badge 属性 214b13
 - TabbarItem: 新增 badge 属性 d61cbd
 - TreeSelect: 新增 badge 选项 0cc7a3
 - Uploader: 新增 chooseFile 方法 #5818
 - Uploader: 新增 show-upload 属性 66c0b3
 - Uploader: 支持在 before-read 中返回修改后的文件对象 #5813
 
Bug Fixes
- Calendar: 修复在 Form 内使用时错误触发表单提交的问题 #5873
 - Field: 修复通过插槽使用 Uploader 时上传图片未展示的问题 #5868
 - ImagePreview: 修复上次调用结果未清除的问题 7fcfc5
 - Picker: 修复 setValues、setIndexes 等方法未触发多列联动更新的问题 #5807
 - Toast: 修复设置 forbidClick 后未锁定滚动的问题 df8777
 
v2.5.5
2020-03-11
Feature
- Calendar: 新增 show-title 属性 #5779
 - Calendar: 新增 show-subtitle 属性 #5779
 - Field: 优化虚拟键盘,type="number" 调起数字键盘 e89baa
 - Stepper: 优化虚拟键盘,调起数字键盘 58e74a
 - GoodsActionIcon: 新增 dot 属性 b983ac
 
Bug Fixes
- AddressEdit: 修复 showDetail 为 false 时仍然会校验地址的问题 #5803
 - Calendar: 修复在 multiple 模式下 color 属性不生效的问题 #5786
 - Field: 修复 button 插槽可能导致表单校验失败的问题 #5785
 - GoodsActionIcon: 修复使用 icon 插槽时 info 属性不生效的问题 #5788
 - Stepper: 修复在 Form 中使用时必须输入整数的问题 #5792
 - Sticky: 修复 Sticky 切换显隐导致位置错误的问题 41e5c0
 
v2.5.4
2020-03-08
Feature
- Calendar: 新增 multiple 类型 #5705
 - Field: 输入框增加 
line-height: inherit样式 #5737 - Search: 新增 left 插槽 #5771
 - Uploader: 新增 upload-icon 属性 b3b46c
 - Uploader: 圆角大小由 4px 调整为 8px c67918
 - Uploader: 优化上传区域样式 bd4e64
 
Bug Fixes
- Calendar: 修复 poppable 为 false 无法自动定位到当前日期的问题 #5760
 - DropdownMenu: 修复个别情况下 scrollIntoView 报错的问题 #5770
 - Tabs: 修复 scrollspy 在自定义的滚动容器中无法跳转的问题 0993b3
 - Tabs: 修复 scrollspy 开启时在 safari 上可能出现标签弹回的问题 #5727
 - TimePicker: 修复动态设置 min-date 时可能出现选中项错误的问题 #5767
 
Types
- Form: 修复缺少 scrollToField 方法类型定义的问题 df4439
 - ImagePreview: 修复缺少 closeable 选项类型定义的问题 d5438d
 - Toast: 修复缺少 iconPrefix 选项类型定义的问题 3237e5
 
v2.5.3
2020-02-28
Feature
- ActionSheet: 新增 close-on-popstate 属性 #5716
 - Area: 新增 columns-top、columns-bottom 属性 #5719
 - Area: 新增 title 插槽 #5719
 - Button: 新增 icon-prefix 属性 #5666
 - Cell: 新增 icon-prefix 属性 #5666
 - Field: 新增 icon-prefix 属性 #5666
 - Form: validator 新增 rule 参数 #5704
 - Form: 支持将 message 定义为函数 #5704
 - Form: 支持在 rule 中定义 pattern #5700
 - Form: 支持在 rule 中定义 formatter d87835
 - GridItem: 新增 icon-prefix 属性 #5666
 - Rate: 新增 icon-prefix 属性 #5666
 - TabbarItem: 新增 icon-prefix 属性 #5666
 
Bug Fixes
- Calendar: 修复隐藏状态下 scrollIntoView 函数报错的问题 #5708
 - DatetimePicker: 修复 getPicker 方法无法调用的问题 #5710
 - Popup: 修复 close-on-popstate 在 keep-alive 下无效的问题 f07077
 
v2.5.2
2020-02-21
Feature
- Calendar: 新增 close、closed 事件 556f33
 - Calendar: 新增 open、opened 事件 a83082
 - Form: 新增 scroll-to-error 属性 #5680
 - Form: 新增 validate-trigger 属性 c08db7
 - Form: 新增 scrollToField 方法 #5680
 - Sku: 新增 preview-on-click-image 属性 #5684
 - Sku: 新增 sku-header-image-extra 插槽 #5696
 
Bug Fixes
- Swipe: 修复容器宽度为小数时在部分安卓设备上出现换行的问题 02afe7
 
v2.5.1
2020-02-18
Feature
- Sku: 新增 initialMessages 字段
 - Calendar: 在调用 reset 方法后自动定位到当前月份 407b7d
 - Calendar: 在修改 default-date 属性后自动定位到当前月份 #5664
 
Bug Fixes
- Calendar: 修复在个别情况下日历渲染为空白的问题 #5640
 - Calendar: 修复在单选情况下使用 max-range 属性导致报错的问题 79d2c3
 - Form: 修复 error-message-align 属性类型定义报错的问题 #5674
 - Swipe: 修复在隐藏状态下触发浏览器缩放时元素宽度错误的问题 #5678
 
v2.5.0
2020-02-15
New Component
- 新增 Form 表单组件
 
Feature
- Field: 新增 name 属性 f3398d
 - Field: 新增 rules 属性 0ed7aa
 - AddressEdit: 新增 disable-area 属性 #5630
 - AddressList: 新增 item-bottom 插槽 #5629
 - RadioGroup: 新增 direction 属性 4dd41b
 - CheckboxGroup: 新增 direction 属性 153902
 - ImagePreview: 新增 scale 事件 #5658
 - ImagePreview: 新增 closeable 属性 #5654
 
Style
- Field: input 插槽的内容默认在垂直方向居中 03c826
 - Field: 优化 label-position 为 right 时的右边距 2d6445
 - Uploader: 优化禁用态上传区域颜色 #5628
 
Bug Fixes
- Calendar: 修复特定情况下未正确渲染日历内容的问题 #5640
 - Dialog: 修复 Dialog.Component 类型定义错误的问题 #5646
 - Field: 修复子元素文字颜色错误的问题 e17a4a
 - Picker: 修复未触发弹性滚动时 change 事件不生效的问题 #5662
 - Tabs: 修复自定义滚动容器时 scrollspy 属性无效的问题 #5637
 - Calendar: 修复底部按钮会触发表单提交的问题 e93fcb
 
v2.4.7
2020-02-06
Feature
- Calendar: 优化无障碍访问 2124cc
 - Field: 字数统计达到上限时高亮展示 61093e
 - Sku: 新增 sku-actions-top 插槽 #5617
 - Uploader: 支持展示上传中状态 #5625
 - Uploader: 支持展示上传失败状态 #5624
 
Style
- ActionSheet: 新增 @action-sheet-close-icon-active-color 变量 265bfe
 - Popup: 新增 @popup-close-icon-active-color 变量 660b03
 
Bug Fixes
- Calendar: 修复选中日期 className 属性未生效的问题 0b7c56
 - Popup: 修复使用 get-container 属性后 destroy 时抛出错误的问题
 
v2.4.6
2020-02-01
Bug Fixes
- Picker: 修复更新 columns 数据不生效的问题 #5614
 
v2.4.5
2020-02-01
Feature
Style
- DropdownItem: 新增 @dropdown-item-z-index 变量 6f4c6f
 - IndexBar: 新增 @index-anchor-z-index 变量 89ee8e
 - IndexBar: 新增 @index-bar-sidebar-z-index 变量 89ee8e
 - IndexBar: 新增 @index-bar-index-active-color 变量 0011db
 - Notify: 新增 @notify-text-color 变量 9dcf57
 - Overlay: 新增 @overlay-z-index 变量 95d19f
 - Rate: 新增 @rate-icon-disabled-color 变量 8b8471
 - Rate: 新增 @rate-icon-full-color 变量 5c804c
 - Rate: 新增 @rate-icon-void-color 变量 f90015
 - Slider: 新增 @slider-bar-height 变量 a5819c
 - Search: 新增 @search-content-background-color 变量 ea7419
 - Step: 新增 @step-active-color 变量 9e7a68
 - Tabbar: 新增 @tabbar-z-index 变量 0441f7
 - NavBar: 新增 @nav-bar-z-index 变量 a2d870
 - NumberKeyboard: 新增 @number-keyboard-z-index 变量 760938
 
Bug Fixes
- ImagePreview: 修复双击缩放时 max-zoom 属性不生效的问题 1baa60
 - Popup: 修复 position 为 center 时 duration 属性不生效的问题 44072e
 - Step: 修复 active-color 未改变分隔线颜色的问题 cfadce
 
v2.4.4 🐭
2020-01-24
Feature
- Card: 优化图片拉伸模式 e766d5
 - Calendar: 新增 get-contaienr 属性 #5609
 - Calendar: 新增 close-on-popstate 属性 2b82dc
 - CountDown: 新增 change 事件 #5599
 - GoodsActionButton: 新增 icon 属性 b83bed
 
Bug Fixes
- Sku: 修复 get-container 属性不能为 string 类型的问题 #5608
 
v2.4.3
2020-01-19
Feature
- Swipe: 页面隐藏时暂停自动轮播 113157
 - Stepper: 新增 long-press 属性 2f3ec6
 - Calendar: 新增 max-range、range-prompt 属性 #5583
 - ImagePreview: 新增 @image-preview-index-text-shadow 变量 e2f302
 
Improvement
- Icon: 更新 share 图标 2f77ac
 - Field: 优化 readonly 状态下的光标类型 60173d
 - Stepper: 优化 disable-input 状态下的输入框颜色 959eca
 
Bug Fixes
- GoodsAction: 修复未设置容器高度的问题 #5593
 
Types
v2.4.2
2020-01-14
Feature
- Sku: 新增 properties 属性 #5525
 - Field: 新增 digit 类型 #5524
 - Field: 新增 formatter 属性 #5534
 - Image: 新增 error-icon 属性 #5470
 - Image: 新增 loading-icon 属性 #5469
 - Swipe: 新增 prev、next 方法 #5548
 - GoodsAcitonIcon: 新增 color 属性 #5576
 
Improvement
- AddressList: 优化样式细节 #5507
 - AddressEdit: 优化错误提示展示方式 #5479
 - ActionSheet: 优化关闭按钮样式 #5574
 - CouponList: 优化样式细节 #5501
 - Calendar: 弹出时自动滚动到当前选中的日期 #5526
 - ImagePreview: 优化图片加载失败提示样式 #5570
 - 优化所有组件的光标类型 c1a535
 
Bug Fixes
- Button: 修复加载状态下仍会有点击反馈的问题 0a70d3
 - Card: 修复图片圆角样式未生效的问题 #5480
 - Calendar: 修复选中的日期无法展示提示信息的问题 #5536
 - Checkbox: 修复设置 label-disabled 后空白区域仍然可以点击的问题 3d10d4
 - CouponList: 修复点击反馈区域错误的问题 #5521
 - Field: 修复 type 为 number 时在 iOS 上仍然能输入非数字字符的问题 #5520
 - ImagePreview: 修复在桌面端使用时无法拖拽的问题 #4487
 - Picker: 修复点击事件偶尔会丢失的问题 5cbb9e
 - PullRefresh:修复 head-height 属性未正确设置高度的问题 028747
 - Tabs: 修复容器设置 fixed 布局时无法渲染底部条的问题 #5496
 
v2.4.1
2020-01-02
Feature
Bug Fixes
v2.4.0
2020-01-01
New Component
- 新增 Calendar 日历组件
 
Feature
- List: 新增 error 插槽 e9a938
 - List: 新增 finished 插槽 8a0705
 - Picker: 新增 confirm 方法 5eb2a4
 - PullRefresh: 新增 success 插槽 56e450
 - CouponList: 更新底部按钮样式 #5368
 - DatetimePicker: 新增 getPicker 方法 1dc1fe
 - TreeSelect: 新增 @tree-select-item-selected-size 变量 373159
 - Image: 新增 @image-loading-icon-size、@image-error-icon-size 变量 d7ae8c
 
Compatibility
在之前的版本中,有较多同学反馈在 iOS 10 ~ 11 上会偶现组件无法操作的情况,该问题的原因是 Vue 2.6.x 版本在绑定事件时存在事件无法冒泡的兼容性问题。相关 issue
从 2.4 版本开始,我们通过手动绑定事件的方式来规避这个问题,涉及以下组件:
- Area
 - DatetimePicker
 - ImagePreview
 - Rate
 - Slider
 - Swipe
 - SwipeCell
 - NumberKeyboard
 - Picker
 - PullRefresh
 
Bug Fixes
- Icon: 修复 medel-o 图标不展示的问题 7b905a
 - ImagePreview: 修复 close 事件重复触发的问题 #5410
 - PullRefresh: 修复下拉到顶部时可能不触发下拉刷新的问题 e00058
 - Tag: 修复动态设置 closeable 时动画错误的问题 fe6e2f
 - Tag: 修复 close 时会触发 click 事件的问题 #5351
 - Toast: 修复同时存在多个 Toast 时 forbidClick 可能失效的问题 #5398
 - Picker: 修复在桌面端使用时拖动后回弹的问题 #5430
 - Stepper: 修复在 safari 上禁用时文字颜色不正确的问题 #5428
 - IndexBar: 修复 IndexAnchor 没有父容器时定位错误的问题 #5429
 
Types
- AddressEdit: 新增 setAddressDetail 方法的类型定义 #5352
 - Area: 新增 reset 方法的类型定义 #5353
 - Checkbox: 新增 toggle 方法的类型定义 #5354
 - CountDown: 新增 start、end、reset 方法的类型定义 0438bd
 - DropdownItem: 新增 toggle 方法的类型定义 5c1883
 - Field: 新增 focus、blur 方法的类型定义 0b5c8e
 - List: 新增 check 方法的类型定义 285bce
 - Picker: 新增 getValues 等方法的类型定义 46d2b0
 - Sku: 新增 methods types d2bb9f
 - Swipe: 新增 swipeTo、resize 方法的类型定义 a1831b
 - SwipeCell: 新增 open、close 方法的类型定义 9a9676
 - Tabs: 新增 resize 方法的类型定义 3c526e
 - Uploader: 新增 closeImagePreview 方法的类型定义 cf191e
 
v2.3.3
2019-12-21
Bug Fixes
- 修复 babel-plugin-import 按需引入部分组件时编译报错的问题
 
v2.3.2
2019-12-20
Bug Fixes
- 修复 Area 未自动引入依赖的 Picker 样式的问题
 - 修复 DatetimePicker 未自动引入依赖的 Picker 样式的问题
 - 修复 CountDown 在特定情况下内部计时器未清除的问题 #5340
 - 修复 ImagePreview 在特定情况下会重复 onClose 回调的问题 #5341
 
v2.3.1
2019-12-20
Bug Fixes
- 修复全量引入组件时,入口文件中存在未编译的 ES6 代码的问题
 
v2.3.0
2019-12-20
Style
在 2.3.0 版本中,我们对业务组件的样式进行了全新升级,涉及以下组件:
- AddressEdit
 - Card
 - CouponList
 - ContactList
 - ContactCard
 - ContactEdit
 - SubmitBar
 
Features
- 内部构建流程升级,使用 @vant/cli 进行构建
 - AddressList: 新增 default-tag-text 属性 #5106
 - Card: 新增 price-top 插槽 #5134
 - Checkbox: 优化 toggleAll 性能 #5285
 - Circle: 新增 stroke-linecap 属性 #5087
 - CouponList: 新增 show-count 属性 #5139
 - ContactList: 新增 default-tag-text 属性 #5089
 - ContactCard: 新增 show-set-default 属性 #5083
 - ContactCard: 新增 set-default-label 属性 #5083
 - CountDown: 支持 SS 和 S 格式 #5154
 - Sku: 新增 new startSaleNum 属性 #5105
 - Sku: 新增 resetSelectedSku 方法 #5318
 - SubmitBar: 新增 text-align 属性 #5130
 - SwipeCell: 新增 open 事件 #5324
 - SwipeCell: 新增 before-close 属性 #5320
 - Tab: 新增 dot 属性 #5272
 - Tab: 新增 info 属性 #5274
 - Tab: 新增 rendered 事件 #5315
 - Tab: 新增 scrollspy 属性 #5273
 - Toast: 完善 TS 类型定义 #5086
 
Bug Fixes
- 修复 ActionSheet 按钮会提交表单的问题 #5181
 - 修复 Card 在未使用 price 属性的情况下 bottom 插槽不生效的问题 #5116
 - 修复 Dialog 快速点击按钮时可能重复触发 before-close 的问题 #5267
 - 修复 DropdownMenu 在页面滚动时菜单位置错误的问题 #5313
 - 修复 Icon medal 图标名称拼写错误的问题 #5242
 - 修复 NumberKeyboard 在隐藏状态下也会触发 blur 事件的问题 #5110
 - 修复 Picker 按钮会提交表单的问题 #5182
 - 修复 Popup 在 activated 后未重新打开的问题 #5286
 - 修复 Switch size 属性未定义 Number 类型的问题 #5229
 - 修复 SubmitBar 价格为整数时显示错误的问题 #5224
 - 修复 Sku 重置时未校验数量的问题 #5231
 - 修复 Sku 步进器可能输入小数的问题 #5202
 - 修复 Sku 步进器事件可能抛出小数的问题 #5210
 - 修复 Stepper 按钮会提交表单的问题 #5183
 - 修复 Stepper 在 max、min 属性变化时未更新输入框值的问题 #5257
 - 修复 TreeSelect 事件触发顺序错误的问题 #5153
 - 修复 TouchEmulator 在 Firefox 上的兼容性问题 #5118
 - 修复 Uploader 重复上传同张图片时不会触发 oversize 事件的问题 #5177
 - 修复主题定制时使用低版本 Less 会报错的问题 #5157
 
v2.2.16
2019-12-03
Features
v2.2.15
2019-11-28
Bug Fixes
- 修复 List 组件在部分情况下加载状态未重置的问题
 
v2.2.14
2019-11-22
Features
Bug Fixes
- 修复 Cell value 过长时不换行的问题 #5029
 - 修复 SwipeCell 在桌面端无法使用的问题 #5077
 - 修复 Field 在 Safari 下输入换行符时字数统计错误的问题 #5049
 - 修复 Tabbar 设置 safe-area-inset-bottom 后可能出现样式错位的问题 #5079
 - 修复 DropdownMenu 使用 get-container 属性时点击后会立即关闭的问题 #5047
 
v2.2.13
2019-11-14
Features
- Area: 新增 swipe-duration 属性 #5014
 - Swipe: 新增 stop-propagation 属性 #4972
 - Toast: 新增 overlay 选项 #4969
 - Toast: 新增 clickOnClickOverlay 选项 #4967
 - SwipeCell: 新增 opened 事件 #4986
 - ActionSheet: 新增 close-icon 属性 #5016
 - DropdownItem: 新增 title 插槽 #4975
 - DatetimePicker: 新增 swipe-duration 属性 #5015
 
Bug Fixes
- 修复 Tab name 设置为 0 时无法正确匹配的问题 #5017
 - 修复 Indexbar 隐藏时可能出现锚点位置错误的问题 #5012
 - 修复 Indexbar 设置 sticky-offset-top 后可能出现锚点位置错误的问题 #5012
 - 修复 DatetimePicker 使用 filter 并返回空数组时无法切换时间的问题 #4973
 - 修复 DateTimePicker 动态设置 max-hour 并小于 v-model 绑定的时间时出现错误的问题 #5006
 - 修复 ImagePreview 类型中定义缺少 swipeDuration 选项的问题 #4968
 
v2.2.12
2019-11-07
Features
Bug Fixes
- 修复 Sku 内容最小高度错误的问题 #4942
 - 修复 List 在初始化时可能同时触发两次 load 事件的问题 #4953
 - 修复 @border-color 变量无法定制某些组件边框颜色的问题 #4939
 
v2.2.11
2019-11-04
Features
- Switch: 新增 click 事件 #4915
 - Switch: size 属性支持 number 类型 #4913
 - Toast: 默认持续时间由 3 秒调整为 2 秒 #4886
 - Uploader: 新增 closeImagePreview 方法 #4901
 
Bug Fixes
- 修复 Button 加载图标颜色不正确的问题 #4868
 - 修复 CountDown 在销毁时未清除定时器的问题 #4918
 - 修复 CountDown 在 keep-alive 状态下未暂停定时器的问题 #4919
 - 修复 Grid 使用 icon 插槽时 info、dot 属性不生效的问题 #4902
 
v2.2.10
2019-10-27
Features
- Icon: 新增 font-display: auto 样式 #4831
 - Popup: 新增 close-on-popstate 属性 #4845
 - Picker: 新增 swipe-duration 属性 #4816
 - Toast: 支持针对指定类型的 Toast 修改默认配置 #4848
 
Bug Fixes
v2.2.9
2019-10-20
Features
- Tag: 新增 closeable 属性 #4763
 - Loading: 新增若干个 Less 变量 #4781
 - Progress: 新增若干个 Less 变量 #4790
 - Progress: 新增 track-color 属性 #4789
 - Toast: 新增 @toast-loading-icon-color 变量 #4782
 - Picker: 新增 @picker-loading-icon-color 变量 #4787
 - ImagePreview: 新增 cover 插槽 #4766
 
Bug Fixes
- 修复 Tag 圆角不够圆的问题 #4762
 - 修复 Sku 重置时不触发 sku-selected 事件的问题 #4755
 - 修复 ImagePreview 点击索引时会关闭预览的问题 #4764
 - 修复 AddressEdit 设置 area-placeholder 后无法选择海外地址的问题 #4769
 
v2.2.8
2019-10-17
Features
- Slider: 优化点击区域 #4701
 - Slider: 增加过渡动画 #4700
 - Dialog: 更新圆角样式 #4730
 - Uploader: 更新删除图标样式,添加图片圆角样式 #4712
 - Field: 新增 show-word-limit 属性 #4721
 - ActionSheet: 新增 description 属性 #4691
 - Stepper: 设置 decimal-length 属性后会在输入过程中进行校验 #4747
 - 新增渐变色相关的 Less 变量 #4752
 - 新增多行文字省略的内置样式 #4690
 
Bug Fixes
v2.2.7
2019-10-11
Features
- Dialog: 新增 width 属性 #4687
 - Dialog: 新增 overlay-class 属性 #4683
 - Dialog: 新增 overlay-style 属性 #4682
 - Uploader: 新增 file 类型的 result-type #4680
 - TreeSelect: 新增 className 选项 #4671
 
Bug Fixes
- 修复 Dialog 可能出现文字模糊的问题 #4686
 - 修复 Stepper 的 step 值很小时无法生效的问题 #4675
 - 修复 DatetimePicker 动态修改时间范围时, confirm 事件无法获取到正确结果的问题 #4676
 - 修复 Field 同时设置 error 和 disabled 属性时文字颜色错误的问题 #4666
 
v2.2.6
2019-10-08
Features
- Grid: 新增 icon-size 属性 #4656
 - Toast: 新增 transition 属性 #4638
 - Dialog: 新增 transition 属性 #4636
 - Dialog: 新增 open、close 事件 #4633
 - Dialog: 新增 opened、closed 事件 #4634
 - NumberKeyboard: 新增 extra-key 插槽 #4644
 - CheckboxGroup: 新增 toggleAll 方法 #4640
 
Bug Fixes
- 修复 GoodsAction 圆角错误的问题 #4653
 - 修复 Tabs 类型为 card 时上边距错误的问题 #4658
 - 修复 AddressList input 事件重复触发的问题 #4659
 - 修复 NumberKeyboard 在 Vue 2.6 下的兼容问题 #4632
 
v2.2.5
2019-09-28
Features
- Picker: 新增 columns-top 插槽 #4607
 - Picker: 新增 columns-bottom 插槽 #4607
 - Overlay: 新增 default 插槽 #4571
 - Overlay: 新增 custom-style 属性 #4572
 - Checkbox: 新增 bind-group 属性 #4600
 - DropdownItem: 新增 get-container 属性 #4611
 - Area: 新增 columns-placeholder 属性 #4580
 - AddressEdit: 新增 area-columns-placeholder 属性 #4584
 
Bug Fixes
- 修复 Overlay 未添加 TypeScript 定义的问题 #4601
 - 修复 Swipe swipeTo 方法在某些边界情况下过渡动画不正确的问题 #4570
 - 修复 Uploader 预览 URL 相同的图片时索引错误的问题 #4577
 
v2.2.4 [已废弃]
2019-09-28 🇨🇳
Tips
- 本版本存在样式丢失问题,请使用 2.2.5 版本
 
v2.2.3
2019-09-24
Features
- Cell: 优化无障碍访问 #4519
 - Popup: 优化无障碍访问 #4516
 - Search: 优化无障碍访问 #4522
 - Picker: 优化无障碍访问 #4521
 - GridItem: 优化无障碍访问 #4517
 - ActionSheet: 优化无障碍访问 #4525
 - Sku: 新增 previewImgUrl 字段 #4562
 - RadioGroup: 新增 icon-size 属性 #4529
 - RadioGroup: 新增 checked-color 属性 #4532
 - CheckboxGroup: 新增 icon-size 属性 #4530
 - CheckboxGroup: 新增 checked-color 属性 #4531
 - ActionSheet: 默认开启 round 属性 #4542
 - ActionSheet: 默认开启 safe-area-inset-bottom 属性 #4524
 - NumberKeyboard: 默认开启 safe-area-inset-bottom 属性 #4544
 
v2.2.2
2019-09-19
Features
- Dialog: 优化文字换行 #4506
 - Search: 新增 action-text 属性 #4501
 - Popup: 新增 close-icon-position 属性 #4507
 - Uploader: 回调函数增加 index 参数 #4460
 - GoodsActionButton: 加大按钮高度 #4461
 - AddressList: 新增 @address-list-item-radio-icon-color 变量 #4481
 
Bug Fixes
- 修复 Field 禁用状态在 safari 上文字颜色过浅的问题 #4508
 - 修复 DatetimePicker 选项为纯文字时陷入死循环的问题 #4485
 - 修复 ImagePreview 手势缩放时可能出现缩放比例异常的问题 #4477
 
v2.2.1
2019-09-12
Features
- Icon: 新增 dot 属性 #4425
 - Icon: 新增 down、wap-home 图标 #4404
 - GridItem: 新增 dot 属性 #4426
 - GridItem: 新增 info 属性 #4424
 - TreeSelect: 新增 dot 选项 #4433
 - Tab: 新增 to、url、replace 属性 #4422
 - Progress: 新增 stroke-width 属性 #4397
 - Popup: 新增 safe-area-inset-bottom 属性 #4419
 - Stepper: 新增 decimal-length 属性 #4443
 - Sku: 新增 stock-threshold 属性 #4444
 - Sku: 新增 safe-area-inset-bottom 属性 #4428
 - SidebarItem: 新增 dot 属性 #4432
 - Sku: 优化样式细节 #4437
 - Circle: 优化文本样式 #4401
 
Bug Fixes
v2.2.0
2019-09-06
Features
- Style: 更新基础红色为 #ee0a24 #4368
 - Rate: 新增 touchable 属性 #4361
 - Rate: 布局调整为 inline-block #4334
 - Rate: 优化手势滑动的流畅度 #4336
 - Popup: 新增 closeable 属性 #4362
 - Popup: 新增 close-icon 属性 #4366
 - Sidebar: 移除了内外边框 #4382
 - SidebarItem 新增 disabled 属性 #4325
 - TreeSelect: 新增 max 属性 #4323
 - TreeSelect: 支持通过 info 展示徽标 #4384
 - Uploader: 新增 close-preview 事件 #4376
 - ImagePreview: 新增图片加载过程的提示 #4378
 
Bug Fixes
- 修复 Field 在 Safari 浏览器上样式异常的问题 #4380
 - 修复 Button 在 color 属性中传入渐变色时边框颜色错误的问题 #4342
 - 修复 Dialog 关闭时未重置按钮加载状态的问题 #4352
 - 修复 Slider 初始值超出范围时展示错误的问题 #4337
 - 修复 Sidebar 徽标位置错误的问题 #4324
 - 修复 DropdownItem 选项选中态颜色丢失的问题 #4330
 - 修复 NumberKeyboard 在 iphoneX 上右侧按钮位置错误的问题 #4304
 - 修复 ImagePreview 在关闭后未重置图片缩放状态的问题 #4319
 - 修复 ImagePreview 在某些情况下页码不正确的问题 #4320
 
v2.1.8
2019-08-29
Features
- Picker: 新增 allow-html 属性 #4278
 - PasswordInput: 新增 focused 属性 #4279
 - GoodsActionButton: 新增 color 属性 #4255
 - Button: color 属性支持传入 linear-gradient 渐变色 #4252
 
Bug Fixes
- 修复 Circle stroke-width 超过 60 时样式错误的问题 #4256
 - 修复 Picker 滑动暂停时位置错误的问题 #4277
 - 修复 Picker 滑动结束时触发点击会跳动的问题 #4273
 
v2.1.7
2019-08-26
Bug Fixes
v2.1.6
2019-08-26
Features
- Tag: 新增 warning 类型 #4232
 - Image: 新增 radius 属性 #4230
 - Notify: 新增 type 属性 #4237
 - CellGroup: 新增 title 插槽 #4227
 - Sku: 支持动态设置 initial-sku 属性 #4214
 - Sku: 支持预览更高层级的规格类目图片 #4236
 - Locale: 支持西班牙语 #4235
 
Bug Fixes
- 修复 Tabbar 在 route 模式下选中样式错误的问题 #4229
 - 修复 NumberKeyboard 使用 title 属性时按钮位置错误的问题 #4228
 - 修复 IndexBar 在 sticky 模式下锚点位置可能超出元素边界的问题 #4218
 
v2.1.5
2019-08-23
Features
- Toast: 新增 closeOnClick 选项 #4192
 - Uploader: 新增 image-fit 属性 #4189
 - Uploader: 新增 click-preview 事件 #4206
 - Uploader: 新增 preview-full-image 属性 #4205
 - DropdownMenu: 新增 @dropdown-menu-title-active-text-color less 变量 #4208
 
Bug Fixes
v2.1.4
2019-08-21
Features
- Col: 新增 click 事件 #4169
 - Row: 新增 click 事件 #4170
 - Area: 新增 is-oversea-code 属性 #4163
 - Circle: 支持渐变色 #4157
 - Circle: 支持传入 number 类型的 size 属性 #4160
 - Tabbar: 支持通过 to.name 匹配路由 #4148
 - Sku: 页面返回时自动关闭图片预览 #4152
 - Uploader: 页面返回时自动关闭图片预览 #4151
 - Uploader: 图片预览支持更多图片格式 #4140
 - TreeSelect: 支持多选 #4130
 - TreeSelect: 支持在 active-id 属性上使用 sync 修饰符 #4133
 - TreeSelect: 支持在 main-active-index 属性上使用 sync 修饰符 #4132
 
Bug Fixes
- 修复 Sku 部分文案不支持国际化修改的问题 #4172
 - 修复 Field 按钮在 Firefox 上宽度变小的问题 #4144
 - 修复 Tabbar 触发 vue-router 路由重复跳转提示的问题 #4147
 - 修复 Picker 样式可能被重复引入的 base 样式覆盖的问题 #4136
 
v2.1.3
2019-08-15
Features
- Sku: 支持国际化 #4123
 - Button: 新增 color 属性 #4124
 - Uploader: 新增 before-delete 属性 #4118
 - Collapse: 新增 value 属性类型错误时的提示 #4122
 - TreeSelect: 新增 content 插槽 #4105
 - TreeSelect: 支持 string 类型的 height 属性 #4107
 - NumberKeyboard: 优化点击体验 #4116
 
Bug Fixes
- 修复 DropdownMenu 嵌套在 NavBar 内时样式错误的问题 #4098
 - 修复 Tab 动态插入标签页时下划线位置未更新的问题 #4091
 - 修复 Icon service-o 图标不完整的问题 #4088
 - 修复 Icon gift-o、refund-o 图标不完整的问题 #4089
 - 修复 Slider 位置未改变时也会触发 change 事件的问题 #4087
 
v2.1.2
2019-08-10
Features
- ActionSheet: 新增 color 选项 #4073
 - AddressEdit: 新增 postal-validator 属性 #4067
 - Stepper: 新增 show-plus、show-minus 属性 #4056
 - Icon: 新增 warning、good-job、good-job-o 图标 #4038
 - Icon: 新增 smile、music、thumb-circle、phone-circle 图标 #4048
 - Picker: 优化事件冒泡 #4043
 - Field: 优化图标点击区域 #4058
 - Divider: 优化无障碍访问 #4069
 - List: 优化底部文字大小 #4077
 - Image: img 标签继承圆角 #4032
 - Uploader: 支持 isImage 标记 #4072
 - DropdownMenu: 新增多个 Less 变量 #4071
 - 支持在 module 类型的 script 标签中引入 CDN 包 #4080
 
Bug Fixes
- 修复 Sticky 在局部滚动容器内位置错误的问题 #4055
 
v2.1.1
2019-08-02
Bug Fixes
v2.1.0
2019-08-01 🇨🇳
Features
- Sku: UI 升级,采用更圆润的视觉风格 #3875 #3922
 - GoodsAction: UI 升级,采用更圆润的视觉风格 #3967
 - Sku: 新增 price-tag 属性 #3875
 - Sku: 新增 hide-selected-text 属性 #3875
 - Sku: 新增 sku-header-origin-price 插槽 #3958
 - Dialog: 新增 title 插槽 #3985
 - Dialog: 优化垂直居中位置 #3905
 - Uploader: 新增多个 less 变量 #3907
 - ActionSheet: 新增多个 less 变量 #3908
 - AddressList: 新增 click-item 事件 #3942
 - CouponList: 新增 empty-image 属性 #3941
 - ImagePreview: 新增 swipe-duration 属性 #3963
 - SwipeCell: 新增 stop-propagation 属性 #3952
 
Bug Fixes
- 修复 Tabs 在特定情况下出现下划线位置错误的问题 #3961
 - 修复 AddressList 点击空白区域时无法选中的问题 #3909
 - 修复 IndexBar 在 index-list 变化时未更新高亮选项的问题 #3943
 - 修复 ImagePreview 图片较长时遮挡索引的问题 #4002
 - 修复 ImagePreview onClose 和 onChange 选项未被重置的问题 #3960
 - 修复 Radio 和 Checkbox 点击中间空白区域时无法选中的问题 #4007
 - 修复 SwipeCell 在打开的情况下阻止事件冒泡的问题 #3982
 - 修复 Tabs 在 sticky 模式下滚动回到顶部时存在 1 像素偏差的问题 #3949
 - 修复 DatetimePicker 使用 formatter 且为 time 类型时 confirm 事件参数错误的问题 #3969
 
v2.0.9
2019-07-19
Features
- 新增 Sticky 粘性布局组件 #3888
 - Grid: 优化文字换行 #3897
 - Toast: 优化图片图标展示 #3895
 - Image: 新增 round 属性 #3838
 - Image: 新增 show-error 属性 #3896
 - Image: 新增 show-loading 属性 #3893
 - Toast: 新增 iconPrefix 选项 #3872
 - Uploader: 支持预览网络图片 #3899
 - ActionSheet: 新增 round 属性 #3874
 - TreeSelect: 新增 click-nav、click-item 事件 #3892
 
Bug Fixes
- 修复 SwipeCell 与 Swipe 嵌套时无法使用的问题 #3898
 - 修复 Dialog closeOnPopstate 无法被禁用的问题 #3868
 - 修复 DropdownMenu toggle 方法无法打开菜单的问题 #3876
 
v2.0.8
2019-07-16
Features
- Sku: 支持自定义留言占位文本 #3864
 - DropdownMenu: 新增 icon 选项 #3855
 - DropdownMenu: 标题过长时自动截断 #3847
 - ImagePreview: 支持双击缩放手势 #3839
 
Bug Fixes
- 修复 Tab 点击事件参数丢失的问题 #3866
 - 修复 List 在 body 标签添加滚动样式时异常的问题 #3844
 - 修复 IndexBar 在某些情况下 active 锚点失效的问题 #3832
 
v2.0.7
2019-07-11
Features
- 新增 CountDown 倒计时组件 #3805
 - Popup: 新增 round 属性 #3781
 - IndexBar: 新增 sticky-offset-top 属性 #3791
 - PullRefresh: 新增 distance 插槽参数 #3829
 - Swipe: swipeTo 方法新增 immediate 参数 #3821
 - Slider: bar-height 属性支持 number 类型 #3794
 - DropdownMenu: 新增 close-on-click-outside 属性 #3824
 
Bug Fixes
- 修复 Popup 蒙层在某些情况下遮挡元素的问题 #3831
 - 修复 Stepper 在 iOS 12 下滚动位置错误的问题 #3804
 - 修复 Dialog closeOnPopstate 方法缺少类型定义的问题 #3789
 - 修复 DatetimePicker 使用 filter 属性且为 time 类型时 confirm 事件参数错误的问题 #3816
 
v2.0.6
2019-07-05
Features
Bug Fixes
- 修复 Grid gutter 属性不能传入 String 类型的问题 #3741
 - 修复 Swipe 使用 width 属性后出现空白区域的问题 #3751
 - 修复 PullRefresh 同步修改 loading 时状态错误的问题 #3719
 - 修复 Collapse 在 safari 浏览器上渲染内容较多时高度错误的问题 #3723
 
v2.0.5
2019-07-02
Features
Bug Fixes
- 修复 postcss 配置对 vant 不生效的问题
 
v2.0.4 🇨🇳
2019-07-01
Features
- 新增 Grid、GridItem 组件 #3669 #3682 #3683
 - Field: 新增 arrow-direction 属性 #3679
 - Sidebar: 新增 to、replace 属性 #3696
 - Sidebar: 支持通过 v-model 绑定当前项索引 #3698
 - IndexBar: 新增选中状态的类名,用于定制样式 #3692
 - Uploader: 支持 Number 类型的 name 属性 #3681
 - SwipeCell: 新增 name 属性 #3680
 - AddressEdit: 新增 detail-maxlength 属性 #3707
 - GoodsActionIcon: 新增 icon 插槽 #3705
 
Bug Fixes
v2.0.3
2019-06-27
Features
- ActionSheet: 新增 duration 属性 #3608
 - ActionSheet: 新增 open、opened 事件 #3639
 - ActionSheet: 新增 close、closed 事件 #3639
 - ImagePreview: 新增 onChange 选项 #3630
 - Popup: 优化蒙层动画时长 #3610
 - Uploader: 支持点击查看大图 #3603
 - Uploader: 支持预览非图片文件 #3604
 - Stepper: 新增多个 Less 变量 #3599
 - Icon: 更新 checked、comment、comment-o 图标 #3615
 
Bug Fixes
- 修复 Icon 传入图片时被拉伸的问题 #3667
 - 修复 ImagePreview 滚动穿透问题 #3645
 - 修复 Tab 使用 title slot 时可能报错的问题 #3631
 - 修复 vetur 插件自动补全组件属性不生效的问题 #3617
 
v2.0.2
2019-06-21
Features
- Picker: 优化滚动速率 #3556
 - Card: 新增 click-thumb 事件 #3586
 - CouponList: 新增 enabled-title、disabled-title 属性 #3578
 - Slider: 支持传入任意范围的 min、max 值 #3566
 - Uploader: 支持 before-read 属性返回 Promise #3572
 - NumberKeyboard: 支持 v-model 绑定输入值 #3531
 - NumberKeyboard: 新增 maxlength 属性 #3532
 - 新增 sideEffects 配置以支持 tree shaking #3530
 
Bug Fixes
v2.0.1
2019-06-15
Features
- Toast: 新增 icon 属性 #3485
 - DropdownMenu: 新增 direction 属性 #3490
 - NumberKeyboard: 新增 delete 属性 #3499
 - Icon: 使用 Image 组件优化图片布局 #3515
 - Tab: 支持 string 类型的 line-width 和 line-height #3514
 
Bug Fixes
- 修复 Image 组件 TS 定义缺失的问题 #3520
 - 修复 SwitchCell 加载图标偏移的问题 #3501
 - 修复 Locale 函数类型文案无法修改的问题 #3498
 - 修复 Toast 在 multiple 模式下没有淡出动画的问题 #3504
 
v2.0.0
2019-06-12
主要变动
- 增加四个新组件
 - 增加数十个 API
 - 优化无障碍访问
 - 全新的卡片风格文档,支持文档搜索
 - 所有组件支持通过
less变量自定义样式 - 调整了部分不合理的命名,废弃少量 API
 
新组件
在 2.0 版本中,我们引入了社区中呼声最高的四个组件,分别是:
- Image 图片,类似于小程序原生的 Image 标签,支持多种图片裁剪模式
 - IndexBar 索引栏,通讯录中的字母索引栏,用于长列表快速索引
 - Skeleton 骨架屏,在待加载区域展示的占位区块,提供界面加载过程中的过渡效果
 - DropdownMenu 下拉菜单,用于列表的分类选择、筛选及排序
 
新文档
文档方面,我们重新设计了文档站点,用卡片的方式组织段落,更加直观。对一些较为复杂的组件,我们对示例进行细粒度的拆分,添加更多的用法介绍,以帮助大家更快地上手使用。
此外,文档站点也支持了搜索和版本切换。
样式定制
移动端 UI 风格多变,对组件的可定制性要求较高。从 2.0 版本开始,Vant 中的所有组件都支持通过 Less 变量进行样式定制。同时我们新增了较多样式相关的 Props,便于快速定制组件风格。
更轻量
轻量化是 Vant 的核心开发理念之一。在过去一年多时间里,我们新增了若干个组件和数百项功能,而代码包体积从 1.0 版本的 169kb 降低到了 2.0 版本的 161kb(45kb gzipped),平均每个组件体积下降 13%,这主要得益于组件内部逻辑的重构和复用。
在未来的 Vue 3.0 版本中,会提供 Function-based API 这一更优的逻辑复用方式,预计能帮助 Vant 进一步优化代码包体积。
不兼容更新
2.0 版本中包含少量不兼容更新,主要是调整命名和移除个别属性。对于正在使用 1.x 版本的项目,请按照下方的列表依次检查,大部分项目可以无痛升级。
Actionsheet
- 重命名为
ActionSheet 
Button
- 移除
bottom-action属性,请使用square和size代替 
Field
- 移除
on-icon-click属性,请使用click-right-icon事件代替 icon属性重命名为right-iconicon插槽重命名为right-iconclick-icon事件重命名为click-right-icon
GoodsAction
GoodsActionBigBtn重命名为GoodsActionButtonGoodsActionMiniBtn重命名为GoodsActionIconGoodsActionBigBtn移除primary属性,请使用type属性代替
Step
- 移除
icon属性 - 移除
title属性 - 移除
icon-class属性 - 移除
description属性 - 移除
message-extra插槽 
Badge
BadgeGroup重命名为SidebarBadge重命名为SlidebarItem
Loading
- 移除
circle类型 - 移除
gradient-circle类型 
Checkbox
- 调整为
flex布局,可能对原有布局产生影响 
Radio
- 调整为
flex布局,可能对原有布局产生影响 
Waterfall
- 移除在 1.0 版本废弃的 Waterfall 组件,请使用
List组件代替,或使用独立的@vant/waterfall包。 
无障碍访问
对以下组件增加了无障碍访问的支持:
- Accordion
 - Checkbox
 - Dialog
 - DropdownMenu
 - GoodsAction
 - List
 - NoticeBar
 - NumberKeyboard
 - Radio
 - Rate
 - Stepper
 - Tab
 - Slider
 - Switch
 
新特性
ActionSheet
- 新增
lock-scroll属性 - 新增
click-overlay事件 - 新增
close-on-click-action属性 - 支持同时使用
title和actions属性 
Area
- 支持
reset方法传入code参数 
Button
- 新增
icon属性 - 新增
loading-type属性 
Checkbox
- 新增
icon-size属性 
DatetimePicker
- 新增
filter属性 
Field
- 新增
input插槽 - 新增
click事件 - 新增
clickable属性 - 新增
label-class属性 - 优化输入体验,输入法拼写过程中不再会触发
v-model更新 
GoodsActionButton
- 新增
type属性 
Icon
- 支持
Number类型的size属性 
ImagePreview
- 新增
close-on-popstate属性 
List
- 优化滚动判断逻辑
 
Loading
- 新增
default插槽 - 新增
vertical属性 - 新增
text-size属性 - 支持
Number类型的size属性 
Notify
- 新增
onClick选项 - 新增
onClose选项 - 新增
onOpened选项 
NoticeBar
- 新增
left-icon插槽 - 新增
right-icon插槽 
PasswordInput
- 新增
gutter属性 
Picker
- 支持惯性滚动
 - 新增
toolbar-position属性 
Popup
- 新增
click事件 - 新增
duration属性 
Radio
- 新增
icon-size属性 
Rate
- 新增
gutter属性 - 支持
String类型的size属性 
Search
- 新增
clearable属性 - 新增
left-icon属性 - 新增
right-icon属性 - 新增
right-icon插槽 - 优化输入体验,输入法拼写过程中不再会触发
v-model更新 
Slider
- 新增
drag-start事件 - 新增
drag-end事件 
Steps
- 新增
inactive-icon属性 - 新增
inactive-icon插槽 
Stepper
- 支持
Number类型的input-width属性 
SubmitBar
- 新增
tip-icon属性 - 新增
suffix-label属性 
SwipeCell
- 支持自动计算
left-width和right-width 
Switch
- 加载图标颜色现在会跟随背景色变化
 
SwitchCell
- 新增
border属性 - 新增
cell-size属性 
Sku
- 新增
preview-open事件 - 新增
preview-close事件 
Tab
- 新增
border属性 - 优化
animated动画性能 - 修复开启
animated后高度错误的问题 
Tabbar
- 新增
route属性 - 新增
border属性 - 新增
inactive-color属性 
TabbarItem
- 新增
name属性 
Toast
- 新增
onOpened选项 
Uploader
- 新增上传区域默认样式
 - 新增
delete事件 - 新增
upload-text属性 - 新增
max-count属性 - 新增
preview-size属性 - 新增
preview-image属性 - 支持通过
v-model绑定文件列表 oversize事件增加detail参数
后续计划
我们计划在今年下半年推出 VantWeapp 1.0 版本,目标是对标 Vant 2.0 版本,将大部分新组件和新功能同步到小程序端。
同时,Vant 3.0 版本也在酝酿当中,不出意外的话,3.0 版本会基于 Vue 3.0 实现,并争取和 Vue 3.0 同期发布。
对于 Vant v1 版本,后续会进入维护期,跟进问题修复,但不再引入功能性改动。






