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

更新日志

v2.1.1

2019-08-02

Bug Fixes

• 修复 DatetimePicker 事件无法触发的问题 #4027
• 修复 Popup 设置 z-index 顺序错误的问题 #4026

v2.1.0 [已废弃]

2019-08-01 🇨🇳

Improvements

• Sku: UI 升级，采用更圆润的视觉风格 #3875 #3922
• GoodsAction: UI 升级，采用更圆润的视觉风格 #3967
• Sku: 新增 price-tag 属性 #3875
• Sku: 新增 hide-selected-text 属性 #3875
• Sku: 新增 sku-header-origin-price 插槽 #3958
• Dialog: 新增 title 插槽 #3985
• Dialog: 优化垂直居中位置 #3905
• Uploader: 新增多个 less 变量 #3907
• ActionSheet: 新增多个 less 变量 #3908
• AddressList: 新增 click-item 事件 #3942
• CouponList: 新增 empty-image 属性 #3941
• ImagePreview: 新增 swipe-duration 属性 #3963
• SwipeCell: 新增 stop-propagation 属性 #3952

Bug Fixes

• 修复 Tabs 在特定情况下出现下划线位置错误的问题 #3961
• 修复 AddressList 点击空白区域时无法选中的问题 #3909
• 修复 IndexBar 在 index-list 变化时未更新高亮选项的问题 #3943
• 修复 ImagePreview 图片较长时遮挡索引的问题 #4002
• 修复 ImagePreview onClose 和 onChange 选项未被重置的问题 #3960
• 修复 Radio 和 Checkbox 点击中间空白区域时无法选中的问题 #4007
• 修复 SwipeCell 在打开的情况下阻止事件冒泡的问题 #3982
• 修复 Tabs 在 sticky 模式下滚动回到顶部时存在 1 像素偏差的问题 #3949
• 修复 DatetimePicker 使用 formatter 且为 time 类型时 confirm 事件参数错误的问题 #3969

v2.0.9

2019-07-19

Improvements

• 新增 Sticky 粘性布局组件 #3888
• Grid: 优化文字换行 #3897
• Toast: 优化图片图标展示 #3895
• Image: 新增 round 属性 #3838
• Image: 新增 show-error 属性 #3896
• Image: 新增 show-loading 属性 #3893
• Toast: 新增 iconPrefix 选项 #3872
• Uploader: 支持预览网络图片 #3899
• ActionSheet: 新增 round 属性 #3874
• TreeSelect: 新增 click-nav、click-item 事件 #3892

Bug Fixes

• 修复 SwipeCell 与 Swipe 嵌套时无法使用的问题 #3898
• 修复 Dialog closeOnPopstate 无法被禁用的问题 #3868
• 修复 DropdownMenu toggle 方法无法打开菜单的问题 #3876

v2.0.8

2019-07-16

Improvements

• Sku: 支持自定义留言占位文本 #3864
• DropdownMenu: 新增 icon 选项 #3855
• DropdownMenu: 标题过长时自动截断 #3847
• ImagePreview: 支持双击缩放手势 #3839

Bug Fixes

• 修复 Tab 点击事件参数丢失的问题 #3866
• 修复 List 在 body 标签添加滚动样式时异常的问题 #3844
• 修复 IndexBar 在某些情况下 active 锚点失效的问题 #3832

v2.0.7

2019-07-11

Improvements

• 新增 CountDown 倒计时组件 #3805
• Popup: 新增 round 属性 #3781
• IndexBar: 新增 sticky-offset-top 属性 #3791
• PullRefresh: 新增 distance 插槽参数 #3829
• Swipe: swipeTo 方法新增 immediate 参数 #3821
• Slider: bar-height 属性支持 number 类型 #3794
• DropdownMenu: 新增 close-on-click-outside 属性 #3824

Bug Fixes

• 修复 Popup 蒙层在某些情况下遮挡元素的问题 #3831
• 修复 Stepper 在 iOS 12 下滚动位置错误的问题 #3804
• 修复 Dialog closeOnPopstate 方法缺少类型定义的问题 #3789
• 修复 DatetimePicker 使用 filter 属性且为 time 类型时 confirm 事件参数错误的问题 #3816

v2.0.6

2019-07-05

Improvements

• 新增 Divider 分割线组件 #3755
• Tab: 新增 name 属性 #3762
• Sku: 新增 add-cart-text 属性 #3725

Bug Fixes

• 修复 Grid gutter 属性不能传入 String 类型的问题 #3741
• 修复 Swipe 使用 width 属性后出现空白区域的问题 #3751
• 修复 PullRefresh 同步修改 loading 时状态错误的问题 #3719
• 修复 Collapse 在 safari 浏览器上渲染内容较多时高度错误的问题 #3723

v2.0.5

2019-07-02

Improvements

