- 更新日志
- 更新内容
- v3.6.4
- v3.6.3
- v3.6.2
- v3.6.1
- v3.6.0
- v3.5.4
- v3.5.3
- v3.5.2
- v3.5.1
- v3.5.0
- v3.4.9
- v3.4.8
- v3.4.7
- v3.4.6
- v3.4.5
- v3.4.4
- v3.4.3
- v3.4.2
- v3.4.1
- v3.4.0
- v3.3.7
- v3.3.6
- v3.3.5
- v3.3.4
- v3.3.3
- v3.3.2
- v3.3.1
- v3.3.0
- v3.2.8
- v3.2.7
- v3.2.6
- v3.2.5
- v3.2.4
- v3.2.3
- v3.2.2
- v3.2.1
- v3.2.0
- v3.1.5
- v3.1.4
- v3.1.3
- v3.1.2
- v3.1.1
- v3.1.0
- v3.0.18
- v3.0.17
- v3.0.16
- v3.0.15
- v3.0.14
- v3.0.13
- v3.0.12
- v3.0.11
- v3.0.10
- v3.0.9
- v3.0.8
- v3.0.7
- v3.0.6
- v3.0.5
- v3.0.4
- v3.0.3
- v3.0.2
- v3.0.1
- v3.0.0
- v3.0.0-rc.4
- v3.0.0-rc.3
- v3.0.0-rc.2
- v3.0.0-rc.1
- v3.0.0-beta.10
- v3.0.0-beta.9
- v3.0.0-beta.8
- v3.0.0-beta.7
- v3.0.0-beta.6
- v3.0.0-beta.5
- v3.0.0-beta.4
- v3.0.0-beta.3
- v3.0.0-beta.2
- v3.0.0-beta.1
- v3.0.0-beta.0
- v3.0.0-alpha.5
- v3.0.0-alpha.4
- v3.0.0-alpha.3
- v3.0.0-alpha.2
- v3.0.0-alpha.1
- v3.0.0-alpha.0
更新日志
提示
当前文档为 Vant 3 的更新日志,其他版本请参考:
介绍
Vant 遵循 Semver 语义化版本规范。
发布节奏
- 修订号:每周发布,包含新特性和问题修复。
- 次版本号:每隔一至二个月发布,包含新特性和较大的功能更新,向下兼容。
- 主版本号:无固定的发布时间,包含不兼容更新和重大功能更新。
更新内容
v3.6.4
2022-10-07
Bug Fixes
v3.6.3
2022-09-24
Feature
Bug Fixes
- Tabs: 修复个别情况下页面滚动位置错误的问题 #11085
- Tabs: 修复初始化时菜单横向滚动位置错误的问题 #11059
- Locale: 修复读取 i18n 文案时可能获取到 JS 原生方法的问题 #11010
v3.6.2
2022-09-04
Bug Fixes
- 修复 touchmove 事件导致控制台出现 passive event warning 的问题 #10975
- Calendar: 修复使用 allow-same-day 属性时 default-date 不能设置为同一天的问题 #10976 #10971
- indexBar: 修复个别情况下无法滚动到正确位置的问题 #10994
- Swipe: 修复 touchmove 事件在边界情况下被 preventDefault 的问题 #10980
- @vant/area-data: 更新大兴安岭相关地区码 #11000
v3.6.1
2022-08-24
Feature
Bug Fixes
- 修复 touchstart 导致控制台出现 passive event warning 的问题 #10954
- Tabs: 修复开启 swipeable 时,resize 方法无法正确生效的问题 #10964
v3.6.0
2022-08-21
New Component
- 新增 Space 间距 组件, 由 @LadyChatterleyLover 贡献 #10857
Feature
- ConfigProvider: 新增 z-index 属性,用于设置弹窗组件的 z-index #10915
- Form: 新增 rule 的 validateEmpty 选项 #10913
- Popup: 新增 role 和 tabindex,优化无障碍访问 #10894
- TouchEmulator: 支持 .mjs 后缀 #10888
Bug Fixes
- 修复在 WebStorm 下标签无法自动补全的问题 #10946
- Badge: 修复使用 show-zero 时字符串
'0'
不生效的问题 #10921 - Calendar: 修复关闭弹窗过程中内容白屏的问题 #10910
- Calendar: 修复控制台出现读取 getFullYear 异常的问题 #10909
- Empty: 修复在 Tab 下嵌套使用时渲染异常的问题 #10943
- Popover: 修复在 Popup 下嵌套使用时无法滚动的问题 #10949
- PullRefresh: 修复 Chrome 控制台出现 passive event warning 的问题 #10938
- Search: 修复 —van-search-input-height 样式变量不生效的问题 #10911
v3.5.4
2022-08-06
Bug Fixes
- 修复 CDN 资源中包含
NODE_ENV
导致报错的问题 #10887
v3.5.3
2022-07-31
Feature
Bug Fixes
- Tabbar: 修复使用 placeholder 属性时可能无法获取底部安全区高度的问题 #10827
- NavBar: 修复使用 placeholder 属性时可能无法获取底部安全区高度的问题 #10827
- Popover: 修复动态设置 offset 属性不生效的问题 #10840
- Uploader: 修复点击预览大图时会展示上传失败的图片的问题 #10790
v3.5.2
2022-06-26
Feature
- ActionBar: 新增 placeholder 属性 #10724
- Field: 新增 start-validate 和 end-validate 事件 #10726
- SubmitBar: 新增 placeholder 属性 #10725
Bug Fixes
- List: 修复父节点样式包含
overflow: overlay
时未被判定为滚动容器的问题 #10743
v3.5.1
2022-06-12
Feature
- PullRefresh: 新增 change 事件 #10702
Bug Fixes
- Calender: 修复动态设置 maxDate 或 minDate 可能导致月份渲染失败的问题 #10668
- Popup: 修复未使用 teleport 时 deactivated 后会自动关闭的问题 #10706
- Toast: 修复 toast.clear 缺少类型定义的问题 #10699
- Uploader: 修复 preview-options 属性中 images 为必填字段的问题 #10698
v3.5.0
2022-06-05
支持 Nuxt 3
为了支持 Nuxt 3,我们调整了部分 ESModule 文件的后缀名,从 .js
调整为 .mjs
:
vant/es/**/*.js
—>vant/es/**/*.mjs
@vant/use/dist/index.esm.js
—>@vant/use/dist/index.esm.mjs
@vant/popperjs/dist/index.esm.js
—>@vant/popperjs/dist/index.esm.mjs
@vant/area-data/dist/index.esm.js
—>@vant/area-data/dist/index.esm.mjs
webpack、vite 等构建工具默认支持 .mjs
后缀,因此不需要额外配置。对于 uni-app 等工具,可能需要添加配置来解析 .mjs
文件。
Feature
@vant/use
@vant/popperjs
等 npm 包添加 exports 字段 #10650- Dialog: 支持禁用按钮 #10665
- Locale: 新增 Bulgarian 保加利亚语 #10609
- Locale: 新增 Farsi 波斯语 #10637
- Locale: 新增 Greek 希腊语 #10621
- Locale: 新增 Hebrew 希伯来语 #10591
- Switch: 新增 node 插槽 #10573
- Switch: 新增 background 插槽 #10666
- Form: 新增 getValidationStatus 方法 #10620
- Uploader: 新增 preview-delete 插槽 #10606
Bug Fixes
- Area: 修复二次打开时未正确渲染遮罩层的问题 #10664
- field: 修复动态渲染插槽时可能导致输入框拼音被清空的问题 #10582
- Picker: 修复动态设置 columns-field-names 不生效的问题 #10562
v3.4.9
2022-05-02
Feature
- Form: 支持同时设置多个 validate-trigger 值 #10544
- Empty: 支持在无网络的环境下离线使用,图片从 CDN 调整为内联的 SVG 图片 #10514 #10515 #10516
- Loading: 优化无障碍访问 #10568
Bug Fixes
- @vant/area-data: 修复发布到 npm 时包含 tsconfig.json 文件导致编译错误的问题 f927f6
v3.4.8
2022-04-16
Feature
- CalendarDay: 增加日期行间距 #10441
- Empty: 支持单独设置 image 的宽高 #10465
- Field: 新增 enterkeyhint 属性 #10478
- Form: 新增 getValues 方法 #10511
- Icon: 新增 qq、weibo 等图标 #10468
- Locale: 新增 Danish 丹麦语 #10513
- ShareSheet: 不再依赖 CDN 上的图片资源,使用 iconfont 代替 #10469
- web-types.json 文件增加 event arguments 信息 #10474
Bug Fixes
v3.4.7
2022-03-29
Feature
- @vant/area-data: 新增南京市江北新区 #10410
- CouponList: 更新优惠券为空时的占位图 #10436
- Locale: 新增 Icelandic 冰岛语 #10418
- Locale: 新增 Lao 老挝语 #10388
- Locale: 新增 Swedish 瑞典语 #10419
- NumberKeyboard: 优化随机排序算法 #10428
- Uploader: preview-size 属性支持单独设置宽度和高度 #10438
Bug Fixes
- Calendar: 修复 scrollToDate 方法在个别情况下不生效的问题 #10432
- DatetimePicker: 修复动态改变最大值或最小值时,currentDate 不准确的问题 #10431
- IndexBar: 修复底部索引高亮状态不正确的问题 #10404
- Tab: 修复使用 v-if 延迟渲染更新不正确的问题 #10392
v3.4.6
2022-03-13
Feature
- Style: 新增 van-safe-area-top 样式类 #10356
- Calendar: 新增 safe-area-inset-top 属性 #10358
- Popup: 新增 safe-area-inset-top 属性 #10357
Bug Fixes
- Skeleton: 修复个别情况下出现 non-props attributes warning 的问题 #10384
- SwipeCell: 修复阻止滑动事件冒泡无效的问题 #10319
- Toast: 修复切换 type 时 message 不显示的问题 #10311
- 修复提示 VisibilityState 类型不存在的问题 #10370
v3.4.5
2022-02-14
Feature
- CollapseItem: 新增 lazy-render 属性 #10270
- Dialog: 支持通过 enter/esc 进行键盘操作 #10261
- Locale: 新增 Bangla 孟加拉语 #10287
- Locale: 新增 Indonesian 印度尼西亚语 #10289
- Locale: 新增 Italian 意大利语 #10288
- Locale: 新增 Ukrainian 乌克兰语 #10291
- Locale: 新增 Vietnamese 越南语 #10294
style
- SubmitBar: 将冒号调整为英文冒号 #10286
Types
- IndexBar: 修复 index-list 属性无法传入 number 类型的问题 #10273
- Toast: 修复缺少 teleport 属性定义的问题 #10272
- Uploader: 修复 UploaderBeforeRead 类型定义不准确的问题 #10274
v3.4.4
2022-02-07
- Vant 3 对应的 npm tag 切换为
latest
v3.4.3
2022-01-26
Feature
Bug Fixes
v3.4.2
2022-01-17
Feature
- Cascader: 新增 show-header 属性 #10202
- Image: 新增 position 属性 #10142
- ImagePreview: 优化缩放手势的流畅度 #10187
- Overlay: 新增 lazy-render 属性 #10180
- web-types.json 现在默认使用英文描述 #10207
Bug Fixes
- Calendar: 修复范围选择包括被禁用的日期时可能选择错误的问题 #10196
- Image: 修复使用 lazy-load 时可能无法正常加载的问题 #10193
- ImagePreview: 修复快速缩放手势导致预览关闭的问题 #10188
- Skeleton: 修复 row 属性为字符串类型时不生效的问题 #10172
- NavBar: 修复在 safari 上占位元素高度错误的问题 #10195
- Tabbar: 修复在 safari 上占位元素高度错误的问题 #10195
v3.4.1
2022-01-10
Bug Fixes
v3.4.0
2022-01-01
Bug Fixes
- Icons: 修复 URL 缺少协议导致个别浏览器出现异常的问题 #10079
- Picker: 修复选项为空时也会渲染选择框的问题 #10135
- Popup: 修复 close 事件触发两次的问题 #10132
- PullRefresh: 修复在个别浏览器上会触发原生回弹效果的问题 #10080
- Step: 修复 inactive-color 属性未正确生效的问题 #10049
- SwipeCell: 修复打开状态下也会触发 open 事件的问题 #10059
- swipe: 修复个别情况下无法正确滚动的问题 #10052 #10069
- Tabs: 修复标签页为空时会渲染一个错误的底部条的问题 #10063
Feature
- ActionBarIcon: 新增 badge-props 属性 #10096
- ActionSheet: 新增 option 插槽 #10065
- Badge: 新增 badge-props 属性 #10095
- GridItem: 新增 badge-props 属性 #10097
- Icons: 新增 cash-o 图标 #10076
- ImagePreview: 新增 overlayClass 选项 #10044
- Notify: 新增 position 属性 #10056
- Popover: 新增 action 插槽 #10091
- Search: 新增 click-left-icon、click-right-icon 事件 #10139
- SidebarItem: 新增 badge-props 属性 #10106
- Swipe: indicator 插槽新增 total 参数 #10060
- TabbarItem: 新增 badge-props 属性 #10092
- Tabs: 新增 shrink 属性 #10125
style
Types
- 增加所有组件的全局类型,在 volar 中提供默认提示 #10136
- Field: 修复 type 属性定义不全的问题 #10042
- Popup: 导出 PopupInstance 类型 #10062
- Search: 修复事件类型定义不全的问题 #10134
v3.3.7
2021-12-12
Feature
- Badge: 新增 position 属性 #10024
Bug Fixes
- DatetimePicker: 修复调用 Picker 实例方法后日期未正确更新的问题 #10029
- Field: 修复输入内容包含 emoji 时,长度计算错误的问题 #10033
- Pagination: 修复 change 事件不触发的问题 #10018
- 修复 tree shaking 不生效的问题 #10034
v3.3.6
2021-12-05
Bug Fixes
- 修复 ssr.js 文件引用路径错误的问题 #9999
v3.3.5
2021-12-02
Bug Fixes
v3.3.4
2021-12-01
- 修复
lib/ssr.js
文件不存在导致 SSR 失败的问题
v3.3.3
2021-11-30
Feature
Bug Fixes
v3.3.2
2021-11-28
Feature
- 新增
package.json
中的exports
字段 #9952 - Tabbar: 支持在 route 模式下匹配子路由 #9926
- Tabs: 将
van-tab__pane-wrapper
类重命名为van-tab__panel-wrapper
#9951
Bug Fixes
- Calendar: 修复 show-confirm 为 false 时不会限制最大日期范围的问题 #9948
- Calendar: 修复
scrollToDate
方法无法精确滚动到对应日期的问题 #9949 - Swipe: 修复开始滑动时未阻止 touchmove 事件行为的问题 #9920
v3.3.1
2021-11-23
Bug Fixes
- AddressEdit: 修复表单校验不通过时也会触发 save 事件的问题 #9917
v3.3.0
2021-11-19
Accessibility
改善以下组件的无障碍访问体验:
- Cascader: 增加 role=”menu”, tabindex, aria-checked, aria-disabled 属性 #9886
- CountDown: 增加 role=”timer” 属性 #9906
- DropdownMenu: 增加 role=”menu”, tabindex, aria-labelledby 属性 #9893
- Field: 增加 aria-labelledby 属性 #9883
- List: 增加 role=”button”, tabindex 属性 #9888
- Pagination: 增加 role=”navigation” 和 button 标签 #9901
- Popover: 增加 tabindex, aria-disabled 属性 #9889
- Rate: 增加 aria-disabled, aria-readonly 属性 #9881
- Search: 提供默认的 id 属性 属性 #9884
- Sidebar: 增加 role=”tab”, tabindex, aria-selected 属性 #9903
- Slider: 增加 aria-disabled, aria-readonly 属性 #9880
- Stepper: 增加 aria-disabled 属性 #9877
- Stepper: 增加 role=”group” 属性 #9876
- Switch: 增加 tabindex 属性 #9887
- Tabbar: 增加 role=”tab”, tabindex, aria-selected 属性 #9895
- Tabs: 增加 aria-controls 属性 #9882
- Tabs: 增加 aria-disabled 属性 #9878
- Tabs: 增加 tabindex, aria-orientation 属性 #9872
- Uploader: 删除按钮增加 role=”button”, tabindex, aria-label 属性 #9905
- 移除禁用元素的 tabindex 属性 #9879
Feature
- Popup: 移除多余的 click 事件监听 #9896
- Field: 导出
FieldRuleValidator
等多个类型定义 #9843 - Empty: 压缩 svg 图标 #9869
- NumberKeyboard: 压缩 svg 图标 #9869
- Tabs: 将
van-tab__pane
类重命名为van-tab__panel
#9885
Bug Fixes
- Popover: 修复 useClickAway 方法在 SSR 时报错的问题 #9899
- CouponList: 修复列表高度不正确的问题 #9874
- Field: 修复点击只读输入框会触发表单验证的问题 #9862
- Switch: 修复全局设置 font-size 时样式错误的问题 #9842
- Tabbar: 修复 route 模式下无法触发 before-change 属性的问题 #9856
v3.2.8
2021-11-09
Feature
- Cascader: 新增 options-bottom 插槽 #9804
- SubmitBar: 新增 SubmitBarTextAlign 类型 f95567
- PasswordInput: 新增 PasswordInputProps 类型 #9820
Bug Fixes
- NavBar: 修复 NavBarProps 拼写错误的问题 #9818
- Progress: 修复圆角大小错误的问题 #9826
- SubmitBar: 修复未导出 SubmitBarProps 的问题 #9819
- Tabs: 修复 click-tab 触发顺序早于 before-change 的问题 #9805
v3.2.7
2021-11-04
Feature
- 导出所有组件的 Props 类型 #9717
- 新增 —van-text-color-2 CSS 变量 #9759
- 新增 —van-text-color-3 CSS 变量 #9776
- Cascader: 新增 options-top 插槽 #9732
- Coupon: 新增 —van-coupon-content-text-color CSS 变量 #9760
- Picker: 新增 —van-picker-mask-color CSS 变量 #9783
Bug Fixes
v3.2.6
2021-10-24
Feature
- AddressEdit: 移除点击删除按钮的弹窗交互 #9671
- Calendar: 新增 confirm-text 插槽 #9689
- Progress: 新增 —van-progress-inactive-color 样式变量 #9711
- ShareSheet: 新增 round 属性 #9645
- 支持通过 css vars 定义渐变的背景色 #9678
Performance
Types
Bug Fixes
- ActionSheet: 修复 closeOnPopstate 属性不生效的问题 #9644
- AddressEdit: 修复 address-edit-button-font-size 变量不生效的问题 #9662
- Badge: 修复使用 dot 属性且自定义大小时样式错误的问题 #9686 #9687
v3.2.5
2021-10-08
Feature
- Field: 新增 error-message 插槽 #9634
Performance
Types
Bug Fixes
v3.2.4
2021-09-26
Feature
Performance
Types
Bug Fixes
- Collapse: 修复 wrapper ref 可能为空导致报错的问题 #9505
- CouponList: 修复错误的滚动条样式 #9480
- Radio: 修复 icon ref 可能为空导致报错的问题 #9503
- Tabs: 修复多个 Tabs 组件同时存在时动画失效的问题 #9543
v3.2.3
2021-09-12
Bug Fixes
- Button: 修复无法通过 CSS 变量设置渐变背景色的问题 #9454
- Calendar: 日历组件已经禁用部分日期依然可以选择日期区间的问题 #9361
- Field: 修复全局设置 user-select: none 时 IOS 下无法输入的问题 #9418
- FIeld: 修复 field-error-message-font-size 变量名称错误的问题 #9394
- Popup: 修复在 keep-alive 下激活时无法开启自动轮播的问题 #9452
- Theme: 移除了内部 less import 的波浪号 a7ab2f
- slider: 修复双滑块情况下,传入空数组无法滑动的问题 #9409
- Uploader: 修复 —van-uploader-delete-icon-size 变量未正确生效的问题 #9453
v3.2.2
2021-09-02
Feature
- Field: 新增 id 属性 #9347
- Field: 新增
van-field__error
类名 #9327 - Field: label 现在会使用原生
label
标签 #9346 - Popover: 新增 show-arrow 属性 #9372
- Progress: 新增过渡动画效果 ba4ff5
- Search: 新增 id 属性 #9349
- Tab: 新增 show-zero-badge 属性 #9343
- Locale: 精简一部分国际化文本配置 #9329
Bug Fixes
- AddressEdit: 移除了无效的样式变量 #9364
- Progress: 修复在 v-show 内使用时无法正确渲染的问题 841e09
- Progress: 修复 percentage 属性缺少默认值的问题 8ac597
- 修复动画相关的 CSS 变量不生效的问题 #9337
v3.2.1
2021-08-22
Feature
- Circle: 新增 start-position 属性 #9305
- Slider: 新增 reverse 属性 #9308
- NumberKeyboard: 新增 van-number-keyboard-key-background-color CSS 变量 #9303
- PasswordInput: add password-input-text-color CSS 变量 #9304
Bug Fixes
- Calendar: 修复 month-show 事件缺少 title 参数的问题 #9275
- Dialog: 修复 beforeClose 重复触发的问题 #9283 #9291
- Field: 修复 FieldInstance 类型未导出的问题 #9254
- Rate: 修复 count 属性传入字符串类型时展示错误的问题 #9307
- TreeSelect: 修复 CSS 负数变量不生效导致样式错误的问题 #9306
v3.2.0
2021-08-12
Feature
- Form: 新增 useCustomFieldValue 方法,用于自定义表单项 #9200
- Button: loading-size 属性支持 number 类型 #9177
- Style: 新增 van-safe-area-bottom 样式类 #9205
Types
- AddressEdit: 新增 AddressEditInstance 类型 #9197
- Area: 新增 AreaInstance 类型 #9195
- Calendar: 新增 CalendarInstance 类型 #9165
- Checkbox: 新增 CheckboxInstance 类型 #9140
- CheckboxGroup: 新增 CheckboxGroupInstance 类型 #9142
- CollapseItem: 新增 CollapseItemInstance 类型 #9194
- CountDown: 新增 CountDownInstance 类型 #9153
- DatetimePicker: 新增 DatetimePickerInstance 类型 #9208
- DropdownItem: 新增 DropdownItemInstance 类型 #9214
- Field: 新增 FieldInstance 类型 #9166
- Form: 新增 FormInstance 类型 #9139
- ImagePreview: 新增 ImagePreviewInstance 类型 #9216
- IndexBar: 新增 IndexBarInstance 类型 #9246
- List: 新增 ListInstance 类型 #9159
- NoticeBar: 新增 NoticeBarInstance 类型 #9245
- Picker: 新增 PickerInstance 类型 #9183
- Progress: 新增 ProgressInstance 类型 #9247
- Search: 新增 SearchInstance 类型 #9181
- Swipe: 新增 SwipeInstance 类型 #9158
- SwipeCell: 新增 SwipeCellInstance 类型 #9179
- Tabs: 新增 TabsInstance 类型 #9174
- Uploader: 新增 UploaderInstance 类型 #9164
Bug Fixes
- Badge: 修复 offset 为负数时不生效的问题 #9199
- Image: 修复圆角数值不正确的问题 #9163
- Field: 修复 Textarea 内容较多时,输入会导致页面滚动到顶部的问题 #9206
- Notify: 修复默认选项被错误覆盖的问题 #9138
- Rate: 修复星星较多时无法自动换行的问题 #9192
- Tabs: 修复 card 类型内边距错误的问题 #9168
- Toast: 修复某些情况下 message 无法更新的问题 #9196
v3.1.5
2021-07-26
Feature
- AddressEdit: 新增 address-edit-button-font-size 样式变量 #9113
- Icon: 新增 shield-o 图标 #9082
- Locale: 新增 Russian 俄罗斯语言包 #9088
- Toast: 优化不可点击状态下的光标展示 #9116
- Uploader: 新增 click-upload 事件 #9119
- Uploader: 新增 readonly 属性 #9118
Bug Fixes
- Icon: 修复 invitation 图标名称拼写错误 #9096
- NumberKeyboard: 修复点击外部时会触发 close 事件的问题 #9108
- Search: 修复左侧图标颜色不正确的问题 #9100
- Tabbar: 修复 tabbar-item-icon-margin-bottom 样式变量名称 #9101
v3.1.4
2021-07-19
Feature
- ActionSheet: 新增 before-close 属性 #9068
- Cascader: 新增 option 插槽 #9036
- Cascader: 优化光标展示 #9032
- Popup: 新增 before-close 属性 #9067
- ShareSheet: 新增 before-close 属性 #9068
- Tabs: 新增 click-tab 事件 #9037
Bug Fixes
- Field: 修复 label-align 为 right 时 required 标记位置错误的问题 #9035
- List: 修复在 Tabs 内嵌套使用时,切换 Tabs 不触发 load 事件的问题 #9022
- Popup: 修复某些情况下未正确触发 open、close 事件的问题 #9065
v3.1.3
2021-07-11
Feature
- Calendar: 新增 click-subtitle 事件 #8981
- Calendar: 新增 subtitle 插槽 #8980
- ConfigProvider: 新增 icon-prefix 属性 #8986
- Slider: 新增 drag 事件参数 #8990
- Slider: 新增 left-button、right-button 插槽 #8989
- touch-emulator: 支持通过白名单排除节点 #8984
Bug Fixes
- Step: 修复 z-index 过高问题 #9003
v3.1.2
2021-07-03
Feature
- Area: 新增 toolbar、confirm、cancel 插槽 #8969
- Calendar: 优化日期较多时的加载性能 #8955
- Cascader: 新增 disabled 选项 #8952
- ConfigProvider: 新增 tag 属性 #8967
- Picker: 新增 toolbar 插槽,将 default 插槽标记为废弃 #8968
- Picker: 允许 Option 的值为 number 类型 #8951
- Picker: 新增 picker-option-padding CSS 变量 #8947
Bug Fixes
- Toast: 修复文字换行问题 #8965
v3.1.1
2021-06-27
Feature
- Cell: 新增 value 插槽,将 default 插槽标记为废弃 #8933
- CollapseItem: 新增 label 插槽 #8934
- NoticeBar: 新增 reset 方法 #8917
- Tabs: 新增 nav-bottom 插槽 #8915
v3.1.0
2021-06-22
New Component
- 新增 ConfigProvider 组件,用于主题定制 #8854
Feature
- 所有组件支持 CSS 变量 aef257 fe1cba
- 新增 primary-color 等样式变量 #8861
- Checkbox: icon 插槽新增 disabled 参数 #8839
- Cascader: 新增 className 选项 #8882
- Cascader: 新增 color 选项 #8883
- CellGroup: 新增 inset 属性 #8885
- GridItem: 新增 reverse 属性 #8878
- IndexBar: 新增 teleport 属性 #8820
Bug Fixes
v3.0.18
2021-06-03
Feature
- Button: 新增 icon 插槽 #8783
- CouponList: 新增 list-footer、disabled-list-footer 插槽 #8801
- Locale: 新增 French 法语语言包 #8795
- Popup: 新增 icon-prefix 属性 #8793
- Popup: 新增 overlay-content 插槽 #8794
Bug Fixes
- Collapse: 修复在 safari 上可能出现渲染异常的问题 #8788
- NoticeBar: 修复在 Popup 内嵌套使用时播放异常的问题 #8789
- List: 移除未使用的 @list-icon-margin-right 变量 #8759
- @vant/touch-emulator: 修复 SSR 时报错的问题 #8767
v3.0.17
2021-05-23
Feature
- ActionBarIcon: 新增 icon-prefix 属性 #8748
- Calendar: 新增 over-range 事件 #8739
- Calendar: 新增 show-range-prompt 属性 #8739
- Calendar: 新增 top-info、bottom-info 插槽 #8716
- GridItem: 新增 icon-color 属性 #8753
- NoticeBar: 默认 speed 由 50 调整为 60 #8694
- Popover: 新增 icon-prefix 属性 #8703
- Toast: 新增不同类型 Toast 的 transition 过渡效果 #8743
- Uploader: max-size 属性支持函数格式 #8744
Bug Fixes
- Button: 修复 tsx 下使用时缺少 onClick 类型定义的问题 #8665
- Calendar: 修复默认日期不正确的问题 #8696
- DatetimePicker: 修复动态设置 minDate、maxDate 时异常的问题 #8658
- List: 修复在开启 animated 的 Tabs 下使用时加载异常的问题 #8741
- Tabs: 修复滚动事件监听不正确的问题 #8734
- Toast: 修复多次调用时持续时间不正确的问题 #8742
v3.0.16
2021-05-03
Feature
- Swipe: 新增 indicator 插槽的 active 参数 #8645
- Cascader: 新增 @cascader-header-padding less 变量 #8626
- Steps: 新增 icon-prefix 属性 #8631
- 导出更多类型定义 #8652
Bug Fixes
- Stepper: 修复 blur 事件触发时机 #8620
- SubmitBar: 修复 @submit-bar-price-font-size 变量不生效的问题 #8639
- Swipe: 修复在 Popup 内时展示可能不正确的问题 #8643
- Tabs: 修复在 Popup 内时展示可能不正确的问题 #8642
v3.0.15
2021-04-25
Feature
- Cascader: 新增 click-tab 事件 #8606
Bug Fixes
v3.0.14
2021-04-18
Feature
Bug Fixes
- ContactList: 修复 nodes 类型错误 0b764b
v3.0.13
2021-04-11
Feature
- ActionBar: 新增 @action-bar-icon-background-color 样式变量 #8474
- Popover: 升级依赖的 @popperjs/core 到 2.9.2 版本 0d1323
- perf: 优化包体积 ba3e6d
Types
- Popup: 修复 PopupCloseIconPosition 类型错误 15d901
- Search: 修复在 tsx 下部分 props 不存在的问题 #8485
- Stepper: 优化 theme 属性类型定义 #8489
Bug Fixes
- Field: 修复 autofocus 属性不生效的问题 #8488
v3.0.12
2021-04-05
Feature
- CollapseItem: 新增 readonly 属性 #8445
- Field: 新增 clear-icon 属性 #8438
- Search: 新增 clear-icon 属性 #8439
- Search: 新增 error-message 属性 #8442
- Search: 新增 formatter、format-trigger 属性 #8441
Bug Fixes
- 修复 WebStorm 下组件标签提示不正确的问题 #8450
v3.0.11
2021-03-30
Feature
- Cascader: 新增 swipeable 属性 #8383
- Dialog: 新增 footer 插槽 #8382
- Dialog: 支持在 message 中传入 render 函数 #8420
- Image: 新增 icon-size 属性 #8395
- Row: 新增 wrap 属性 #8393
Bug Fixes
- Field: 修复在个别情况下错误地清除错误提示的问题 #8409
- Sticky: 修复在 SSR 时提示 Element 不存在的问题 #8407
- Tabs: 修复在 safari 上左滑退出页面时手势判断错误的问题 #8388
v3.0.10
2021-03-19
Feature
- ActionSheet: 新增 cancel 插槽 #8333
- Badge: 新增 show-zero 属性 #8381
- Cascader: 新增 close-icon 属性 #8334
- Popover: 新增 close-on-click-overlay 属性 #8351
- Popover: 新增 duration 属性 #8355
- Popover: 新增 overlay-class 属性 #8353
- Popover: 新增 overlay-style 属性 #8354
- ShareSheet: 新增 cancel 插槽 #8335
- Sticky: 新增 change event #8374
- Tag: close 事件新增 event 参数 #8337
- Toast: 新增 iconSize 选项 #8338
Feature
- ContactList: 新增 @contact-list-item-radio-icon-color Less 变量 #8322
- Coupon: 新增 @coupon-corner-checkbox-icon-color Less 变量 #8323
- List: 新增 @list-loading-icon-size Less 变量 #8365
- Loading: 新增 @button-loading-icon-size Less 变量 465bf0
- PullRefresh: 新增 @pull-refresh-loading-icon-size Less 变量 #8366
Bug Fixes
v3.0.9
2021-03-08
Feature
- AddressList: 新增 tag 插槽 #8292
Bug Fixes
v3.0.8
2021-03-07
Types
- 完善所有组件的类型定义 #8264
Feature
- ImagePreview: 新增 transition 属性 #8275
- ImagePreview: 新增 overlay-style 属性 #8276
- Locale: 新增 th-TH 泰语 #8297
- PullRefresh: 新增 pull-distance 属性 #8280
- Button: 新增若干个 Less 变量 #8281
Bug Fixes
- ActionSheet: 修复返回页面时可能错误地重新打开的问题 #8272
- Stepper: 修复在 iOS14 下禁用时输入框文字不可见的问题 #8277
- Swipe: 修复动态插入轮播图时渲染错误的问题 #8288
v3.0.7
2021-02-28
Feature
- Notify: 新增 lockScroll 选项 #8168
- Popup: click-overlay 事件新增
Event
参数 #8107 - ShareSheet: 新增 overlay-style 属性 #8225
- ShareSheet: 新增 overlay-class 属性 #8225
- Step: 新增 finish-icon 插槽 #8241
- Steps: 新增 finish-icon 属性 #8103
- Uploader: 新增 @uploader-mask-text-color 样式变量 #8064
perf
- 包体积优化:调整适配的浏览器版本,与 Vue 3 保持一致 #8227
Bug Fixes
- ActionSheet: 修复 safe-area-inset-bottom 属性不生效的问题 #8085
- DateTimePicker: 修复 v-model 为 null 时初始值不正确的问题 #8193
- Form: 修复提交表单时可能滚动到错误的表单项的问题 #8159
- ImagePreview: 修复第二次调用时可能出现渲染不正确的问题 #8060
- IndexBar: 修复初始化时激活的锚点未正确渲染的问题 #8164
- Popup: 修复动态设置 lock-scroll 属性不生效的问题 #8169
- Swipe: 修复初始化时 active 值可能错误的问题 #8061
- SwipeCell: 修复点击外部时 click 事件参数不正确的问题 #8108
- Tabbar: 修复 name 为 0 时激活的选项可能不正确的问题 #8125
- Tabs: 修复 v-model 为 0 时激活的标签页可能不正确的问题 #8074
- Toast: 修复 SSR 时可能报错的问题 #8214
v3.0.6
2021-01-31
Feature
- Area: 支持超过 6 位的地区码 #8001
- Form: show-error 属性的默认值调整为 false #8016
- Form: 支持在 validator 中返回错误提示 #8052
- NumberKeyboard: 新增 blur-on-close 属性 #8033
- Popover: 新增 click-overlay 事件 #8050
- Popover: 支持在 action 选项对象中配置 color 字段 #8049
- Sticky: 新增 position、offset-bottom 属性 #7979
Bug Fixes
- Button: 修复加载状态下会触发表单提交的问题 #8018
- Calendar: 修复无法使用 scrollToDate 方法的问题 #7983
- Empty: 修复 linearGradient id 可能导致冲突的问题 #8013
- Toast: 修复 closeOnClickOverlay 设置为 true 不生效的问题 #8044
v3.0.5
2021-01-24
Feature
- Badge: 新增 offset 属性 e0b463
- Calendar: reset 方法支持重置到指定日期 #7966
- Icons: 新增 wechat 图标, 重命名原 wechat 图标为 wechat-pay b3cd8c
- ImagePreview: 调用 swipeTo 方法后自动重置缩放状态 #7972
- ImagePreview: 调整 swipeDuration 的默认值为 300ms #7970
- ShareSheet: 新增 wechat-moments 朋友圈图标 ca66fb
- Slider: 新增 readonly 属性 4cd991
style
Bug Fixes
- Calendar: 修复调用 reset 方法时未重置到默认日期的问题 #7967
- Dialog: 修复切换 allowHtml 时 message 渲染不正确的问题 #7968
- ImagePreview: 修复 scale 事件的 index 参数为 undefined 的问题 #7971
v3.0.4
2021-01-17
Feature
- Cascader: 新增 field-names 属性,用于自定义字段名 #7933
- Cell: 支持在设置 is-link 时将 clickable 设置为 false 来禁用点击状态 #7923
- DropdownItem: 支持传入数组或对象格式的 title-class #7926
- Popup: 支持传入数组或对象格式的 overlay-class #7924
- Toast: 新增 overlayClass 选项 #7925
- Toast: 新增 overlayStyle 选项 #7898
Bug Fixes
- AddressEdit: 修复无法调用 setAreaCode 方法的问题 6a184f
- Circle: 修复渐变色不生效的问题 #7909
- NumberKeyboard: 修复 delete、extra-key 插槽不生效的问题 52a0e5
- Search: 修复控制台存在 update:modelValue warning 的问题 #7872
- Swipe: 修复页面隐藏时未暂停自动轮播的问题 1c428f
v3.0.3
2021-01-10
Feature
- Field: 新增 autocomplate 属性 #7877
Bug Fixes
- Area: 修复无法调用 getValues 方法的问题 03c7b4
- ImagePreview: 修复 close-on-popstate 属性不生效的问题 #7880
- List: 修复更新 error 属性后未触发位置检查的问题 b79c32
v3.0.2
2021-01-02
Feature
- Calendar: 新增 scrollToDate 方法 #7847
- Form: 新增 disabled 属性 #7830
- Form: 新增 readonly 属性 #7830
- Loading: 新增 text-color 属性 #7806
- Picker: 新增 columns-field-names 属性 #7791
- NumberKeyboard: 新增 random-key-order 属性 #7841
Bug Fixes
- Calendar: 修复 title 插槽不生效的问题 #7826
- Calendar: 修复动态设置 defaultDate 不生效的问题 #7815
- Popup: 修复组件销毁时未解除滚动锁定的问题 #7835
- Stepper: 修复动态设置 modelValue 时未格式化的问题 81494d
v3.0.1
2020-12-27
Feature
- Form: valdiate 方法支持校验多个表单项 #7810
- Form: resetValidation 方法支持重置多个表单项 #7811
- Stepper: 新增 show-input 属性,用于控制是否显示输入框 #7812
- IndexBar: 新增 scrollTo 方法 #7794
Bug Fixes
- Cascader: 修复动画闪烁的问题 #7802
- CountDown: 修复 SSR 过程中内存泄露的问题 #7808
- Image: 修复 SSR 时提示 DOM 不匹配的问题 #7822
- Popup: 修复滚动穿透的问题 #7738
- Stepper: 修复 change 事件重复触发的问题 #7820
- Swipe: 修复 SSR 样式不正确的问题 #7821
- Swipe: 修复在 keepalive 标签内使用时显示不正确的问题 #7772
v3.0.0
2020-12-23
更新内容
v3.0.0-rc.4
2020-12-21
New Component
- 新增 Cascader 级联选择组件 #7771
Feature
- Stepper: 新增 show-input 属性 #7785
- uploader: 支持在 fileList 的选项中单独配置
imageFit
deletable
previewSize
beforeDelete
字段 #7731
Types
- Lazyload: 修复类型定义错误 #7757
v3.0.0-rc.3
2020-12-10
Breaking Change
- Stepper:
async-change
属性重命名为before-change
,并调整使用方法 e026d2
perf
- Stepper: 优化代码包体积 #7675
Bug Fixes
v3.0.0-rc.2
2020-12-04
perf
- 优化包体积大小 #7675
Bug Fixes
- Lazyload: 修复未导出 ESModule 的问题 #7685
- NumberKeyboard: 修复 hide-on-click-outside 属性不生效的问题 #7668 #7667
- Uploader: 修复动态修改 status 不生效的问题 #7681
- Types: 修复 teleport 类型定义错误的问题 #7687
- 包含
v2.11.2
版本的所有改动和修复
v3.0.0-rc.1
2020-12-01
Breaking Change
- Popover: trigger 属性的默认值调整为 click 1699d9
Feature
- Lazyload: 适配 Vue 3 d3ca40
- 包含
v2.11.1
版本的所有改动和修复
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
- Image: 修复 lazy-load 属性不生效的问题 0ba818
- Lazyload: 修复类型定义错误的问题 d0c4c2
- Popup: 修复 transition-appear 属性不生效的问题 dd6930
v3.0.0-beta.10
2020-11-22
Bug Fixes
- Radio: 修复 Radio 无法操作的问题 0f7c9a
v3.0.0-beta.9
2020-11-22
New Component
- 新增 Popover 气泡弹出框组件 #7579
Feature
Bug Fixes
v3.0.0-beta.8
2020-11-15
Bug Fixes
- ActionSheet: 修复选项禁用或加载时仍能点击的问题 996598
- ActionSheet: 修复 callback 选项不生效的问题 27b761
- Calendar: 修复 default-date 为 null 时渲染失败的问题 #7519
- DatetimePicker: 修复 DOM 上渲染多余属性的问题 ed332d
- NoticeBar: 修复初始化逻辑执行多次的问题 0712d9
- Swipe: 修复在 lazy-render 模式下渲染失败的问题 e06ba4
- Swipe: 修复初始化逻辑执行多次的问题 c94173
- Tabs: 修复初始化逻辑执行多次的问题 599e81
- 包含
v2.10.14
版本的所有改动和修复
v3.0.0-beta.7
2020-11-08
Bug Fixes
- Calendar: 修复动态设置 minDate 和 maxDate 时展示错误的问题 #7412
- DropdownMenu: 修复无法禁用 closeOnClickOutside 属性的问题 #7473
- Uploader: 修复在 before-read 返回 true 无效的问题 #7493
- Uploader: 修复在 delete 事件中无法获取 index 的问题 #7481
- 包含
v2.10.13
版本的所有改动和修复
v3.0.0-beta.6
2020-11-01
Bug Fixes
- Swipe: 修复开启 lazy-render 且 loop 为 false 时渲染节点不正确的问题 #7465
- Swipe: 修复开启 lazy-render 时子节点被重复挂载的问题 #7466
- Tabs: 修复初始动画错误的问题 49e877
- ActionBar: 修复类型定义不存在的问题 #7440 #7442
- 包含
v2.10.12
版本的所有改动和修复
v3.0.0-beta.5
2020-10-24
Bug Fixes
- Swipe: 修复动态插入轮播时无法滚动的问题 #7366
- Toast: 修复 forbidClick 属性不生效的问题 #7396
- Toast: 修复 duration 变化未生效的问题 #7394
- 包含
v2.10.11
版本的所有改动和修复
v3.0.0-beta.4
2020-10-18
refactor
- Layout: 默认使用 flex 布局,移除 type 属性 f7a120
style
- Stepper: 布局方式调整为 inline-block e9c282
Bug Fixes
- ContactList: 修复 select 事件重复触发的问题 1dd408
- Search: 修复布局错误的问题 9cd48e
- Image: 修复图片加载错误时仍会渲染图片节点的问题 59fb1d
- Pagination: 修复 change 事件触发时机错误的问题 346035
- Toast: 修复展示时会锁定滚动的问题 a622ca
- 包含
v2.10.10
版本的所有改动和修复
v3.0.0-beta.3
2020-10-03
breaking changes
- Checkbox: 在 Cell 内部使用时,现在需要手动添加
@click.stop
来阻止事件冒泡 #7023
Feature
v3.0.0-beta.2
2020-09-28
Bug Fixes
- 修复引入 Vant 时提示 ‘global is not defined’ 的问题 7007fc
v3.0.0-beta.1
2020-09-28
breaking changes
- DatetimePicker: change 事件的第一个参数调整为当前选中值 058665
refactor
使用 Composition API 重构以下组件:
- AddressEdit 749e4a
- Calendar fc50e2
- Checkbox 278ea6
- ContactEdit 4f0921
- DatetimePicker 638842
- Field 00dbf2
- Form 92aac9
- Radio aafbcf
- Tabs 882e3e
Feature
Bug Fixes
v3.0.0-beta.0
2020-09-18
breaking changes
refactor
使用 Composition API 重构以下组件:
Bug Fixes
- AddressEdit: 修复 emits 未声明导致 warning 的问题 1e6a12
- AddressEdit: 修复点击省市区弹窗的蒙层时无法关闭的问题 02e89a
- Field: 修复在 iOS 上中文输入过程中触发 input 事件的问题 #7035
- 包含
v2.10.7
版本的所有改动和修复
v3.0.0-alpha.5
2020-09-13
breaking changes
- Button: native-type 属性的默认值调整为 button df8059
refactor
使用 Composition API 重构以下组件:
- DatetimePicker 60e087
- DropdownItem cd5f5b
- Grid 38740b
- IndexBar f94c8c
- NumberKeyboard 14c1d4
- PullRefresh 9f632f
- Stepper a7c285
- SwipeCell b17c67
Feature
- Button: 新增 icon-position 属性 #7174
- slider: 新增 range 属性,支持范围选择 #7175
- TabbarItem: 新增 @tabbar-item-active-background-color 变量 #7162
Bug Fixes
- Sticky: 修复组件销毁时报错的问题 #7169
v3.0.0-alpha.4
2020-09-06
breaking changes
- Dialog:
before-close
属性用法调整,不再传入 done 函数,而是通过返回 Promise 来控制 - SwipeCell:
before-close
属性不再传入组件实例 - ImagePreview: 移除
async-close
属性,新增before-close
属性
refactor
使用 Composition API 重构以下组件:
Bug Fixes
v3.0.0-alpha.3
2020-09-01
Feature
Types
Bug Fixes
v3.0.0-alpha.2
2020-08-28
Bug Fixes
- 修复使用
yarn add vant@next
安装失败的问题
v3.0.0-alpha.1
2020-08-28
refactor
使用 Composition API 重构以下组件:
- ActionBar
- AddressList
- Area
- Badge
- Button
- Circle
- Col
- Collapse
- CountDown
- Image
- Row
- List
- Loading
- NavBar
- NoticeBar
- Progress
- Rate
- Sidebar
- Slider
- Steps
- Sticky
- Tabbar
Bug Fixes
- Rate: 修复控制台报 emit warning 提示的问题 c32fba
- Button: 修复 click 事件参数丢失的问题 cea272
- CellGroup: 修复 attrs 继承错误的问题 8f978a
- Dialog: 修复部分弹窗相关属性不生效的问题 af94c9
- Image: 修复 loading 图标和 error 图标不展示的问题 c720ee
v3.0.0-alpha.0
2020-08-22
主要改动
- 完成 Vue 3 适配
- 调整部分组件的 v-model 和 prop.sync 用法,以适配 v-model 语法变更
- 调整部分组件的 prop 和 event 用法
- 重命名所有组件的 info 属性为 badge
- 重命名所有组件的 get-container 属性为 teleport
- 废弃 SwitchCell 组件
- 废弃个别 API
已知问题
- Lazyload、Panel 和 Sku 组件暂未完成 Vue 3 适配
详细改动请参考 从 v2 升级。