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 用法变更，所有提供 v-model 属性的组件在用法上有一定调整。

以下组件的 v-model 被重命名为 v-model:show：

• ActionSheet
• Calendar
• Dialog
• Popup
• ShareSheet

<!-- before -->
<van-popup v-model="show" />
<!-- after -->
<van-popup v-model:show="show" />

以下组件 v-model 对应的 prop 重命名为 modelValue，event 重命名为 update:modelValue：

• Checkbox
• CheckboxGroup
• DatetimePicker
• Field
• Radio
• RadioGroup
• Search
• Stepper
• Switch
• Sidebar
• Uploader

<!-- before -->
<van-field :value="value" @input="onInput" />
<!-- after -->
<van-field :model-value="value" @update:model-value="onInput" />

其他改动：

• Circle: v-model 重命名为 v-model:currentRate
• List: v-model 重命名为 v-model:loading，error.sync 重命名为 v-model:error
• Tabs: v-model 重命名为 v-model:active
• 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 组件代替