• Stepper: 支持长按手势 #3711
• Stepper: 新增 button-size 属性 #3714
• Dialog: 新增 close-on-popstate 属性 #3709

Bug Fixes

• 修复 postcss 配置对 vant 不生效的问题

v2.0.4 🇨🇳

2019-07-01

Improvements

• 新增 Grid、GridItem 组件 #3669 #3682 #3683
• Field: 新增 arrow-direction 属性 #3679
• Sidebar: 新增 to、replace 属性 #3696
• Sidebar: 支持通过 v-model 绑定当前项索引 #3698
• IndexBar: 新增选中状态的类名，用于定制样式 #3692
• Uploader: 支持 Number 类型的 name 属性 #3681
• SwipeCell: 新增 name 属性 #3680
• AddressEdit: 新增 detail-maxlength 属性 #3707
• GoodsActionIcon: 新增 icon 插槽 #3705

Bug Fixes

• 修复 Collapse 在 safari 浏览器上动画可能闪烁的问题 #3686
• 修复 Picker 在低版本 Android 机器上的兼容性问题 #3688

v2.0.3

2019-06-27

Improvements

• ActionSheet: 新增 duration 属性 #3608
• ActionSheet: 新增 open、opened 事件 #3639
• ActionSheet: 新增 close、closed 事件 #3639
• ImagePreview: 新增 onChange 选项 #3630
• Popup: 优化蒙层动画时长 #3610
• Uploader: 支持点击查看大图 #3603
• Uploader: 支持预览非图片文件 #3604
• Stepper: 新增多个 Less 变量 #3599
• Icon: 更新 checked、comment、comment-o 图标 #3615

Bug Fixes

• 修复 Icon 传入图片时被拉伸的问题 #3667
• 修复 ImagePreview 滚动穿透问题 #3645
• 修复 Tab 使用 title slot 时可能报错的问题 #3631
• 修复 vetur 插件自动补全组件属性不生效的问题 #3617

v2.0.2

2019-06-21

Improvements

• Picker: 优化滚动速率 #3556
• Card: 新增 click-thumb 事件 #3586
• CouponList: 新增 enabled-title、disabled-title 属性 #3578
• Slider: 支持传入任意范围的 min、max 值 #3566
• Uploader: 支持 before-read 属性返回 Promise #3572
• NumberKeyboard: 支持 v-model 绑定输入值 #3531
• NumberKeyboard: 新增 maxlength 属性 #3532
• 新增 sideEffects 配置以支持 tree shaking #3530

Bug Fixes

• 修复 Sku 图片预览可能报错的问题 #3569
• 修复 Button 在 safari 浏览器上存在外边距的问题 #3577
• 修复 Toast clear 方法类型定义缺少参数的问题 #3542

v2.0.1

2019-06-15

Improvements

• Toast: 新增 icon 属性 #3485
• DropdownMenu: 新增 direction 属性 #3490
• NumberKeyboard: 新增 delete 属性 #3499
• Icon: 使用 Image 组件优化图片布局 #3515
• Tab: 支持 string 类型的 line-width 和 line-height #3514

Bug Fixes

• 修复 Image 组件 TS 定义缺失的问题 #3520
• 修复 SwitchCell 加载图标偏移的问题 #3501
• 修复 Locale 函数类型文案无法修改的问题 #3498
• 修复 Toast 在 multiple 模式下没有淡出动画的问题 #3504

v2.0.0

2019-06-12

主要变动

• 增加四个新组件
• 增加数十个 API
• 优化无障碍访问
• 全新的卡片风格文档，支持文档搜索
• 所有组件支持通过less变量自定义样式
• 调整了部分不合理的命名，废弃少量 API

新组件

在 2.0 版本中，我们引入了社区中呼声最高的四个组件，分别是：

• Image 图片，类似于小程序原生的 Image 标签，支持多种图片裁剪模式
• IndexBar 索引栏，通讯录中的字母索引栏，用于长列表快速索引
• Skeleton 骨架屏，在待加载区域展示的占位区块，提供界面加载过程中的过渡效果
• DropdownMenu 下拉菜单，用于列表的分类选择、筛选及排序

新文档

文档方面，我们重新设计了文档站点，用卡片的方式组织段落，更加直观。对一些较为复杂的组件，我们对示例进行细粒度的拆分，添加更多的用法介绍，以帮助大家更快地上手使用。

此外，文档站点也支持了搜索和版本切换。

样式定制

移动端 UI 风格多变，对组件的可定制性要求较高。从 2.0 版本开始，Vant 中的所有组件都支持通过 Less 变量进行样式定制。同时我们新增了较多样式相关的 Props，便于快速定制组件风格。

更轻量

轻量化是 Vant 的核心开发理念之一。在过去一年多时间里，我们新增了若干个组件和数百项功能，而代码包体积从 1.0 版本的 169kb 降低到了 2.0 版本的 161kb（45kb gzipped），平均每个组件体积下降 13%，这主要得益于组件内部逻辑的重构和复用。

