vant/docs/markdown/changelog-v3.zh-CN.md

更新日志

提示

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

介绍

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

发布节奏

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

v3.0.0-alpha.0

TODO

不兼容更新

v-model API 变更

以下改动是为了适配 Vue 3 的 v-model API 用法变更：

• Tabs: v-model 重命名为 v-model:active
• Popup: v-model 重命名为 v-model:show
• Circle: v-model 重命名为 v-model:currentRate
• Dialog: v-model 重命名为 v-model:show
• ShareSheet: v-model 重命名为 v-model:show
• ActionSheet: v-model 重命名为 v-model:show
• List: v-model 重命名为 v-model:loading，error.sync 重命名为 v-model:error
• Field: v-model 对应的属性 value 重命名为 modelValue，事件由 input 重命名为 update:modelValue
• Switch: v-model 对应的属性 value 重命名为 modelValue，事件由 input 重命名为 update:modelValue
• Sidebar: v-model 对应的属性 activeKey 重命名为 modelValue，事件由 input 重命名为 update:modelValue
• TreeSelect: active-id.sync 重命名为 v-model:active-id
• TreeSelect: main-active-index.sync 重命名为 v-model:main-active-index

API 命名调整

以下改动是为了规范 API 命名：

• SwipeCell: open 事件的 detail 参数重命名为 name
• SwipeCell: on-close 属性重命名为 before-close，并调整参数结构
• Toast: mask 属性重命名为 overlay
• TreeSelect: navclick 事件重命名为 click-nav
• TreeSelect: itemclick 事件重命名为 click-item

重命名徽标属性

在之前的版本中，我们通过 info 属性来展示图标右上角的徽标信息，为了更符合社区的命名习惯，我们将这个属性重命名为 badge，影响以下组件：

• Tab
• Icon
• GridItem
• TreeSelect
• TabbarItem
• SidebarItem
• GoodsActionIcon

同时内部使用的 Info 组件也会重命名为 Badge。

废弃组件

• SwitchCell: 移除此组件，可以直接使用 Cell 和 Switch 组件代替