提示
当前文档为 Vant 4 的更新日志，其他版本请参考：
介绍
Vant 遵循 Semver语义化版本规范。
发布节奏
- 修订号：每周发布，包含新特性和问题修复。
- 次版本号：每隔一至二个月发布，包含新特性和较大的功能更新，向下兼容。
- 主版本号：无固定的发布时间，包含不兼容更新和重大功能更新。
更新内容
v4.0.2
2022-12-03
Bug Fixes
- Field: 修复使用 formatter 时光标位置错误的问题 #11348
- Image: 修复在 Nuxt 3 下图片可能无法展示的问题 128972
- NavBar: 修复屏幕旋转时 placeholder 未自动适配高度的问题 #11351
v4.0.1
2022-12-01
Feature
- Picker: 新增 selectedIndexes 作为事件入参 #11329
Bug Fixes
- Field: 修复未选中时修改绑定的值会导致键盘弹出的问题 #11333
v4.0.0
2022-11-26
完整内容请移步：「4.0 更新介绍」
Feature
- List: 新增 disabled 属性 #11307
- BackTop: 支持动态设置 target 属性 #11311
- BackTop: 支持通过 CSS 变量修改组件位置 #11312
- BackTop: 重命名 visibility-height 属性为 offset #11309
Bug Fixes
- Field: 修复格式化值后，光标位置错误的问题 #11308
v4.0.0-rc.9
2022-11-24
Bug Fixes
- Cell: 修复 arrow-direction 设置为 right 不显示的问题 #11279
- Style: 修复 body 标签上的 normalize 样式未生效的问题 #11287
v4.0.0-rc.8
2022-11-20
Feature
- 新增 BackTop 回到顶部组件，注意该新组件的 API 尚未稳定，在 4.0 正式版发布前仍可能产生 breaking change #11236
Bug Fixes
- DropdownItem: 修复使用 teleport 时无法设置 attr 的问题 #11273
- List: 修复初始的 loading 值为 true 时加载错误的问题 #11275
- NumberKeyboard: 修复使用 teleport 时无法设置 attr 的问题 #11274
v4.0.0-rc.7
2022-11-13
New Component
- 新增 SkeletonAvatar、SkeletonTitle、SkeletonImage、SkeletonParagraph 组件 #11173
Feature
- ImagePreview: 新增 long-press 事件 #11252
- Popover: 支持非受控模式 #11244
Bug Fixes
- ActionSheet: 修复标题为空时取消按钮层级错误的问题 #11213
- DatePicker: 在生产环境下不再抛出开发错误提示 #11248
- Lazyload: 修复使用 lazy-image 时报错 h is not a function 的问题 #11229
- Picker: 修复抛出 confirm 事件时 v-model 未正确更新的问题 #11194
- Picker: 修复 column 为空时操作报错的问题 #11249
- Uploader: 修复 show-upload 为 false 时 chooseFile 无法调用的问题 #11218
v4.0.0-rc.6
2022-10-23
Feature
- Calendar: subtitle 插槽新增 text 和 date 入参 #11168
- Cell: 新增 tag 属性 #11139
- ImagePreview: 新增 image 插槽 #11133
- Toast: 新增 wordBreak 选项 #11147
Bug Fixes
- CouponList: 修复 coupon 位置错误的问题 #11153
- CouponList: 修复输入框样式错误的问题 #11155
- Swipe: 修复在 Popup 内时个别情况下渲染错误的问题 #11162
v4.0.0-rc.5
2022-10-07
Feature
- Field: 支持将 label-position 设置为 top #11102
- Loading: 新增 icon 插槽 #11109
- NavBar: 新增 clickable 属性 #11048
- Stepper: 新增 auto-fixed 属性 #11071
Bug Fixes
- DatePicker: 修复日期超出 maxDate 时格式化不正确的问题 #11122
- Tabs: 修复开启 scrollspy 时个别情况下标题栏滚动位置错误的问题 #11116
- Tabs: 修复开启 scrollspy 时 nav-bottom 插槽遮挡内容的问题 #11115
v4.0.0-rc.4
2022-09-25
Feature
- Field: end-validate 事件新增 message 参数 #11080
Bug Fixes
- Tabs: 修复个别情况下页面滚动位置错误的问题 #11085
- Tabs: 修复初始化时菜单横向滚动位置错误的问题 #11059
v4.0.0-rc.3
2022-09-12
Feature
- ConfigProvider: 新增 ConfigProviderThemeVars 类型 #11034
- Notify: 新增 z-index 属性 #11032
- 移除
@popperjs/core 依赖，减少安装体积 1.6MB #11030
Types
- Toast: 修复缺少全局类型定义的问题 #11033
v4.0.0-rc.2
2022-09-11
Breaking Changes
- 调整了所有 CSS 变量的挂载位置，由
body 节点调整回 :root 节点，调整后与 Vant v3 版本保持一致，以便于 v3 项目更平滑地升级到 v4 版本。 #11026
Bug Fixes
- Dialog: 修复过渡动画异常的问题 #11028
- Empty: 修复深色模式下亮度过高的问题 #11027
v4.0.0-rc.1
2022-09-10
Feature
- 导出所有组件的 props，方便进行二次封装 #11024
- Dialog: message-align 属性支持设置为 justify #11014
- Image: 新增 block 属性 #11022
- Toast: 新增 message 插槽 #11018
Bug Fixes
- Picker: 修复部分情况下未正确更新选中值的问题 #11009
- Locale: 修复读取 i18n 文案时可能获取到 JS 原生方法的问题 #11010
v4.0.0-rc.0
2022-09-04
Feature
Bug Fixes
- DatePicker: 修复未正确更新 modelValue 的问题 #10984
- DatePicker: 修复 min-date 属性未正确生效的问题 #10985
v4.0.0-beta.1
2022-08-24
Breaking Changes
- Popup: 默认添加了
box-sizing: border-box 样式。 - Popup: 调整了
position="center" 时的水平居中方式，以解决弹窗宽度无法正确自适应的问题。
// Vant 3
.van-popup--center {
left: 50%;
transform: translate3d(-50%, -50%, 0);
}
// Vant 4
.van-popup--center {
left: 0;
right: 0;
width: fit-content;
max-width: calc(100vw - var(--van-padding-md) * 2);
margin: 0 auto;
transform: translateY(-50%);
}
New Component
- 新增 Space 间距组件, 由 @LadyChatterleyLover 贡献 #10857
Feature
- ConfigProvider: 新增 z-index 属性，用于设置弹窗组件的 z-index #10915
- Form: 新增 rule 的 validateEmpty 选项 #10913
- Popup: 新增 role 和 tabindex，优化无障碍访问 #10894
- TouchEmulator: 支持 .mjs 后缀 #10888
Feature
- ConfigProvider: 新增 theme-vars-dark 和 theme-vars-light 属性 #10939
- Picker: 新增 clickOption 事件 #10865
- 为 scroll 事件添加了正确的 passive 标记来提升滚动性能 #10951
- @vant/use: 优化 useEventListener 类型定义 #10952
Bug Fixes
- ConfigProvider: 修复销毁时没有回收全局样式类的问题 #10898
- 修复 touchstart 导致控制台出现 passive event warning 的问题 #10954
- Tabs: 修复开启 swipeable 时，resize 方法无法正确生效的问题 #10964
- 修复在 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
v4.0.0-beta.0
2022-07-16
Breaking Changes
- Toast: 重新设计函数调用 API #10804
- Dialog: 重新设计函数调用 API #10781
- Notify: 重新设计函数调用 API#10782
- ImagePreview: 重新设计函数调用 API #10802
关于以上改动的详细描述和迁移方法，请参考 从 v3 升级到 v4的 「API 调整」部分。
Feature
- 新增 @vant/compat 包，用于辅助代码迁移 #10806
- Calendar: 新增 getSelectedDate 方法 419a8e
- 由于主题定制方式调整，发布到 npm 的代码中将不再包含 .less 样式源文件，从而减少 npm 包体积 #10752
Bug Fixes
- Uploader: 修复预览图片时会展示上传失败的图片的问题 #10790
v4.0.0-alpha.4
2022-05-31
Feature
- 适配 nuxt 3，现在 dist 目录下所有 esmodule 文件将使用
.mjs 文件后缀 #10625
v4.0.0-alpha.3
2022-05-02
Feature
- Form: 支持同时设置多个 validate-trigger 值 #10544
- Empty: 支持在无网络的环境下离线使用，图片从 CDN 调整为内联的 SVG 图片 #10514 #10515 #10516
- Loading: 优化无障碍访问 #10568
Bug Fixes
- Search: 修复暗色模式下样式错误的问题 #10527
- @vant/area-data: 修复发布到 npm 时包含 tsconfig.json 文件导致编译错误的问题 f927f6
v4.0.0-alpha.2
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
- DatetimePicker: 修复 modeValue 与选中的数据不一致的问题 #10448
- Rate: 修复多行时滑动选中不正确的问题 #10500
v4.0.0-alpha.1
2022-03-19
Feature
- @vant/area-data: 新增南京市江北新区 #10410
- Locale: 新增老挝语 #10388
Bug Fixes
- Calendar: 修复暗色模式下标题颜色 #10403
- Picker: 修复暗色模式下标题颜色 #10403
- ConfigProvider: 修复默认设置暗色模式不生效的问题 #10413
- DatePicker: 修复更新 v-model 不生效的问题 #10415
- Dialog: 修复暗色模式下标题和文本颜色 #10379
- IndexBar: 修复底部索引无法高亮的问题 #10404
4.0.0-alpha.0
2022-02-21
不兼容更新
参见 从 v3 升级到 v4。
Feature
- ConfigProvider: 新增
theme 属性，用于开启深色模式 - ConfigProvider: 新增
ConfigProviderTheme 类型
Style
在之前的版本中，Vant 组件有两种色彩风格，一部分采用红色作为主色调，另一部分采用蓝色。为了保持色彩规范的统一，我们在 Vant 4 中对组件的主色调进行了统一，所有组件均采用蓝色作为主色调。
以下组件的默认色值风格由红色调整为蓝色：
- AddressEdit
- AddressList
- Card
- Calendar
- Cascader
- ContactList
- ContactEdit
- CouponList
- Dialog
- DropdownMenu
- IndexBar
- Sidebar
- Steps
- Tabs
- TreeSelect
其他：
-
--van-font-bold 的默认值由 500 调整为 600 - ActionBar: 调整
--van-action-bar-icon-text-color 变量的默认值为 --van-text-color - AddressList: 重命名
--van-address-list-item-radio-icon-color 为 --van-address-list-radio-color - Button: 默认圆角大小从
2px 调整为 4px - Button: 默认按钮的边框颜色调整为
--van-gray-4 - Button: 调整
font-smoothing，默认使用粗体文字 - Cell: 只设置
value 时，内容不再会靠左对齐 - Card: 调整
--van-card-background 变量的默认值为 --van-background - Card: 调整
--van-card-price-color 变量的默认值为 --van-text-color - Card: 调整
--van-card-desc-color 变量的默认值为 --van-text-color-2 - ContactList: 重命名
--van-contact-list-item-radio-icon-color 为 --van-contact-list-radio-color - CouponList: 重命名
--van-coupon-corner-checkbox-icon-color 为 --van-coupon-checkbox-color - Field: 调整
--van-field-label-color 变量的默认值为 --van-text-color - Switch: 移除
--van-switch-border 变量 - Switch: 调整
--van-switch-size 变量的默认值为 26px - Switch: 调整
--van-switch-background 变量的默认值为 rgba(120, 120, 128, 0.16) - Tabbar: 调整
--van-tabbar-item-text-color 变量的默认值为 --van-text-color - GridItem: 调整
--van-grid-item-text-color 变量的默认值为 --van-text-color