更新日志

提示

当前文档为 Vant 3.x 版本的更新日志,如需查询 Vant 2.x 的更新内容,请访问 Vant 2.x 更新日志

介绍

Vant 遵循 Semver 语义化版本规范。

发布节奏

  • 修订号:每周发布,包含新特性和问题修复。
  • 次版本号:每隔一至二个月发布,包含新特性和较大的功能更新,向下兼容。
  • 主版本号:发布时间不定,包含不兼容更新。

更新内容

v3.0.0

2020-12-23

更新内容

请参考 Vant 3.0 正式发布:全面拥抱 Vue 3

v3.0.0-rc.4

2020-12-21

New Component

  • 新增 Cascader 级联选择组件 #7771

更新日志 - 图1

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

  • Stepper: 修复禁用按钮仍然能点击的问题 c27760
  • Tabs: 修复动态设置 active 值无效的问题 #7717
  • 包含 v2.11.3 版本的所有改动和修复

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

更新日志 - 图2

Feature

  • Search: 新增 blur 方法 d26282
  • Search: 新增 focus 方法 2833bc

Bug Fixes

  • Checkbox: 修复 bind-group 属性不生效的问题 #7447
  • Badge: 修复无类型定义的问题 c487b3
  • 包含 v2.11.0 版本的所有改动和修复

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

  • 新增 Badge 徽标组件 #6573
  • Tab: 增加滑动切换动画 #1174
  • 包含 v2.10.9 版本的所有改动和修复

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 重构以下组件:

Feature

  • Locale: 新增德语语言包 #7245
  • Pagination: 新增多个插槽 #7222

Bug Fixes

  • Picker: 修复 setIndex 方法无效的问题 d2a542
  • Dialog: 修复最小高度错误的问题 bf1f0f
  • 包含 v2.10.8 版本的所有改动和修复

v3.0.0-beta.0

2020-09-18

breaking changes

  • Dialog: allow-html 属性的默认值调整为 false 02c7a7
  • Picker: allow-html 属性的默认值调整为 false 02c7a7

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 重构以下组件:

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

  • Tag: 修复 color 属性不生效的问题 4b6da2
  • 修复在 TSX 中使用组件时提示类型错误的问题 #7076
  • 修复全量引入组件时提示类型错误的问题 #7056

v3.0.0-alpha.3

2020-09-01

Feature

  • ActionSheet: 新增 description 插槽 #7068
  • Toast: 使用 composition api 重构 44aaa4

Types

  • 修复使用 app.use 注册组件时提示类型错误的问题 #7056
  • 修复 $toast、$dialog 类型不存在的问题 0acbc6

Bug Fixes

  • Dialog: 修复 Dialog.close 不生效的问题 476e16
  • Toast: 修复设置 toast.message 不生效的问题 dac7fe

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 升级

更新日志 - 图3