vant/docs/markdown/changelog.en-US.md

Changelog

Tips

The current document is the changelog of Vant 2. If you want to view the changelog of Vant 3, please visit Vant 3 Changelog.

Intro

Vant follows Semantic Versioning 2.0.0.

Release Schedule

• Patch version：released weekly, including features and bug fixes.
• Minor version：released every one to two months, including backwards compatible features.
• Major version：including breaking changes and new features.

Details

v2.12.48

2022-06-25

Feature

• Steps: add center prop #10617

Bug Fixes

• Dialog: should not submit form after clicking button #10570
• List: element with overflow: overlay style should be considered a scroll container #10743

v2.12.47

2022-04-07

Feature

• Locale: add vi-VN lang #10477

v2.12.46

2022-03-30

Bug Fixes

• TabBar: fix route matching in special cases #10447

v2.12.45

2022-03-18

Bug Fixes

• Sku: Fixed a syntax error when skuTree is an empty array in special cases #10390

Feature

• Dialog: support keyboard events #10359

v2.12.44

2022-02-14

Bug Fixes

• utils: isEmail ReDoS #10295

v2.12.43

2022-02-10

Feature

• Cascader: add show-header prop #10201
• CollapseItem: add lazy-render prop #10279

Bug Fixes

• Icon: remove white space under image when using image URL #10224

v2.12.42

2022-02-07

Feature

• switch npm tag to latest-v2 d84d2d

v2.12.39

2022-01-15

Bug Fixes

• DatetimePicker: error in some edge cases #10186
• ImagePreview: incorrectly closed after zooming #10191
• NavBar: get correct height in mobile safari #10190
• Tabbar: get correct height in mobile safari #10185

v2.12.38

2022-01-10

Feature

• Slider: add left-button and right-button slots #10053

Bug Fixes

• PullRefresh: may trigger browser bounce in some cases #10090

v2.12.37

2021-12-14

Feature

• ImagePreview: add overlayStyle option #10043

Bug Fixes

• DatetimePicker: should update value after calling picker methods #10028

v2.12.36

2021-12-05

Bug Fixes

• Calendar: date is empty when poppable = fasle in dialog #9845 #9939
• Uploader: preview is slow when sum of images size be bigger #7307 #9953

v2.12.35

2021-11-27

Bug Fixes

• DatetimePicker: fix incorrect confirm value when v-model is not used #9938
• Swipe: incorrect border radius in iOS safari #9933 #9931

v2.12.34

2021-11-24

Feature

• Tabbar: support highlight with child route #9173 #9921

Bug Fixes

• DatetimePicker: fix incorrect confirm value when v-model is not used #9913
• Swipe: should prevent touchmove event when swiping #9918

v2.12.33

2021-11-16

Bug Fixes

• Picker: SSR broken #9875

v2.12.32

2021-11-15

Feature

• NoticeBar: add reset method #9864
• Picker: support mouse wheel on desktop browser #9713

Bug Fixes

• Field: should not trigger validation after blurring readonly input #9863
• Switch: switch node inherit font-size #9841
• Tabbar: before-change not work in route mode #9855

v2.12.31

2021-10-30

Bug Fixes

• Field: adjust textarea size when focus/blur #9718
• Progress: should resize when window size changed #9757
• fix VueConstructor type conflict #9750

v2.12.30

2021-10-14

Feature

• Sku: add message extra desc #9651

v2.12.29

2021-09-22

Bug Fixes

• Tabs: failed to scroll into view when render multiple tabs #9542

v2.12.28

2021-09-20

Feature

• Icons: add shield-o、guide-o icon fc2406

Bug Fixes

• Radio: icon ref may be undefined #9504

v2.12.27

2021-09-06

Feature

• Sku: add custom-upload prop #9389

Bug Fixes

• Field: field-error-message-font-size var name #9393
• Popup: fix memory leak issue #9336

v2.12.26

2021-08-15

Feature

• Uploader: add click-upload event #9260
• Uploader: add readonly prop #9257

Bug Fixes

• Field: textarea scroll to top after resizing #9207
• Rate: should enable flex wrap #9193
• Tabs: remove invalid head padding for card type #9169

v2.12.25

2021-07-25

Feature

• Cascader: add option slot #9111
• CellGroup: add inset prop #9055

v2.12.24

2021-07-13

Bug Fixes

• DatetimePicker: fix incorrect value when using filter #9009
• Step: z-index issue #9004

v2.12.23

2021-07-06

Bug Fixes

• DatetimePicker: fix change max-date、max-hour emit incorrect value #8977
• Stepper: incorrect value after blurred when using async-change #8936
• Toast: fix word break #8966

v2.12.22

2021-06-22

Feature

• Calendar: add top-info、bottom-info slot #8847

Bug Fixes

• Slider: format v-model with step correctly #8894

v2.12.21

2021-06-03

Feature

• Button: add icon slot #8784
• CouponList: add list-footer、disabled-list-footer slot #8797
• Locale: add French translations #8795

Bug Fixes

• CellGroup: fix render error in loop #8787
• Collapse: fix safari rendering issues #8788
• List: remove unused Less var @list-icon-margin-right #8758
• NoticeBar: failed to play when inside a re-opened popup #8791
• Tabs: setLine when popup reopened #8792

v2.12.20

2021-05-23

Feature

• Uploader: max-size prop can be a function #8745

Bug Fixes

• Button: should not submit form when loading #8735
• functional components should inherit "key" #8718

v2.12.19

2021-05-17

Feature

• NoticeBar: increase default speed to 60 a48663
• Dependencies: unlock @vant/icons #8714

v2.12.18

2021-05-10

Bug Fixes

• Coupon: timestamp can be string type c5b4d1

v2.12.17

2021-05-08

Feature

• CouponList: support custom valid period #8679

v2.12.16

2021-05-03

Feature

• Steps: add icon-prefix prop #8630

Bug Fixes

• DatetimePicker: fixed show incorrect date time when dynamic set mindate or maxdate #8640

v2.12.15

2021-04-25

Bug Fixes

• Calendar: incorrect weekdays locale #8569
• Tag: incorrect border color when using plain #8602
• Uploader: failed to render scoped class #8613

v2.12.14

2021-04-18

Bug Fixes

• Calendar: failed to update subtitle in some cases #8513
• ShareSheet: duration prop not work #8542

v2.12.13

2021-04-11

Feature

• Sticky: add change event #8479

v2.12.12

2021-04-05

Bug Fixes

• fix incorrect tag prompts under Webstorm #8450

v2.12.11

2021-03-30

Bug Fixes

• Field: should not reset validation after blurred #8412
• Tabs: fix incorrect horizontal slip judgment #8387

v2.12.10

2021-03-19

Bug Fixes

• Utils: incorrect deepClone #8326
• Swipe: incorrect item width after scaled #8329

v2.12.9

2021-03-09

Feature

• AddressList: add tag slot #8311

v2.12.8

2021-03-07

Feature

• ImagePreview: add transition prop #8273
• PullRefresh: add pull-distance prop #8279
• Locale: add th-TH lang #8247

Bug Fixes

• ActionSheet: should not reopen when closed #8271
• ImagePreview: missing initial animation #8274
• Stepper: incorrect text color in iOS14 when disabled #8278

v2.12.7

2021-02-28

Feature

• Step: add finish-icon slot #8240
• Steps: add finish-icon prop #8237

Bug Fixes

• DatetimePicker: fix incorrecrt inital value when v-model is null #7832
• Empty: linearGradient id conflict #8011
• GoodsActionIcon: info warning #8040
• Tabs: incorrect active tab when active prop is zero #8087

v2.12.6

2021-01-26

Feature

• Icons: add wechat icon, rename wechat-pay icon b3cd8c

Bug Fixes

• fix CDN image url #8000

perf

• Sku: using icon instead of cdn image #7992

v2.12.5

2021-01-24

Feature

• Calendar: reset method support specified date #7943
• ImagePreview: reset scale after swiping #7974
• ImagePreview: adjust default swipe duration to 300ms #7973
• ShareSheet: add wechat-moments icon 4f94dd

style

• ShareSheet: update qrcode icon 335510

v2.12.4

2021-01-17

Feature

• Cascader: add field-names prop #7932
• Cell: allow to disable clickable when using is-link #7922

Bug Fixes

• Circle: the gradient color is incorrect #7910 #7897
• Field: should not allow dot when type is number #7921

v2.12.3

2021-01-09

Bug Fixes

• Col: compatible with less 4.0 d8a81b

v2.12.2

2021-01-02

Feature

• Calendar: add scrollToDate method #7847
• Form: add disabled prop #7829
• Form: add readonly prop #7829
• Loading: add text-color prop #7846
• IndexBar: add scrollTo method #7845
• NumberKeyboard: add random-key-order prop #7841

v2.12.1

2020-12-26

Feature

• Form: support valdiate multiple names #7810
• Form: resetValidation support multiple names #7811
• Stepper: add show-input prop #7812

Bug Fixes

• CountDown: fix ssr memory leak #7808
• Image: mismatching warning during ssr #7822
• Stepper: change event emitted twice #7820
• Swipe: incorrect size during ssr #7821

v2.12.0

2020-12-23

New Component

• add Cascader component #7771

Feature

• uploader: add single uploader preview image style #7776

Bug Fixes

• Tab: should scroll into view when title changed c919e9

v2.11.3

2020-12-18

Feature

• Sku: add disable-soldout-sku prop #7759
• Icon: add delete-o、sort、font、font-o、revoke icon #7760

v2.11.2

2020-12-10

style

• Circle: add @circle-color less var 1a6cf6
• Circle: add @circle-layer-color less var 65a5ed
• Circle: add @circle-size less var b57f7e
• IndexBar: adjust default highlight color to red 65b680
• IndexBar: adjust sticky anchor color to red 87b0a0
• IndexBar: increase right padding to 8px aad055

Bug Fixes

• Popover: incorrect border position in wework #7702
• Stepper: fix mobile safari page scroll down issue #7701

v2.11.1

2020-11-26

Feature

• CheckboxGroup: toggleAll support skipDisabled option #7644
• DatetimePicker: support picker slots #7645
• Popover: add trigger prop #7646
• Popover: improve a11y #7624
• ShareSheet: support weapp-qrcode icon #7635

style

• NavBar: z-index not work when border is hidden #7612
• Popover: improve cursor #7623

Bug Fixes

• Button: icon button vertical align #7636
• Popover: failed to compile in legacy nuxt.js f3ad7e

v2.11.0

2020-11-22

New Component

• add Badge component #7602
• add Popover component #7579

Feature

• Popup: add click-close-icon event #7599

Bug Fixes

• ActionSheet: The height of the flex container is lost under iOS 10 #7578

v2.10.14

2020-11-15

Feature

• ImagePreview: passing current index to index slot #7552
• Popup: add transition-appear prop #7525
• Skeleton: add @skeleton-avatar-size less var #7556
• Skeleton: add @skeleton-title-width less var #7557

Bug Fixes

• Calendar: month-show event triggered multiple times #7565
• Calendar: should not render all months on mounted #7564
• IndexBar: incorrect behavior inside popup #7559
• NavBar: safe-area-inset-top css incorrect #7534
• Skeleton: avatar-size can be number type #7555
• Sticky: not work in some cases #7561
• Swipe: leak when width has decimal #7562

v2.10.13

2020-11-08

Feature

• Icon: using encoded woff2 iconfont by default e0ad65
• NavBar: add safe-area-inset-top prop be25a4
• Sticky: offset-top support vh unit #7498

Bug Fixes

• NavBar: text vertical align #7515
• NoticeBar: can't replay in iOS14 #7516
• Picker: move to next option when default option is disabled #7499
• Picker: should move to first option when all options are disabled #7504
• Swipe: incorrect lazy render when loop is false #7465
• Swipe: item should only rendered once #7466
• Switch: remove unnecessary z-index #7497
• Toast: onClose option should only be called once #7496

v2.10.12

2020-10-31

Feature

• Image: add icon-prefix prop #7457
• Progress: add resize method #5161
• SubmitBar: add button slot #7458

style

• ActionSheet: keep the cancel button at the bottom #7401
• Popup: adjust round border radius to 16px #7421
• Sidebar: fix long number wrap #7456

Bug Fixes

• GridItem: should not emit deprecation warning #7433
• Picker: fix rendering failure during animation on safari #7460
• Tabs: incorrect change event in some cases #7461
• Tabs: should keep active value after insert item #7445

v2.10.11

2020-10-24

Feature

• Empty: add image-size prop #7389
• Picker: add option slot #7380
• Picker: add cancel slot #7377
• Picker: add confirm slot #7377

Bug Fixes

• Dialog: failed to disable closeOnPopstate #7357
• NavBar: should not render blank left、right element #7376
• Image: skip render loading placeholder during ssr #7383
• Revert "style(Field): adjust placeholder color to gray-6 (#7192)" (#7375) #7192 #7375

v2.10.10

2020-10-18

Feature

• Icons: add minus icon 40e26f
• IndexBar: add change event #7296

Improvement

• add info prop deprecation warning #7352 #7347
• SwitchCell: add deprecation warning #7350
• Toast: add mask option deprecation warning #7342
• TreeSelect: add deprecation warning of navclick/itemclick #7351

Bug Fixes

• Calendar: does not show current month with larger screen sizes #7355
• Tabs: incorrect animation when content is empty #7354
• Field: incorrect label length when label-align is right #7349
• GridItem: failed to break word #7292
• Icon: incomplete after-sale/cash-back-record #7328
• Picker: incorrect loading z-index 14cd28
• Row: should enable flex wrap #7332

v2.10.9

2020-10-01

Feature

• Locale: Add German translations #7245
• CollapseItem: add toggle method #7281
• Pagination: add page、prev-text、next-text slot #7222
• Tab: skip rendering empty pane #7238

Bug Fixes

• Swipe: fix prev、next method types #7270
• Button: incorrect ref in for #7237
• Field: incorrect maxlength slicing #7284
• @vant/markdown-vetur: fix Windows system build vetur problem #7277 #7287

v2.10.8

2020-09-21

Feature

• SidebarItem: add title slot #7220

Bug Fixes

• Calendar: incorrect month title #7205
• CouponCell: discounted value #7196
• Field: incorrect disabled color in iOS 14 #7206
• List: scoped style not applied to first child #7202
• Swipe: can't disable loop in some cases #7208
• Swipe: incorrect indicator color transition #7207

v2.10.7

2020-09-17

Feature

• Slider: add dual thumb mode for slider #7176
• Button: add icon-position prop #7174
• TabbarItem: add @tabbar-item-active-background-color less var #7162

Style

• Dialog: add message min-height #7191
• Field: adjust placeholder color to gray-6 #7192

Bug Fixes

• Calendar: incorrect height when using rem #7190
• ImagePreview: incorrect move range in some cases #7142
• NoticeBar: fix cache issues with forwards and back history in safari #7167
• NumberKeyboard: incorrect extra key #7150
• NumberKeyboard: slot content click event not work #7193
• Tabs: incorrect scroll position when offset-top has unit #7143
• Tag: text vertical align in miui #7151

v2.10.6

2020-09-08

Bug Fixes

• Calendar: readonly not work in multiple mode #7127
• CouponCell: fix discounted price #7123
• List: scoped style not applied to first child #7128

v2.10.5

2020-09-06

Feature

• ActionSheet: add closeable prop #7099
• Area: add readonly prop #7106
• Calendar: add readonly prop #7115
• Calendar: allow default-date to be null #7116
• DatetimePicker: add readonly prop #7107
• Picker: add readonly prop #7105

Bug Fixes

• Field: disallow minus when using digit type #7114
• Form: scroll to first matched field #7102
• Form: should reset validation before submit #7103
• Toast: failed to clear in some cases #7100

v2.10.4

2020-09-03

Feature

• ActionSheet: add description slot #7068
• Icon: add share-o icon ea6324
• Tabbar: add before-change prop #7081

Bug Fixes

• Calendar: row-height should work on selected month #7046
• Field: fix the issue of checking empty value #7050
• Icon: fix calendar-o typo #7080

v2.10.3

2020-08-25

Feature

• Uploader: preview-cover slot add index param #7036

Style

• Search: increase left padding to 12px #7014
• Tabs: adjust default line-width to 40px #7002
• Toast: adjust top position #7044

Bug Fixes

• Calendar: render error when using rem unit #7037
• Toast: failed to reopen when using get-container #7032

v2.10.2

2020-08-12

Feature

• Tab: add @tab-line-height less var #6985

Bug Fixes

• Sku: compatible sku.list don't exist #6991

v2.10.1

2020-08-10

Feature

• Button: add loading slot #6966
• Locale: adding Norwegian Language support #6962

Style

• ContactList: add safe area inset bottom #6970
• TabbarItem: increase icon size to 22px #6972

Bug Fixes

• AddressEdit: incorrect label wrap on safari #6969
• Icon: fix badge number align #6975 #6952

v2.10.0

2020-08-07

Feature

• AddressEdit: add tel-maxlength prop #6869
• Calendar: enable close-on-popstate by default #6874
• Dialog: add new prop theme #6921
• Dialog: enable close-on-popsate by default #6873
• DropdownMenu: add @dropdown-menu-box-shadow var 6d0c54
• Icon: add back-top icon #6931
• Icon: add photo-fail icon #6883
• ImagePreview: enable close-on-popstate by default #6875
• NumberKeyboard: add get-container prop #6870

Style

• uniform line-height #6862
• ActionSheet: add @action-sheet-loading-icon-size var #6847
• ActionSheet: adjust cancel text color to @gray-7 #6846
• ActionSheet: increase header height to 48px #6856
• Cell: adjust icon margin to 4px #6844
• CouponCell: insert a space after currency #6888
• DropdownMenu: adjust default active color to @red #6863
• Image: update loading icon and error icon #6890
• Field: adjust icon margin to 4px #6849
• NumberKeyboard: increase title size #6845
• NumberKeyboard: adjust padding bottom #6938
• NumberKeyboard: adjust key height to 28px #6899
• Picker: adjust default value of visible-item-count to 6 #6827
• Sidebar: adjust width to 80px #6861
• Sku: improve price align #6911
• Tag: adjust size and padding #6828
• Tab: remove default border 69ac60
• Tab: adjust padding in complete mode 90e678
• Tab: update nav padding 8027f4
• Tab: disable ellipsis when scrollable bc0e45
• Toast: adjust background color #6848
• Toast: adjust icon size to 36px #6857

Bug Fixes

• AddressEdit: render error in some cases #6942
• Calendar: should only scroll calendar body when inited #6926
• Field: failed to reset validation when message is empty #6867
• Info: number vertical align center #6952
• ImagePreview: fit orientationchange #6825
• NumberKeyboard: incorrect key height on legacy safari #6937
• Picker: when item.defaultIndex is 0, this.defaultIndex will be used #6948
• Sku: fix header image shrink #6949

v2.9.4

2020-07-29

Feature

• ShareSheet: add className option #6886
• Sku: modify default min year of sku date picker #6879

Bug Fixes

• Popup: incorrect lock scroll in some cases #6892
• Stepper: double tap to scroll in safari #6882

v2.9.3

2020-07-19

Feature

• Tabs: add before-change prop #6817
• Sticky: offset-top support vw unit #6816
• Picker: item-height support vw unit #6816
• Sku: add mobile message value formatter 19e0d0
• Tab: add scrollTo method #6800
• Uploader: add preview-options prop #6810

Bug Fixes

• Calendar: rendering fails in some cases #6812
• ImagePreview: image overflow in some cases #6811
• NumberKeyboard: flex not work on legacy safari #6804
• Slider: missing transition in vertical mode #6786

v2.9.2

2020-07-14

Feature

• Calendar: add first-day-of-week prop #6468
• DatetimePicker: add columns-order prop #6672 #6768

Bug Fixes

• Tab: should not trigger route when disabled #6782
• Sku: fix label color #6771
• Sku: image cell word wrap #6777

v2.9.1

2020-07-12

Feature

• DatetimePicker: add datehour type #6732
• Field: add clear-trigger prop #6699
• Search: add clear-trigger prop #6700
• Uploader: add preview-cover slot #6707
• ShareSheet: add click-overlay event #6765
• Stepper: add allow-empty prop #6759
• Steps: add inactive-color prop #6758
• SubmitBar: add button-color prop #6757
• Sku: improve message datetime picker 8d29e5 7343e5

Style

• ActionSheet: subname vertical align #6756
• Uploader: remove round border radius #6748
• Uploader: update delete icon style #6750

Bug Fixes

• Calendar: subtitle not updated in some cases #6723
• Checkbox: dynamic bind group #6730
• Field: can't display six characters in iOS #6743
• Image: memory leak during SSR #6721
• ImagePreview: fit window resize #6760
• ImagePreview: swipeTo type should be optional #6727
• Picker: click during momentum case incorrect result #6724
• Popup: lock-scroll not work in some cases #6698

v2.9.0

2020-07-03

Feature

• Icon: add enlarge icon 1c97b1
• Image: add default slot #6613
• ImagePreview: add swipeTo method #6596
• ImagePreview: add get-container prop 39b5be
• NoticeBar: optimize replay delay 022196
• Sku: add lazy-load prop #6598
• Sku: add show-header-image prop #6598
• Sku: support large image mode #6598
• Sku: enable close-on-click-overlay prop by default #6631
• TreeSelect: add selected-icon prop #6615

Style

• ActionSheet: update description style #6586
• AddressEdit: adjust label width #6591
• AddressEdit: area picker use round popup #6584
• Button: adjust small button size #6371
• Cell: adjust inner border gap #6686
• ContactEdit: adjust label width a77ebe
• Field: label color updated to gray-7 #6581
• Field: label width adjusted to 6em #6583 #6589
• ImagePreview: adjust index position #6650
• Picker: optimize option disabled cursor #6579
• Rate: the default color is adjusted to red #6373
• Uploader: update failed icon #6653

Bug Fixes

• ImagePreview: fix longpress error on mobile safari #6660
• ImagePreview: fix incorrect position after scale #6656
• Field: fix label word wrap #6590
• NumberKeyboard: fix eliminate tap delay on safari #6667
• Picker: disabled not work in cascade mode #6580
• Picker: revert add @picker-option-height var #6663
• Stepper: fix incorrect button disable status #6652

v2.8.7

2020-06-19

Feature

• Dialog: add allow-html prop #6568
• Field: add format-trigger prop #6566
• Form: rule message can be empty #6536
• Sticky: offset-top support rem unit #6556

Style

• Field: remove word num full color #6545
• Picker: add @picker-option-height less var #6571

Bug Fixes

• Field: should not display null #6542
• ImagePreview: incorrect drag area #6574
• NoticeBar: failed to replay e8bd24

v2.8.6

2020-06-13

Feature

• NoticeBar: allow to force scrolling 7b0546
• Picker: item-height support rem unit #6462
• Stepper: add placeholder prop #6519

Style

• Field: update disabled color #6534

Bug Fixes

• Calendar: quick select not work when select same day #6504
• CollapseItem: can't hide border #6533
• Field: formatter not work when v-model changed #6490
• ImagePreview: image blurred after scale on iOS #6496
• Picker: cursor.defaultIndex may be 0 #6473
• Tabbar: avoid redundant navigation error #6474

v2.8.5

2020-06-04

Feature

• DropdownItem: add lazy-render prop #6454
• Notify: support component call #6453
• ShareSheet: add options description #6460
• Skeleton: add round prop #6441

Bug Fixes

• Popup: incorrect overlay z-index when reopened #6429
• Button: set font-size to inherit when loading #6413 #6414
• NoticeBar: scroll failed after activated d21420
• Field: fix render error when value is null or undefined #6419

v2.8.4

2020-05-28

Feature

• AddressList: add safe-area-inset-bottom #6355
• DatetimePicker: add month-day type #6395
• Popup: create overlay for every popup #6357

Style

• ActionSheet: adjust subname color to gray-6 e54c11
• ActionSheet: remove option border 8db218
• Cell: lower CSS priority of the border #6359
• Collapse: adjust border gag #6361
• Collapse: increase content font-size to 14px #6358

Bug Fixes

• Area: use first city code when county list is empty #6356
• Field: can not disable error in form #6382
• GoodsAction: incorrect single button radius #6347
• Sidebar: should emit change when v-model changed #6383

v2.8.3

2020-05-21

Feature

• Form: add submit-on-enter prop #6336
• Form: scrollToField can scroll to bottom #6335
• Field: adjust field placeholder color to gray-5 #6304
• Field: minus can only be placed on the first char #6303
• Picker: improve method type, support generic #6315

Bug Fixes

• Button: text not align center in legacy safari #6325
• Calendar: color prop not work when use allow-some-day #6331

v2.8.2

2020-05-17

Feature

• Field: add extra slot #6290
• Grid: add direction prop #6256
• Calendar: add month-show event #6292
• NumberKeyboard: support multiple extra key #6276
• Stepper: add theme prop #6282

Style

• Rate: update rate disabled color #6253
• Sku: adjust border alignment #6272
• Sku: currency symbol should align to bottom #6274
• NoticeBar: increase icon min-width to 24px #6280

Bug Fixes

• Field: textarea line break failed on enter #6263
• NoticeBar: replay event only triggered once #6293

v2.8.1

2020-05-09

Feature

• Calendar: add lazy-render prop #6245
• Field: add click-input event #6239
• Sku: add sku-reset event #6220
• GoodsActionButton: improve test size adjust b1dcf3

Bug Fixes

• Button: text should align center 8c53db
• Field: should not submit form on enter #6240
• Step: active-color should effect circle #6229
• Stepper: incorrect value when format minus value #6238
• Stepper: should not display NaN 7327a4
• Stepper: should not emit focus when input is readonly c6024b

v2.8.0

2020-05-05

Style

• Button: use flex layout #6180
• ActionSheet: improve text size adjust #6175
• NavBar: improve text size adjust 7effb7
• NoticeBar: improve text size adjust #6177
• NumberKeyboard: improve text size adjust #6179
• Pagination: improve text size adjust #6178
• PasswordInput: improve text size adjust #6176
• Picker: improve text size adjust #6174 #6205
• Picker: update action button color #6214
• Tab: improve text size adjust #6209
• CouponList: add @coupon-list-close-button-height less var 18a0c5

Feature

• Calendar: add unselect event #6198
• Calendar: support max-range when type is multiple #6202
• Field: add colon prop #6195
• Locale: adding Romanian language support #6193
• ShareSheet: improve accessibility #6208

Bug Fixes

• Checkbox: incorrect icon position after font-size scale #6168
• Layout: gutter calculation #6197 #6143
• NoticeBar: allow dynamic setting of scrollable #6190
• Radio: incorrect icon position after font-size scale #6173
• ShareSheet: incorrect scrollbar height in some browsers #6207
• Tab: fix ellipsis issue #6209

v2.7.1

2020-04-28

Bug Fixes

• Revert "style(NavBar): left & right part align to bottom (#6147)" #6147

v2.7.0

2020-04-28

Style

• NumberKeyboard: new style 3188b4 #6149 #6151

• add base-font-family #6126
• DropdownMenu: add box-shadow style 7db744
• NavBar: left & right part align to bottom #6147
• Sidebar: add less vars e1a7c6
• Sidebar: update border style a31032
• Toast: increase border-radius to 8px 2364c4
• TreeSelect: change checked icon to success icon 5b72e4

Feature

• NoticeBar: add start method #6069
• ImagePreview: adjust double-click interval to 250ms #6136
• NumberKeyboard: add collapse icon #6152
• NumberKeyboard: add close-button-loading prop #6158

Bug Fixes

• Layout: outside of the screen after setting gutter #6143
• Tab: incorrect vnode order in some cases #6140
• uploader: automatically filter files exceeding the max-size #6150
• Uploader: file message should be reactive #6142
• types: VanComponent should extends Vue #6148

v2.6.3

2020-04-20

Bug Fixes

• Tab: fail to init in some cases #6101
• sort vnode not work #6100

v2.6.2

2020-04-18

Feature

• Empty: support offline scenario #6055
• NoticeBar: add replay event #6079
• Overlay: add lock-scroll prop #6082
• Uploader: add lazy-load prop #6083

Bug Fixes

• Checkbox: get changed value in click event #6066
• Picker: setColumnValues failed in cascade mode #6080
• Slider: incorrect bar-height when vertical #6065
• Swipe: incorrect width after resize if hidden #6084

v2.6.1

2020-04-14

Feature

• AddressEdit: add area-placeholder prop #6023
• ImagePreview: support local registration #6031

Bug Fixes

• sortChildren broke SSR #6046
• Calendar: default-date should be today, close #6025 #6025 #6028

v2.6.0

2020-04-09

Feature

• add ShareSheet component #6019
• add Empty component #6010

Feature

• Form: add show-error prop #5941
• Tabbar: add placeholder prop #5979
• Sku: enable safe-area-inset-bottom by default #5960
• Tabbar: enable safe-area-inset-bottom by default when fixed #5968
• SubmitBar: enable safe-area-inset-bottom by default #5956
• GoodsAction: enable safe-area-inset-bottom by default #5955
• Swipe: allow swipe multiple item at once #5953
• Calendar: auto selected to max range #5992

Improvement

• NavBar: improve active feedback #5949
• Popup: improve leave animation timing function #5954
• Picker: improve scroll speed #5951
• Swipe: improve swipe threshold #6003
• TreeSelect: update nav background color #5991

Bug Fixes

• Button: icon-prefix prop not work #5947
• Calendar: rendering error when activated #5978
• Form: incorrect validation order when add field dynamically b8dea3
• NavBar: icon align center #5948
• Stepper: readonly not work in lagacy mobile safari #5976

v2.5.9

2020-03-31

Feature

• AddressEdit: add click-area event #5939
• NavBar: add placeholder prop #5938
• Steps: add click-step event #5937

Bug Fixes

• NumberKeyboard: show-delete-key prop not work #5935
• Toast: incorrect height in legacy devices #5931
• Sticky: Fixed error when accessing the window during SSR #5958

v2.5.8

2020-03-27

Feature

• support generate webstorm types #5900
• Circle: improve text padding 10f32d
• Form: add show-error-message prop #5927
• ImagePreview: enable swipe lazy-render #5879
• Sidebar: set overflow-y auto #5921
• Swipe: add lazy-render prop 365f2b
• Swipe: use flex layout f701de

Bug Fixes

• Calendar: fix the default date of multiple selection type #5907
• PullRefresh: track should be full of container #5878
• Sticky: shoud rerender after visibility changed #5888
• Swipe: incorrect offset after resize #5922

v2.5.7

2020-03-20

Bug Fixes

• Locale: fix incorrect japanese filename e8c88a

v2.5.6

2020-03-20

Feature

• Calendar: add allow-same-day prop #5688
• GoodsAction: add badge prop, mark info prop as deprecated 0dea9e
• GridItem: add badge prop, mark info prop as deprecated db94b2
• Icon: add badge prop, mark info prop deprecated 575577
• ImagePreview: add closed event 5b279a
• locale: add japanese language #5853 #5854
• SidebarItem: add badge prop, mark info prop as deprecated 01482f
• Tab: add badge prop, mark info prop as deprecated 214b13
• TabbarItem: add badge prop, mark info prop as deprecated d61cbd
• TreeSelect: add badge option, mark info option as deprecated 0cc7a3
• Uploader: add chooseFile method #5818
• Uploader: add show-upload prop 66c0b3
• Uploader: use before read promise resolved value #5813

Bug Fixes

• Calendar: incorret button native-type #5873
• Field: should not cache input slot #5868
• ImagePreview: should not show previews image 7fcfc5
• Picker: update cascade after setColumnIndex #5807
• Picker: update cascade after setColumnValue #5807
• Toast: should lock scroll when use forbidClick df8777

v2.5.5

2020-03-11

Feature

• Calendar: add show-title prop #5779
• Calendar: add show-subtitle prop #5779
• Field: improve number keyboard e89baa
• Stepper: improve number keyboard 58e74a
• GoodsActionIcon: add dot prop b983ac

Bug Fixes

• AddressEdit: check addressDetail only when showDetail is true #5803
• Calendar: color not work in multiple mode #5786
• Field: should not get formValue from button slot #5785
• GoodsActionIcon: info not work with icon slot #5788
• Stepper: skip form number validation #5792
• Sticky: should not detect scroll when hidden 41e5c0

v2.5.4

2020-03-08

Feature

• Calendar: add multiple type #5705
• Field: input inherit line-height #5737
• Search: add left slot #5771
• Uploader: add upload-icon prop b3b46c
• Uploader: increase border-radius to 8px c67918
• Uploader: update upload area style bd4e64

Bug Fixes

• Calendar: incorrect position when poppable is false #5760
• DropdownMenu: menu ref may not exist in some cases #5770
• Tabs: incorrect scrollspy position while inside a scroller 0993b3
• Tabs: lock scroll not work when using scrollspy #5727
• TimePicker: incorrect value when set min-minute dynamically #5767

Types

• Form: fix missing scrollToField method df4439
• ImagePreview: fix missing closeable option d5438d
• Toast: fix missing iconPrefix option 3237e5

v2.5.3

2020-02-28

Feature

• ActionSheet: add close-on-popstate prop #5716
• Area: add columns-top、columns-bottom prop #5719
• Area: add title slot #5719
• Button: add icon-prefix prop #5666
• Cell: add icon-prefix prop #5666
• Field: add icon-prefix prop #5666
• Form: rule message can be function #5704
• Form: rule validator add rule param #5704
• Form: support pattern rule #5700
• Form: support rule formatter d87835
• GridItem: add icon-prefix prop #5666
• Rate: add icon-prefix prop #5666
• TabbarItem: add icon-prefix prop #5666

Bug Fixes

• Calendar: scrollIntoView error when hidden #5708
• DatetimePicker: getPicker method not work #5710
• Popup: close-on-popstate not work when deactivated f07077

v2.5.2

2020-02-21

Feature

• Calendar: add close、closed event 556f33
• Calendar: add open、opened event a83082
• Form: add scroll-to-error prop #5680
• Form: add validate-trigger prop c08db7
• Form: add scrollToField method #5680
• Sku: add preview-on-click-image prop #5684
• Sku: add sku-header-image-extra slot #5696

Bug Fixes

• Swipe: fix wrap problems caused by decimal width in some android devices 02afe7

v2.5.1

2020-02-18

Feature

• Sku: support define initialMessages
• Calendar: scroll to current month after reset 407b7d
• Calendar: scroll to currecnt month when default-date changed #5664

Bug Fixes

• Calendar: add Math.floor to avoid decimal height issues #5640
• Calendar: should not check range in single mode 79d2c3
• Form: error-message-align prop type #5674
• Swipe: incorrect width when resize in invisible state #5678

v2.5.0

2020-02-15

New Component

• add Form component

Feature

• Field: add name prop f3398d
• Field: add rules prop 0ed7aa
• AddressEdit: add disable-area prop #5630
• AddressList: add item-bottom slot #5629
• RadioGroup: add direction prop 4dd41b
• CheckboxGroup: add direction prop 153902
• ImagePreview: add scale event #5658
• ImagePreview: add closeable prop #5654

Style

• Field: input slot vertical align center 03c826
• Field: improve label right padding 2d6445
• Uploader: add uploader disabled style #5628

Bug Fixes

• Calendar: fix render issues in some devices #5640
• Dialog: fix Dialog.Component typing #5646
• Field: text-fill-color may affect child element e17a4a
• Picker: change event untriggered without a transition #5662
• Tabs: scrollspy not work when custom scroller #5637
• Calendar: should not submit form when click button e93fcb

v2.4.7

2020-02-06

Feature

• Calendar: improve accessibility 2124cc
• Field: highlight word num when reaching maxlength 61093e
• Sku: add sku-actions-top slot #5617
• Uploader: support failed status #5624
• Uploader: support uploading status #5625

Style

• ActionSheet: add @action-sheet-close-icon-active-color less var 265bfe
• Popup: add @popup-close-icon-active-color less var 660b03

Bug Fixes

• Calendar: missing className when selected 0b7c56
• Popup: may throw error when using get-container and destroyed

v2.4.6

2020-02-01

Bug Fixes

• Picker: should watch columns change #5614

v2.4.5

2020-02-01

Feature

• Picker: support cascade columns #4247
• Slider: add button-size prop 1e9b8c
• Optimize the props type. The original number type props now support string.

Style

• DropdownItem: add @dropdown-item-z-index less var 6f4c6f
• IndexBar: add @index-anchor-z-index less var 89ee8e
• IndexBar: add @index-bar-sidebar-z-index less var 89ee8e
• IndexBar: add @index-bar-index-active-color less var 0011db
• Notify: add @notify-text-color less var 9dcf57
• Overlay: add @overlay-z-index less var 95d19f
• Rate: add @rate-icon-disabled-color less var 8b8471
• Rate: add @rate-icon-full-color less var 5c804c
• Rate: add @rate-icon-void-color less var f90015
• Slider: add @slider-bar-height less var a5819c
• Search: add @search-content-background-color less var ea7419
• Step: add @step-active-color less var 9e7a68
• Tabbar: add @tabbar-z-index less var 0441f7
• NavBar: add @nav-bar-z-index less var a2d870
• NumberKeyboard: add @number-keyboard-z-index less var 760938

Bug Fixes

• ImagePreview: limit max-zoom when double clicking 1baa60
• Popup: duration prop not work when position is center 44072e
• Step: active-color should be effective for line cfadce

v2.4.4

2020-01-24

Feature

• Card: change thumb fit mode to cover e766d5
• Calendar: add get-contaienr prop #5609
• Calendar: add close-on-popstate prop 2b82dc
• CountDown: add change event #5599
• GoodsActionButton: add icon prop b83bed

Bug Fixes

• Sku: get-container can be string type #5608

v2.4.3

2020-01-19

Feature

• Calendar: add max-range、range-prompt prop #5583
• ImagePreview: add @image-preview-index-text-shadow var e2f302
• Stepper: add long-press prop 2f3ec6
• Swipe: pause autoplay when page hidden 113157

Improvement

• Icon: update share icon 2f77ac
• Field: imporve readonly cursor 60173d
• Stepper: improve disable-input behavior 959eca

Bug Fixes

• Calendar: should show range prompt after select ff0901
• GoodsAction: should set wrapper height #5593

Types

• Calendar: fix missing type definition #5588
• Toast: incorrect definition of setDefaultOptions method #5582

v2.4.2

2020-01-14

Feature

• Sku: add properties prop #5525
• Field: add digit type #5524
• Image: add error-icon prop #5470
• Image: add loading-icon prop #5469
• Field: add formatter prop #5534
• Swipe: add prev、next method #5548
• GoodsAcitonIcon: add color prop #5576

Improvement

• AddressEdit: show error message in field #5479
• ActionSheet: update close icon style #5574
• AddressList: update style #5507
• CouponList: update style #5501
• Calendar: scroll to current month when show #5526
• ImagePreview: improve error image style #5570
• improve cursor of all components c1a535

Bug Fixes

• Button: should not have click feedback when loading 0a70d3
• Card: thumb image border-radius become effective #5480
• Calendar: incorrect month title after auto scroll #5569
• Calendar: missing info when selected #5536
• Checkbox: only the icon is clickable when label-disabled 3d10d4
• CouponList: incorrect click feedback #5521
• Field: should limit number input in iOS #5520
• ImagePreview: disable desktop browser image drag #4487
• Picker: optimize the click experience 5cbb9e
• PullRefresh: should set height when using head-height 028747
• Tabs: can not render line when wrapper is fixed #5496

v2.4.1

2020-01-02

Feature

• ContactEdit: show error message in field #5437
• CouponCell: prefer to use value over denominations #5438

Bug Fixes

• Calendar: fix incorrect day offset #5452
• List: fix incorrect reaching edge condition when direction is up #5439

v2.4.0

2020-01-01

New Component

• add Calendar component

Feature

• List: add error slot e9a938
• List: add finished slot 8a0705
• PullRefresh: add success slot 56e450
• CouponList: update button style #5368
• DatetimePicker: add getPicker method 1dc1fe
• Image: add @image-loading-icon-size、@image-error-icon-size var d7ae8c
• Picker: add confirm method 5eb2a4
• TreeSelect: add @tree-select-item-selected-size var 373159

Compatibility

• NumberKeyboard: avoid Vue 2.6 event bubble issues #5349
• Picker: avoid Vue 2.6 event bubble issues by manually binding events #5345
• PullRefresh: avoid Vue 2.6 event bubble issues #5347
• Rate、Slider: avoid Vue 2.6 event bubble issues #5350
• Swipe: avoid Vue 2.6 event bubble issues #5346
• SwipeCell: avoid Vue 2.6 event bubble issues #5348

Bug Fixes

• ImagePreview: close event triggered twice #5411
• ImagePreview: should not emit close event after tapped when using async-close #5410
• PullRefresh: failed to trigger pull refresh when scrolling e00058
• Tag: incorrect transition when set closeable dynamically fe6e2f
• Tag: should not trigger click event when close #5351
• Toast: may lose forbid click when has multiple toasts #5398
• Icon: should compatible with medel-o 7b905a
• IndexBar: incorrect anchor position when anchor doesn't have a parent node #5429
• Picker: compatible with desktop scenario #5430
• Stepper: input disabled text color in safari #5428

Types

• AddressEdit: add setAddressDetail method type #5352
• Area: add reset method type #5353
• Checkbox: add toggle method type #5354
• CountDown: add methods types 0438bd
• DropdownItem: add toggle method type 5c1883
• Field: add focus、blur method type 0b5c8e
• List: add check method type 285bce
• Picker: add method types 46d2b0
• Sku: add methods types d2bb9f
• Swipe: add swipeTo、resize method types a1831b
• SwipeCell: add open、close method type 9a9676
• Tabs: add resize method type 3c526e
• Uploader: add closeImagePreview method type cf191e

v2.3.3

2019-12-21

Bug Fixes

• fix compile error when using babel-plugin-import

v2.3.2

2019-12-20

Bug Fixes

• fix Area missing style
• fix DatetimePicker missing style
• fix CountDown infinite tick if call reset after finish #5340
• fix ImagePreview onClose should only trigger once #5341

v2.3.1

2019-12-20

Bug Fixes

• Fix uncompiled ES6 code in the entry file

v2.3.0

2019-12-20

Style

Upgrading the style of business components:

• AddressEdit
• Card
• CouponList
• ContactList
• ContactCard
• ContactEdit
• SubmitBar

Features

• use @vant/cli to build pacakge
• AddressList: add default-tag-text prop #5106
• Card: add price-top slot #5134
• Checkbox: improve toggleAll perf #5285
• Circle: add stroke-linecap prop #5087
• CouponList: add show-count prop #5139
• CountDown: support SS and S format #5154
• ContactList: add default-tag-text prop #5089
• ContactCard: add show-set-default prop #5083
• ContactCard: add set-default-label prop #5083
• Sku: add start-sale-num prop #5105
• Sku: add resetSelectedSku method #5318
• SubmitBar: add text-align prop #5130
• SwipeCell: add open event #5324
• SwipeCell: add before-close prop #5320
• Tab: add dot prop #5272
• Tab: add info prop #5274
• Tab: add rendered event #5315
• Tab: add scrollspy prop #5273
• Toast: improve type definitions #5086

Bug Fixes

• fix ActionSheet should not submit form #5181
• fix Card allow use bottom slot without price or num #5116
• fix Dialog show not trigger close event when hidden #5267
• fix DropdownMenu incorrect menu position when scroll #5313
• fix Icon medal typo #5242
• fix NumberKeyboard should not trigger blur event when hidden #5110
• fix Picker should not submit form #5182
• fix Popup should reopen when activated #5286
• fix Stepper should format value when max、min changed #5257
• fix Sku should check state when reset #5231
• fix Switch incorrect size prop type #5229
• fix SubmitBar incorrect decimal when price is integer #5224
• fix Sku stepper value must be integer #5202
• fix Sku stepper should not emit invalid num #5210
• fix Stepper should not submit form #5183
• fix TreeSelect should sync value before trigger click-item event #5153
• fix TouchEmulator compatibility issues on firefox #5118
• fix Uploader not trigger oversize event when upload same file #5177
• fix less import issue #5157

v2.2.16

2019-12-03

Features

• Stepper: add disable-plus props #5180
• Stepper: add disable-minus props #5180

v2.2.15

2019-11-28

Bug Fixes

• fix List incorrect list status in some cases

v2.2.14

2019-11-22

Features

• Tabs: add title-style prop #5048
• Tabs: add resize method #5071
• Swipe: add resize method #5070

Bug Fixes

• fix Cell should break word of value #5029
• fix Field incorrect count of line break in safari #5049
• fix Tabbar incorrect style when using safe-area-inset-bottom #5079
• fix SwipeCell compatible with desktop scenario #5077
• fix DropdownMenu should't close when custom container and get clicked #5047

v2.2.13

2019-11-14

Features

• Area: add swipe-duration prop #5014
• Swipe: add stop-propagation prop #4972
• Toast: add overlay option #4969
• Toast: add clickOnClickOverlay option #4967
• SwipeCell: add opened event #4986
• ActionSheet: add close-icon prop #5016
• DropdownItem: add title slot #4975
• DatetimePicker: add swipe-duration prop #5015

Bug Fixes

• fix Tab can't match when name is 0 #5017
• fix Indexbar incorrect anchor position when hidden #5012
• fix Indexbar incorrect anchor position when set sticky-offset-top #5012
• fix DatetimePicker can't change when filter when empty array #4973
• fix DateTimePicker incorrect value when set max-hour or max-minute #5006
• fix ImagePreview missing swipeDuration type definition #4968

v2.2.12

2019-11-07

Features

• Stepper: add name prop #4931
• Uploader: add deletable prop #4925

Bug Fixes

• fix Sku set min-height for sku body #4942
• fix List may trigger load event repeatedly #4953
• fix can't custom hairline border color #4939

v2.2.11

2019-11-04

Features

• Switch: add click event #4915
• Switch: support number type of size prop #4913
• Toast: change default duration to 2s #4886
• Uploader: add closeImagePreview method #4901

Bug Fixes

• fix Button loading color #4868
• fix CountDown should clear timer when destroyed #4918
• fix CountDown should pause timer when deactivated #4919
• fix Grid info、dot prop not work when use icon slot #4902

v2.2.10

2019-10-27

Features

• Icon: add font-display auto property #4831
• Popup: add close-on-popstate prop #4845
• Picker: add swipe-duration prop #4816
• Toast: support set default options of specfic type #4848

Bug Fixes

• fix Uploader file preview border radius #4846
• fix DatetimePicker incorrecrt initial value when use min-date and filter #4837

v2.2.9

2019-10-20

Features

• Tag: add closeable prop #4763
• Loading: add some less vars #4781
• Progress: add some less vars #4790
• Progress: add track-color prop #4789
• Toast: add @toast-loading-icon-color var #4782
• Picker: add @picker-loading-icon-color var #4787
• ImagePreview: add cover slot #4766

Bug Fixes

• fix Tag incorrect round radius #4762
• fix Sku emit sku-selected event when reset sku #4755
• fix ImagePreview should not close when click index #4764
• fix AddressEdit choose overseas failure when configuring placeholer #4769

v2.2.8

2019-10-17

Features

• Dialog: update border radius #4730
• Uploader: update delete icon style #4712
• Field: add show-word-limit prop #4721
• Stepper: limit decimal length when input #4747
• Slider: improve click area #4701
• ActionSheet: add description prop #4691
• Slider: add slide animation #4700
• add gradient color variables #4752
• add multi-line ellipsis classes #4690

Bug Fixes

• fix AddressEdit area confirmation verification #4724
• fix Rate incorrect height caused by inline-block #4693
• fix Slider pseudo element may casue body overflow-x #4699

v2.2.7

2019-10-11

Features

• Dialog: add width prop #4687
• Dialog: add overlay-class prop #4683
• Dialog: add overlay-style prop #4682
• Uploader: add file result-type #4680
• TreeSelect: add className option #4671

Bug Fixes

• fix Dialog avoid text blurry #4686
• fix Stepper can't work when step is small #4675
• fix DatetimePicker should update value when range changed #4676
• fix Field incorrect placeholder color when error and disabled #4666

v2.2.6

2019-10-08

Features

• Grid: add icon-size prop #4656
• Toast: add transition option #4638
• Dialog: add transition prop #4636
• Dialog: add open、close event #4633
• Dialog: add opened、closed event #4634
• NumberKeyboard: add extra-key slot #4644
• CheckboxGroup: add toggleAll method #4640

Bug Fixes

• fix AddressList input event triggered twice #4659
• fix Tabs incorrect padding when type is card #4658
• fix GoodsAction incorrect border radius #4653
• fix NumberKeyboard compatible with Vue 2.6 event bubble bug #4632

v2.2.5

2019-09-28

Features

• Picker: add columns-top slot #4607
• Picker: add columns-bottom slot #4607
• Overlay: add default slot #4571
• Overlay: add custom-style prop #4572
• Checkbox: add bind-group prop #4600
• DropdownItem: add get-container prop #4611
• Area: add columns-placeholder prop #4580
• AddressEdit: add area-columns-placeholder props #4584

Bug Fixes

• fix Overlay type definition missing #4601
• fix Swipe incorrect swipeTo animation #4570
• fix Uploader incorrect preview index when upload same images #4577

v2.2.4 [Deprecated]

2019-09-28 🇨🇳

Tips

• There is a style loss issue in this version, please use version 2.2.5

v2.2.3

2019-09-24

Features

• Cell: improve accessibility #4519
• Popup: improve accessibility #4516
• Search: improve accessibility #4522
• Picker: improve accessibility #4521
• GridItem: improve accessbility #4517
• ActionSheet: improve accessibility #4525
• Sku: add sku item previewImgUrl #4562
• ActionSheet: enable round by default #4542
• RadioGroup: add icon-size prop #4529
• RadioGroup: add checked-color prop #4532
• CheckboxGroup: add icon-size prop #4530
• CheckboxGroup: add checked-color prop #4531
• ActionSheet: enable safe-area-inset-bottom by default #4524
• NumberKeyboard: enable safe-area-inset-bottom by default #4544

v2.2.2

2019-09-19

Features

• Dialog: improve word wrap #4506
• Search: add action-text prop #4501
• Popup: add close-icon-position prop #4507
• Uploader: add index param in events #4460
• GoodsActionButton: increase height #4461
• AddressList: add @address-list-item-radio-icon-color var #4481

Bug Fixes

• fix Field disabled color in safari #4508
• fix ImagePreview incorrect scale #4477
• fix DatetimePicker infinite loop when use formatted text is unnumeric #4485

v2.2.1

2019-09-12

Features

• Icon: add dot prop #4425
• Icon: add down、wap-home icon #4404
• Circle: update text style #4401
• GridItem: add dot prop #4426
• GridItem: add info prop #4424
• Progress: add stroke-width prop #4397
• Popup: add safe-area-inset-bottom prop #4419
• Tab: add to、url、replace prop #4422
• TreeSelect: add dot option #4433
• Stepper: add decimal-length prop #4443
• Sku: add stock-threshold prop #4444
• Sku: add safe-area-inset-bottom prop #4428
• Sku: update sku style #4437
• SidebarItem: add dot prop #4432

Bug Fixes

• fix Sku incorrect button position #4427
• fix Uploader should't emit click-preview when delete #4407
• fix Progress incorrect pivot position #4396

v2.2.0

2019-09-06

Features

• Style: update basic red color #4368
• Rate: add touchable prop #4361
• Rate: should be inline-block #4334
• Rate: optimize touchmove gesture #4336
• Popup: add closeable prop #4362
• Popup: add close-icon prop #4366
• Sidebar: remove border #4382
• SidebarItem add disabled prop #4325
• TreeSelect: add max prop #4323
• TreeSelect: support show info #4384
• Uploader: add close-preview event #4376
• ImagePreview: add image loading tip #4378

Bug Fixes

• fix Field should reset appearance in safari #4380
• fix Button should hide border when color is linear-gradient #4342
• fix Dialog should reset loading when closed #4352
• fix Slider should format initial value #4337
• fix Sidebar incorrect info position #4324
• fix DropdownItem missing default active color #4330
• fix NumberKeyboard incorrect button position in iphoneX #4304
• fix ImagePreview should reset scale after toggle #4319
• fix ImagePreview should emit change event when reset to start position #4320

v2.1.8

2019-08-29

Features

• Picker: add allow-html prop #4278
• PasswordInput: add focused prop #4279
• GoodsActionButton: add color prop #4255
• Button: color prop support linear-gradient #4252

Bug Fixes

• fix Circle stroke-width can't be greater than 60 #4256
• fix Picker should avoid click event when moving #4273
• fix Picker incorrect position when pause momentum #4277

v2.1.7

2019-08-26

Bug Fixes

• fix RadioGroup disabled prop not work #4242
• fix CheckboxGroup disabled prop not work #4242

v2.1.6

2019-08-26

Features

• Tag: add warning type #4232
• Image: add radius prop #4230
• Notify: add type prop #4237
• CellGroup: add title slot #4227
• Sku: initialSku can be set dynamically #4214
• Sku: can preview images of non-first level sku #4236
• Locale: add Spanish translation #4235

• fix Tabbar incorrect active style in route mode #4229
• fix NumberKeyboard incorrect sidebar position when has title #4228
• fix IndexBar the problem of rolling out parent boundaries when sticky bottom #4218

v2.1.5

2019-08-23

Features

• Toast: add closeOnClick option #4192
• Uploader: add image-fit prop #4189
• Uploader: add click-preview event #4206
• Uploader: add preview-full-image prop #4205
• DropdownMenu: add @dropdown-menu-title-active-text-color less var #4208

Bug Fixes

• fix IndexBar sticky bug #4184
• fix NumberKeyboard border color #4183
• fix Area can't select some oversea countries #4195

v2.1.4

2019-08-21

Features

• Col: add click event #4169
• Row: add click event #4170
• Area: add is-oversea-code prop #4163
• Circle: support gradient color #4157
• Circle: support number type of size prop #4160
• Tabbar: support match route by to.name #4148
• Sku: should close image preview when popstate #4152
• Uploader: should close image preview when popstate #4151
• Uploader: support more image types #4140
• TreeSelect: support multiple select #4130
• TreeSelect: active-id support sync modifier #4133
• TreeSelect: main-active-index support sync modifier #4132

Bug Fixes

• fix Sku unextracted i18n message #4172
• fix Tabbar avoid navigation duplicated #4147
• fix Field button width shrinked in firefox #4144
• fix Picker prevent style be override by base.css #4136

v2.1.3

2019-08-15

Features

• Sku: support i18n #4123
• Button: add color prop #4124
• Collapse: log tips for incorrect value #4122
• Uploader: add before-delete prop #4118
• TreeSelect: add content slot #4105
• TreeSelect: support string type of height prop #4107
• NumberKeyboard: improve click experience #4116

Bug Fixes

• fix DropdownMenu incorrect style when inside NavBar #4098
• fix Tab incorrect title position when insert tab pane #4091
• fix Icon service-o icon incomplete #4088
• fix Icon gift-o、refund-o icon incomplete #4089
• fix Slider should not emit change event when value not changed #4087

v2.1.2

2019-08-10

Features

• ActionSheet: add color option #4073
• AddressEdit: add postal-validator prop #4067
• Stepper: add show-plus、show-minus prop #4056
• Divider: add separator role to improve accessibility #4069
• DropdownMenu: add more less vars #4071
• Uploader: support isImage flag #4072
• Field: increase clickable area of icon #4058
• Picker: stop propagation when touchmove in vertical direction #4043
• Icon: add warning、good-job、good-job-o icon #4038
• Icon: add smile、music、thumb-circle、phone-circle icon #4048
• List: unify text font-size #4077
• Image: img inherit round border #4032
• adjust globalObject to support module script #4080

Bug Fixes

• fix Sticky incorrect position when inside scroll container #4055

v2.1.1

2019-08-02

Bug Fixes

• fix DatetimePicker event not work #4027
• fix Popup ensure z-index setting order #4026

v2.1.0 [deprecated]

2019-08-01

Features

• GoodsAction: update style #3967
• Sku: update style #3875 #3922
• Sku: add price-tag prop #3875
• Sku: add hide-selected-text prop #3875
• Sku: add sku-header-origin-price slot #3958
• Dialog: add title slot #3985
• Dialog: centered in screen #3905
• Uploader: add less vars #3907
• ActionSheet: add less vars #3908
• AddressList: add click-item event #3942
• CouponList: add empty-image prop #3941
• SwipeCell: add stop-propagation prop #3952
• ImagePreview: add swipe-duration prop #3963

Bug Fixes

• fix Tabs incorrect line position in some cases #3961
• fix ImagePreview should reset onClose & onChange option #3960
• fix DatetimePicker incorrect confirm param when use formatter #3969
• fix Tabs fix scroll position deviation when sticky #3949
• fix IndexBar should update when index-list updated #3943
• fix AddressList can't select item when click empty area #3909
• fix ImagePreview Image beyond the screen height cover index #4002
• fix Radio: can't select when click gap #4007
• fix SwipeCell should not prevent touchmove when opened #3982

v2.0.9

2019-07-19

Features

• add Sticky component #3888
• Grid: optimize word break #3897
• Image: add round prop #3838
• Image: add show-error prop #3896
• Image: add show-loading prop #3893
• Toast: add iconPrefix option #3872
• Toast: optimize image icon display #3895
• TreeSelect: add click-nav、click-item event #3892
• ActionSheet: add round prop #3874
• Uploader: support preview network image #3899

Bug Fixes

• fix Dialog closeOnPopstate can't be disabled #3868
• fix DropdownMenu cann't use toggle to open item #3876
• fix SwipeCell should stop event propagation #3898

v2.0.8

2019-07-16

Features

• Sku: support custom placeholder #3864
• DropdownMenu: add icon option #3855
• DropdownMenu: optimize title ellipsis #3847
• ImagePreview: support double click zoom #3839

Bug Fixes

• fix Tab: click event param missing #3866
• fix List not work when body is the scrolling container #3844
• fix IndexBar incorrect active anchor in some cases #3832

v2.0.7

2019-07-11

Features

• add CountDown component #3805
• Popup: add round prop #3781
• PullRefresh: add distance of slotProps #3829
• DropdownMenu: add close-on-click-outside prop #3824
• Swipe: add immediate option of swipeTo method #3821
• Slider: support number type of bar-height prop #3794
• IndexBar: add sticky-offset-top prop #3791

Bug Fixes

• fix Popup overlay may cover popup in some cases #3831
• fix Stepper add hack for iOS 12 page scroll #3804
• fix Dialog missing closeOnPopstate in type definition #3789
• fix DatetimePicker confirm event param incorrect when use filter #3816

v2.0.6

2019-07-05

Features

• add Divider component #3755
• Tab: add name prop #3762
• Sku: add add-cart-text prop #3725

Bug Fixes

• fix Swipe fix blank area when use width prop #3751
• fix Grid gutter can be string type #3741
• fix Collapse use double raf to ensure animation can start #3723
• fix PullRefresh ensure value change can be watched #3719

v2.0.5

2019-07-02

Features

• Stepper: add button-size prop #3714
• Stepper: support long press gesture #3711
• Dialog: add close-on-popstate prop #3709

Bug Fixes

• fix postcss config overwritten issue

v2.0.4

2019-07-01

Features

• add Grid、GridItem component #3669 #3682 #3683
• Field: add arrow-direction prop #3679
• Sidebar: add to、replace prop #3696
• Sidebar: support use v-model to bind active key #3698
• IndexBar: add class for active index #3692
• Uploader: support number type of name prop #3681
• SwipeCell: add name prop #3680
• AddressEdit: add detail-maxlength prop #3707
• GoodsActionIcon: add icon slot #3705

Bug Fixes

• fix Collapse flick in safari #3686
• fix Picker compatibility issues on lower versions of Android #3688

v2.0.3

2019-06-27

Features

• ActionSheet: add duration prop #3608
• ActionSheet: add open、opened events #3639
• ActionSheet: add close、closed events #3639
• Icon: add fit mode for image content #3667
• Icon: update checked、comment、comment-o icon #3615
• ImagePreview: add onChange option #3630
• Popup: optimize overlay animation duration #3610
• Uploader: support preview non-image file #3604
• Uploader: support click to preview image #3603
• Stepper: add less vars #3599

Bug Fixes

• fix ImagePreview should lock scroll #3645
• fix Tab may cause error when render title slot #3631
• fix vetur auto-complete #3617

v2.0.2

2019-06-21

Features

• Card: add click-thumb event #3586
• CouponList: add enabled-title、disabled-title props #3578
• Slider: min/max can set any value #3566
• Uploader: before-read prop support promise mode #3572
• Picker: update acceleration rate #3556
• NumberKeyboard: support v-model #3531
• NumberKeyboard: add maxlength prop #3532
• add sideEffects to enable tree shaking #3530

Bug Fixes

• fix Button default margin in safari #3577
• fix Sku can not preview image when only have goods picture #3569
• fix Toast missing type definition of clear method #3542

v2.0.1

2019-06-15

Features

• Tab: support string type of line-width & line-height #3514
• Icon: use image component to display image #3515
• Toast: add icon prop #3485
• DropdownMenu: add direction prop #3490
• NumberKeyboard: add delete slot #3499

Bug Fixes

• fix Image missing type definition #3520
• fix SwitchCell incorrect loading position #3501
• fix Toast missing fade-out transition in multiple mode #3504
• fix Locale can not modify functional message #3498

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

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。

---

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
• SupportString 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

• SupportNumber 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