Vant4 更新日志

2023-02-16 17:54 更新

提示

当前文档为 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

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


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号