docs(Area): update documents

This commit is contained in:
chenjiahan
2022-01-21 16:52:32 +08:00
committed by neverland
parent 0186219586
commit a9baa3b2d1
4 changed files with 63 additions and 83 deletions
@@ -13,17 +13,35 @@
- columns 数据格式定义不合理,容易产生误解
- 数据流不清晰,暴露了过多的实例方法来对数据进行操作
为了解决上述问题,我们在 v4 版本中对 Picker 组件进行了重构(同时也影响 Area 和 DatetimePicker 组件)
为了解决上述问题,我们在 v4 版本中对 Picker 组件进行了重构。
#### 主要变更
- 支持通过 `v-model` 绑定当前选中的值,移除 `default-index` 属性
- 重新定义了 `columns` 属性的结构
- 移除了所有操作内部数据的实例方法
- 移除了操作内部数据的实例方法,仅保留 `confirm` 方法
- 调整了 `confirm``cancel``change` 事件的参数
- 重命名 `item-height` 属性为 `option-height`
- 重命名 `visible-item-count` 属性为 `visible-option-num`
详细用法请参见 [Picker 组件文档](#/zh-CN/picker)。
### Area 组件重构
Area 组件是基于 Picker 组件进行封装的,因此本次升级也对 Area 组件进行了内部逻辑的重构,并优化了部分 API 设计。
#### 主要变更
- 支持通过 `v-model` 绑定当前选中的值
- 移除 `reset` 方法,现在可以通过修改 `v-model` 来进行重置
- 移除 `is-oversea-code` 属性
- 调整所有事件的参数,与 Picker 组件保持一致
- 重命名 `value` 属性我 `modelValue`
- 重命名 `item-height` 属性为 `option-height`
- 重命名 `visible-item-count` 属性为 `visible-option-num`
详细用法请参见 [Area 组件文档](#/zh-CN/area)。
### 其他 API 调整
4.0 版本中,以下 API 进行了不兼容更新: