# Changelog ### [v2.1.6](https://github.com/youzan/vant/tree/v2.1.6) `2019-08-26` **Improvements** - Tag: add warning type [\#4232](https://github.com/youzan/vant/pull/4232) - Image: add radius prop [\#4230](https://github.com/youzan/vant/pull/4230) - Notify: add type prop [\#4237](https://github.com/youzan/vant/pull/4237) - CellGroup: add title slot [\#4227](https://github.com/youzan/vant/pull/4227) - Sku: initialSku can be set dynamically [\#4214](https://github.com/youzan/vant/pull/4214) - Sku: can preview images of non-first level sku [\#4236](https://github.com/youzan/vant/pull/4236) - Locale: add Spanish translation [\#4235](https://github.com/youzan/vant/pull/4235) **Bug Fixes** - fix Tabbar incorrect active style in route mode [\#4229](https://github.com/youzan/vant/pull/4229) - fix NumberKeyboard incorrect sidebar position when has title [\#4228](https://github.com/youzan/vant/pull/4228) - fix IndexBar the problem of rolling out parent boundaries when sticky bottom [\#4218](https://github.com/youzan/vant/pull/4218) ### [v2.1.5](https://github.com/youzan/vant/tree/v2.1.5) `2019-08-23` **Improvements** - Toast: add closeOnClick option [\#4192](https://github.com/youzan/vant/pull/4192) - Uploader: add image-fit prop [\#4189](https://github.com/youzan/vant/pull/4189) - Uploader: add click-preview event [\#4206](https://github.com/youzan/vant/pull/4206) - Uploader: add preview-full-image prop [\#4205](https://github.com/youzan/vant/pull/4205) - DropdownMenu: add @dropdown-menu-title-active-text-color less var [\#4208](https://github.com/youzan/vant/pull/4208) **Bug Fixes** - fix IndexBar sticky bug [\#4184](https://github.com/youzan/vant/pull/4184) - fix NumberKeyboard border color [\#4183](https://github.com/youzan/vant/pull/4183) - fix Area can't select some oversea countries [\#4195](https://github.com/youzan/vant/pull/4195) ### [v2.1.4](https://github.com/youzan/vant/tree/v2.1.4) `2019-08-21` **Improvements** - Col: add click event [\#4169](https://github.com/youzan/vant/pull/4169) - Row: add click event [\#4170](https://github.com/youzan/vant/pull/4170) - Area: add is-oversea-code prop [\#4163](https://github.com/youzan/vant/pull/4163) - Circle: support gradient color [\#4157](https://github.com/youzan/vant/pull/4157) - Circle: support number type of size prop [\#4160](https://github.com/youzan/vant/pull/4160) - Tabbar: support match route by to.name [\#4148](https://github.com/youzan/vant/pull/4148) - Sku: should close image preview when popstate [\#4152](https://github.com/youzan/vant/pull/4152) - Uploader: should close image preview when popstate [\#4151](https://github.com/youzan/vant/pull/4151) - Uploader: support more image types [\#4140](https://github.com/youzan/vant/pull/4140) - TreeSelect: support multiple select [\#4130](https://github.com/youzan/vant/pull/4130) - TreeSelect: active-id support sync modifier [\#4133](https://github.com/youzan/vant/pull/4133) - TreeSelect: main-active-index support sync modifier [\#4132](https://github.com/youzan/vant/pull/4132) **Bug Fixes** - fix Sku unextracted i18n message [\#4172](https://github.com/youzan/vant/pull/4172) - fix Tabbar avoid navigation duplicated [\#4147](https://github.com/youzan/vant/pull/4147) - fix Field button width shrinked in firefox [\#4144](https://github.com/youzan/vant/pull/4144) - fix Picker prevent style be override by base.css [\#4136](https://github.com/youzan/vant/pull/4136) ### [v2.1.3](https://github.com/youzan/vant/tree/v2.1.3) `2019-08-15` **Improvements** - Sku: support i18n [\#4123](https://github.com/youzan/vant/pull/4123) - Button: add color prop [\#4124](https://github.com/youzan/vant/pull/4124) - Collapse: log tips for incorrect value [\#4122](https://github.com/youzan/vant/pull/4122) - Uploader: add before-delete prop [\#4118](https://github.com/youzan/vant/pull/4118) - TreeSelect: add content slot [\#4105](https://github.com/youzan/vant/pull/4105) - TreeSelect: support string type of height prop [\#4107](https://github.com/youzan/vant/pull/4107) - NumberKeyboard: improve click experience [\#4116](https://github.com/youzan/vant/pull/4116) **Bug Fixes** - fix DropdownMenu incorrect style when inside NavBar [\#4098](https://github.com/youzan/vant/pull/4098) - fix Tab incorrect title position when insert tab pane [\#4091](https://github.com/youzan/vant/pull/4091) - fix Icon service-o icon incomplete [\#4088](https://github.com/youzan/vant/pull/4088) - fix Icon gift-o、refund-o icon incomplete [\#4089](https://github.com/youzan/vant/pull/4089) - fix Slider should not emit change event when value not changed [\#4087](https://github.com/youzan/vant/pull/4087) ### [v2.1.2](https://github.com/youzan/vant/tree/v2.1.2) `2019-08-10` **Improvements** - ActionSheet: add color option [\#4073](https://github.com/youzan/vant/pull/4073) - AddressEdit: add postal-validator prop [\#4067](https://github.com/youzan/vant/pull/4067) - Stepper: add show-plus、show-minus prop [\#4056](https://github.com/youzan/vant/pull/4056) - Divider: add separator role to improve accessibility [\#4069](https://github.com/youzan/vant/pull/4069) - DropdownMenu: add more less vars [\#4071](https://github.com/youzan/vant/pull/4071) - Uploader: support isImage flag [\#4072](https://github.com/youzan/vant/pull/4072) - Field: increase clickable area of icon [\#4058](https://github.com/youzan/vant/pull/4058) - Picker: stop propagation when touchmove in vertical direction [\#4043](https://github.com/youzan/vant/pull/4043) - Icon: add warning、good-job、good-job-o icon [\#4038](https://github.com/youzan/vant/pull/4038) - Icon: add smile、music、thumb-circle、phone-circle icon [\#4048](https://github.com/youzan/vant/pull/4048) - List: unify text font-size [\#4077](https://github.com/youzan/vant/pull/4077) - Image: img inherit round border [\#4032](https://github.com/youzan/vant/pull/4032) - adjust globalObject to support module script [\#4080](https://github.com/youzan/vant/pull/4080) **Bug Fixes** - fix Sticky incorrect position when inside scroll container [\#4055](https://github.com/youzan/vant/pull/4055) ### [v2.1.1](https://github.com/youzan/vant/tree/v2.1.1) `2019-08-02` **Bug Fixes** - fix DatetimePicker event not work [\#4027](https://github.com/youzan/vant/pull/4027) - fix Popup ensure z-index setting order [\#4026](https://github.com/youzan/vant/pull/4026) ### [v2.1.0](https://github.com/youzan/vant/tree/v2.1.0) [deprecated] `2019-08-01` **Improvements** - GoodsAction: update style [\#3967](https://github.com/youzan/vant/pull/3967) - Sku: update style [\#3875](https://github.com/youzan/vant/pull/3875) [\#3922](https://github.com/youzan/vant/pull/3922) - Sku: add price-tag prop [\#3875](https://github.com/youzan/vant/pull/3875) - Sku: add hide-selected-text prop [\#3875](https://github.com/youzan/vant/pull/3875) - Sku: add sku-header-origin-price slot [\#3958](https://github.com/youzan/vant/pull/3958) - Dialog: add title slot [\#3985](https://github.com/youzan/vant/pull/3985) - Dialog: centered in screen [\#3905](https://github.com/youzan/vant/pull/3905) - Uploader: add less vars [\#3907](https://github.com/youzan/vant/pull/3907) - ActionSheet: add less vars [\#3908](https://github.com/youzan/vant/pull/3908) - AddressList: add click-item event [\#3942](https://github.com/youzan/vant/pull/3942) - CouponList: add empty-image prop [\#3941](https://github.com/youzan/vant/pull/3941) - SwipeCell: add stop-propagation prop [\#3952](https://github.com/youzan/vant/pull/3952) - ImagePreview: add swipe-duration prop [\#3963](https://github.com/youzan/vant/pull/3963) **Bug Fixes** - fix Tabs incorrect line position in some cases [\#3961](https://github.com/youzan/vant/pull/3961) - fix ImagePreview should reset onClose & onChange option [\#3960](https://github.com/youzan/vant/pull/3960) - fix DatetimePicker incorrect confirm param when use formatter [\#3969](https://github.com/youzan/vant/pull/3969) - fix Tabs fix scroll position deviation when sticky [\#3949](https://github.com/youzan/vant/pull/3949) - fix IndexBar should update when index-list updated [\#3943](https://github.com/youzan/vant/pull/3943) - fix AddressList can't select item when click empty area [\#3909](https://github.com/youzan/vant/pull/3909) - fix ImagePreview Image beyond the screen height cover index [\#4002](https://github.com/youzan/vant/pull/4002) - fix Radio: can't select when click gap [\#4007](https://github.com/youzan/vant/pull/4007) - fix SwipeCell should not prevent touchmove when opened [\#3982](https://github.com/youzan/vant/pull/3982) ### [v2.0.9](https://github.com/youzan/vant/tree/v2.0.9) `2019-07-19` **Improvements** - add Sticky component [\#3888](https://github.com/youzan/vant/pull/3888) - Grid: optimize word break [\#3897](https://github.com/youzan/vant/pull/3897) - Image: add round prop [\#3838](https://github.com/youzan/vant/pull/3838) - Image: add show-error prop [\#3896](https://github.com/youzan/vant/pull/3896) - Image: add show-loading prop [\#3893](https://github.com/youzan/vant/pull/3893) - Toast: add iconPrefix option [\#3872](https://github.com/youzan/vant/pull/3872) - Toast: optimize image icon display [\#3895](https://github.com/youzan/vant/pull/3895) - TreeSelect: add click-nav、click-item event [\#3892](https://github.com/youzan/vant/pull/3892) - ActionSheet: add round prop [\#3874](https://github.com/youzan/vant/pull/3874) - Uploader: support preview network image [\#3899](https://github.com/youzan/vant/pull/3899) **Bug Fixes** - fix Dialog closeOnPopstate can't be disabled [\#3868](https://github.com/youzan/vant/pull/3868) - fix DropdownMenu cann't use toggle to open item [\#3876](https://github.com/youzan/vant/pull/3876) - fix SwipeCell should stop event propagation [\#3898](https://github.com/youzan/vant/pull/3898) ### [v2.0.8](https://github.com/youzan/vant/tree/v2.0.8) `2019-07-16` **Improvements** - Sku: support custom placeholder [\#3864](https://github.com/youzan/vant/pull/3864) - DropdownMenu: add icon option [\#3855](https://github.com/youzan/vant/pull/3855) - DropdownMenu: optimize title ellipsis [\#3847](https://github.com/youzan/vant/pull/3847) - ImagePreview: support double click zoom [\#3839](https://github.com/youzan/vant/pull/3839) **Bug Fixes** - fix Tab: click event param missing [\#3866](https://github.com/youzan/vant/pull/3866) - fix List not work when body is the scrolling container [\#3844](https://github.com/youzan/vant/pull/3844) - fix IndexBar incorrect active anchor in some cases [\#3832](https://github.com/youzan/vant/pull/3832) ### [v2.0.7](https://github.com/youzan/vant/tree/v2.0.7) `2019-07-11` **Improvements** - add CountDown component [\#3805](https://github.com/youzan/vant/pull/3805) - Popup: add round prop [\#3781](https://github.com/youzan/vant/pull/3781) - PullRefresh: add distance of slotProps [\#3829](https://github.com/youzan/vant/pull/3829) - DropdownMenu: add close-on-click-outside prop [\#3824](https://github.com/youzan/vant/pull/3824) - Swipe: add immediate option of swipeTo method [\#3821](https://github.com/youzan/vant/pull/3821) - Slider: support number type of bar-height prop [\#3794](https://github.com/youzan/vant/pull/3794) - IndexBar: add sticky-offset-top prop [\#3791](https://github.com/youzan/vant/pull/3791) **Bug Fixes** - fix Popup overlay may cover popup in some cases [\#3831](https://github.com/youzan/vant/pull/3831) - fix Stepper add hack for iOS 12 page scroll [\#3804](https://github.com/youzan/vant/pull/3804) - fix Dialog missing closeOnPopstate in type definition [\#3789](https://github.com/youzan/vant/pull/3789) - fix DatetimePicker confirm event param incorrect when use filter [\#3816](https://github.com/youzan/vant/pull/3816) ### [v2.0.6](https://github.com/youzan/vant/tree/v2.0.6) `2019-07-05` **Improvements** - add Divider component [\#3755](https://github.com/youzan/vant/pull/3755) - Tab: add name prop [\#3762](https://github.com/youzan/vant/pull/3762) - Sku: add add-cart-text prop [\#3725](https://github.com/youzan/vant/pull/3725) **Bug Fixes** - fix Swipe fix blank area when use width prop [\#3751](https://github.com/youzan/vant/pull/3751) - fix Grid gutter can be string type [\#3741](https://github.com/youzan/vant/pull/3741) - fix Collapse use double raf to ensure animation can start [\#3723](https://github.com/youzan/vant/pull/3723) - fix PullRefresh ensure value change can be watched [\#3719](https://github.com/youzan/vant/pull/3719) ### [v2.0.5](https://github.com/youzan/vant/tree/v2.0.5) `2019-07-02` **Improvements** - Stepper: add button-size prop [\#3714](https://github.com/youzan/vant/pull/3714) - Stepper: support long press gesture [\#3711](https://github.com/youzan/vant/pull/3711) - Dialog: add close-on-popstate prop [\#3709](https://github.com/youzan/vant/pull/3709) **Bug Fixes** - fix postcss config overwritten issue ### [v2.0.4](https://github.com/youzan/vant/tree/v2.0.4) `2019-07-01` **Improvements** - add Grid、GridItem component [\#3669](https://github.com/youzan/vant/pull/3669) [\#3682](https://github.com/youzan/vant/pull/3682) [\#3683](https://github.com/youzan/vant/pull/3683) - Field: add arrow-direction prop [\#3679](https://github.com/youzan/vant/pull/3679) - Sidebar: add to、replace prop [\#3696](https://github.com/youzan/vant/pull/3696) - Sidebar: support use v-model to bind active key [\#3698](https://github.com/youzan/vant/pull/3698) - IndexBar: add class for active index [\#3692](https://github.com/youzan/vant/pull/3692) - Uploader: support number type of name prop [\#3681](https://github.com/youzan/vant/pull/3681) - SwipeCell: add name prop [\#3680](https://github.com/youzan/vant/pull/3680) - AddressEdit: add detail-maxlength prop [\#3707](https://github.com/youzan/vant/pull/3707) - GoodsActionIcon: add icon slot [\#3705](https://github.com/youzan/vant/pull/3705) **Bug Fixes** - fix Collapse flick in safari [\#3686](https://github.com/youzan/vant/pull/3686) - fix Picker compatibility issues on lower versions of Android [\#3688](https://github.com/youzan/vant/pull/3688) ### [v2.0.3](https://github.com/youzan/vant/tree/v2.0.3) `2019-06-27` **Improvements** - ActionSheet: add duration prop [\#3608](https://github.com/youzan/vant/pull/3608) - ActionSheet: add open、opened events [\#3639](https://github.com/youzan/vant/pull/3639) - ActionSheet: add close、closed events [\#3639](https://github.com/youzan/vant/pull/3639) - Icon: add fit mode for image content [\#3667](https://github.com/youzan/vant/pull/3667) - Icon: update checked、comment、comment-o icon [\#3615](https://github.com/youzan/vant/pull/3615) - ImagePreview: add onChange option [\#3630](https://github.com/youzan/vant/pull/3630) - Popup: optimize overlay animation duration [\#3610](https://github.com/youzan/vant/pull/3610) - Uploader: support preview non-image file [\#3604](https://github.com/youzan/vant/pull/3604) - Uploader: support click to preview image [\#3603](https://github.com/youzan/vant/pull/3603) - Stepper: add less vars [\#3599](https://github.com/youzan/vant/pull/3599) **Bug Fixes** - fix ImagePreview should lock scroll [\#3645](https://github.com/youzan/vant/pull/3645) - fix Tab may cause error when render title slot [\#3631](https://github.com/youzan/vant/pull/3631) - fix vetur auto-complete [\#3617](https://github.com/youzan/vant/pull/3617) ### [v2.0.2](https://github.com/youzan/vant/tree/v2.0.2) `2019-06-21` **Improvements** - Card: add click-thumb event [\#3586](https://github.com/youzan/vant/pull/3586) - CouponList: add enabled-title、disabled-title props [\#3578](https://github.com/youzan/vant/pull/3578) - Slider: min/max can set any value [\#3566](https://github.com/youzan/vant/pull/3566) - Uploader: before-read prop support promise mode [\#3572](https://github.com/youzan/vant/pull/3572) - Picker: update acceleration rate [\#3556](https://github.com/youzan/vant/pull/3556) - NumberKeyboard: support v-model [\#3531](https://github.com/youzan/vant/pull/3531) - NumberKeyboard: add maxlength prop [\#3532](https://github.com/youzan/vant/pull/3532) - add sideEffects to enable tree shaking [\#3530](https://github.com/youzan/vant/pull/3530) **Bug Fixes** - fix Button default margin in safari [\#3577](https://github.com/youzan/vant/pull/3577) - fix Sku can not preview image when only have goods picture [\#3569](https://github.com/youzan/vant/pull/3569) - fix Toast missing type definition of clear method [\#3542](https://github.com/youzan/vant/pull/3542) ### [v2.0.1](https://github.com/youzan/vant/tree/v2.0.1) `2019-06-15` **Improvements** - Tab: support string type of line-width & line-height [\#3514](https://github.com/youzan/vant/pull/3514) - Icon: use image component to display image [\#3515](https://github.com/youzan/vant/pull/3515) - Toast: add icon prop [\#3485](https://github.com/youzan/vant/pull/3485) - DropdownMenu: add direction prop [\#3490](https://github.com/youzan/vant/pull/3490) - NumberKeyboard: add delete slot [\#3499](https://github.com/youzan/vant/pull/3499) **Bug Fixes** - fix Image missing type definition [\#3520](https://github.com/youzan/vant/pull/3520) - fix SwitchCell incorrect loading position [\#3501](https://github.com/youzan/vant/pull/3501) - fix Toast missing fade-out transition in multiple mode [\#3504](https://github.com/youzan/vant/pull/3504) - fix Locale can not modify functional message [\#3498](https://github.com/youzan/vant/pull/3498) ### [v2.0.0](https://github.com/youzan/vant/tree/v2.0.0) `2019-06-12` #### Overview - Add four new components - Add dozens of APIs - Improve accessibility - New card style document, support document search - All components support custom styles via `less` variables - Rename several components, deprecate several APIs #### New Components - `Image` Component - `Skeleton` Component - `IndexBar`、`IndexAnchor` Component - `DropdownMenu`、`DropdownItem` Component ![](https://img.yzcdn.cn/public_files/2019/06/10/141ac9b67c06be0811c86c4c1c571c9d.png) #### Breaking Changes ##### Actionsheet - Rename to `ActionSheet` ##### Button - Remove `bottom-action` prop，please use `square` and `size` instead ##### Field - Remove `on-icon-click` prop，please use `click-right-icon` event instead - Rename `icon` prop to `right-icon` - Rename `icon` slot to `right-icon` - Rename `click-icon` event to `click-right-icon` ##### GoodsAction - Rename `GoodsActionBigBtn` to `GoodsActionButton` - Rename `GoodsActionMiniBtn` to `GoodsActionIcon` - Remove `primary` prop of `GoodsActionBigBtn`，please to `type` prop instead ##### Step - Remove `icon` prop - Remove `title` prop - Remove `icon-class` prop - Remove `description` prop - Remove `message-extra` slot ##### Badge - Rename `BadgeGroup` to `Sidebar` - Rename `Badge` to `SlidebarItem` ##### Loading - Remove `circle` type - Remove `gradient-circle` type ##### Checkbox - Adjusted to `flex` layout, may affect the original layout ##### Radio - Adjusted to `flex` layout, may affect the original layout ##### Waterfall - Remove Waterfall component，please use `List` instead，or use [@vant/waterfall](https://github.com/youzan/vant/tree/dev/packages/vant-waterfall)。 --- #### Accessibility Improve accessibility for those components： - Accordion - Checkbox - Dialog - DropdownMenu - GoodsAction - List - NoticeBar - NumberKeyboard - Radio - Rate - Stepper - Tab - Slider - Switch #### New Feature ##### ActionSheet - Add `lock-scroll` prop - Add `click-overlay` event - Add `close-on-click-action` prop - Support both use `title` and `actions` prop ##### Area - `reset` method support `code` param ##### Button - Add `icon` prop - Add `loading-type` prop ##### Checkbox - Add `icon-size` prop ##### DatetimePicker - Add `filter` prop ##### Field - Add `input` slot - Add `click` event - Add `clickable` prop - Add `label-class` prop - No longer update v-model during IME composition ##### GoodsActionButton - Add `type` prop ##### Icon - Support `Number` type of `size` prop ##### ImagePreview - Add `close-on-popstate` prop ##### Loading - Add `default` slot - Add `vertical` prop - Add `text-size` prop - Support `Number` type of `size` prop ##### Notify - Add `onClick` option - Add `onClose` option - Add `onOpened` option ##### NoticeBar - Add `left-icon` slot - Add `right-icon` slot ##### PasswordInput - Add `gutter` prop ##### Picker - Support inertial scrolling - Add `toolbar-position` prop ##### Popup - Add `click` event - Add `duration` prop ##### Radio - Add `icon-size` prop ##### Rate - Add `gutter` prop - Support`String` type of `size` prop ##### Search - Add `clearable` prop - Add `left-icon` prop - Add `right-icon` prop - Add `right-icon` slot - No longer update v-model during IME composition ##### Slider - Add `drag-start` event - Add `drag-end` event ##### Steps - Add `inactive-icon` prop - Add `inactive-icon` slot ##### Stepper - Support`Number` type of `input-width` prop ##### SubmitBar - Add `tip-icon` prop - Add `suffix-label` prop ##### SwipeCell - Auto calc `left-width` and `right-width` ##### Switch - The loading icon color will now follow the background color change ##### SwitchCell - Add `border` prop - Add `cell-size` prop ##### Sku - Add `preview-open` event - Add `preview-close` event ##### Tab - Add `border` prop - Optimize `animated` animation performance - Fix incorrect tab pane height when use `animated` prop ##### Tabbar - Add `route` prop - Add `border` prop - Add `inactive-color` prop ##### TabbarItem - Add `name` prop ##### Toast - Add `onOpened` option ##### Uploader - Add default upload style - Add `delete` event - Add `upload-text` prop - Add `max-count` prop - Add `preview-size` prop - Add `preview-image` prop - Support use `v-model` to bind file-list - `oversize` event add `detail` param