mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-08-16 09:09:45 +08:00
68 lines
2.4 KiB
Markdown
68 lines
2.4 KiB
Markdown
# 更新日志
|
||
|
||
### 提示
|
||
|
||
当前文档为 Vant 3.x 版本的更新日志，如需查询 Vant 2.0 的更新内容，请访问 [Vant 2.0 更新日志](https://youzan.github.io/vant/#/zh-CN/changelog)。
|
||
|
||
### 介绍
|
||
|
||
Vant 遵循 [Semver](https://semver.org/lang/zh-CN/) 语义化版本规范。
|
||
|
||
**发布节奏**
|
||
|
||
- 修订号：每周发布，包含新特性和问题修复。
|
||
- 次版本号：每隔一至二个月发布，包含新特性和较大的功能更新，向下兼容。
|
||
- 主版本号：发布时间不定，包含不兼容更新。
|
||
|
||
### v3.0.0-alpha.0
|
||
|
||
`TODO`
|
||
|
||
#### 不兼容更新
|
||
|
||
##### v-model API 变更
|
||
|
||
以下改动是为了适配 Vue 3 的 v-model API 用法变更：
|
||
|
||
- ActionSheet: `v-model` 重命名为 `v-model:show`
|
||
- Calendar: `v-model` 重命名为 `v-model:show`
|
||
- Circle: `v-model` 重命名为 `v-model:currentRate`
|
||
- Dialog: `v-model` 重命名为 `v-model:show`
|
||
- Field: v-model 对应的属性 `value` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
|
||
- List: `v-model` 重命名为 `v-model:loading`，`error.sync` 重命名为 `v-model:error`
|
||
- Popup: `v-model` 重命名为 `v-model:show`
|
||
- Sidebar: v-model 对应的属性 `activeKey` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
|
||
- ShareSheet: `v-model` 重命名为 `v-model:show`
|
||
- Switch: v-model 对应的属性 `value` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
|
||
- 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 组件代替
|