在未来的 Vue 3.0 版本中，会提供 Function-based API 这一更优的逻辑复用方式，预计能帮助 Vant 进一步优化代码包体积。

不兼容更新

2.0 版本中包含少量不兼容更新，主要是调整命名和移除个别属性。对于正在使用 1.x 版本的项目，请按照下方的列表依次检查，大部分项目可以无痛升级。

Actionsheet

• 重命名为ActionSheet

Button

• 移除bottom-action属性，请使用square和size代替

Field

• 移除on-icon-click属性，请使用click-right-icon事件代替
• icon属性重命名为right-icon
• icon插槽重命名为right-icon
• click-icon事件重命名为click-right-icon

GoodsAction

• GoodsActionBigBtn重命名为GoodsActionButton
• GoodsActionMiniBtn重命名为GoodsActionIcon
• GoodsActionBigBtn移除primary属性，请使用type属性代替

Step

• 移除icon属性
• 移除title属性
• 移除icon-class属性
• 移除description属性
• 移除message-extra插槽

Badge

• BadgeGroup重命名为Sidebar
• Badge重命名为SlidebarItem

Loading

• 移除circle类型
• 移除gradient-circle类型

Checkbox

• 调整为flex布局，可能对原有布局产生影响

Radio

• 调整为flex布局，可能对原有布局产生影响

Waterfall

• 移除在 1.0 版本废弃的 Waterfall 组件，请使用List组件代替，或使用独立的@vant/waterfall包。

---

无障碍访问

对以下组件增加了无障碍访问的支持：

• Accordion
• Checkbox
• Dialog
• DropdownMenu
• GoodsAction
• List
• NoticeBar
• NumberKeyboard
• Radio
• Rate
• Stepper
• Tab
• Slider
• Switch

新特性

ActionSheet

• 新增lock-scroll属性
• 新增click-overlay事件
• 新增close-on-click-action属性
• 支持同时使用title和actions属性

Area

• 支持reset方法传入code参数

Button

• 新增icon属性
• 新增loading-type属性

Checkbox

• 新增icon-size属性

DatetimePicker

• 新增filter属性

Field

• 新增input插槽
• 新增click事件
• 新增clickable属性
• 新增label-class属性
• 优化输入体验，输入法拼写过程中不再会触发v-model更新

GoodsActionButton

• 新增type属性

Icon

• 支持Number类型的size属性

ImagePreview

• 新增close-on-popstate属性

List

• 优化滚动判断逻辑

Loading

• 新增default插槽
• 新增vertical属性
• 新增text-size属性
• 支持Number类型的size属性

Notify

• 新增onClick选项
• 新增onClose选项
• 新增onOpened选项

NoticeBar

• 新增left-icon插槽
• 新增right-icon插槽

PasswordInput

• 新增gutter属性

Picker

• 支持惯性滚动
• 新增toolbar-position属性

Popup

• 新增click事件
• 新增duration属性

Radio

• 新增icon-size属性

Rate

• 新增gutter属性
• 支持String类型的size属性

Search

• 新增clearable属性
• 新增left-icon属性
• 新增right-icon属性
• 新增right-icon插槽
• 优化输入体验，输入法拼写过程中不再会触发v-model更新

Slider

• 新增drag-start事件
• 新增drag-end事件

Steps

• 新增inactive-icon属性
• 新增inactive-icon插槽

Stepper

• 支持Number类型的input-width属性

SubmitBar

• 新增tip-icon属性
• 新增suffix-label属性

SwipeCell

• 支持自动计算left-width和right-width

Switch

• 加载图标颜色现在会跟随背景色变化

SwitchCell

• 新增border属性
• 新增cell-size属性

Sku

• 新增preview-open事件
• 新增preview-close事件

Tab

• 新增border属性
• 优化animated动画性能
• 修复开启animated后高度错误的问题

Tabbar

• 新增route属性
• 新增border属性
• 新增inactive-color属性

TabbarItem

• 新增name属性

Toast

• 新增onOpened选项

Uploader

• 新增上传区域默认样式
• 新增delete事件
• 新增upload-text属性
• 新增max-count属性
• 新增preview-size属性
• 新增preview-image属性
• 支持通过v-model绑定文件列表
• oversize事件增加detail参数

---

后续计划

我们计划在今年下半年推出 VantWeapp 1.0 版本，目标是对标 Vant 2.0 版本，将大部分新组件和新功能同步到小程序端。

同时，Vant 3.0 版本也在酝酿当中，不出意外的话，3.0 版本会基于 Vue 3.0 实现，并争取和 Vue 3.0 同期发布。

对于 Vant 1.x 版本，后续会进入维护期，跟进问题修复，但不再引入功能性改动。