Changelog
Important Notice
To avoid redundant maintenance and reduce costs.
From v4.9.0, Vant's changelog will be published on GitHub's Releases Page. This page will no longer be updated.
The current document contains the changelog for Vant v4.0.0 ~ v4.9.0. For other versions, please refer to:
Intro
Vant follows Semantic Versioning 2.0.0.
Release Schedule
- Patch version:Typically released every 1 to 2 weeks, including new features and bug fixes.
- Minor version:Typically released every 1 to 2 months, including new components or significant feature updates, with backward compatibility.
- Major version:No fixed release time, includes breaking changes and major feature updates.
Details
v4.9.0
2024-05-02
New Features 🎉
- feat(Calendar): add switch-mode prop by @inottn in #12836
- feat(PickerGroup): add new prop showToolbar by @ReinoFu in #12839
- feat(CLI): support for configuring Rsbuild by @chenjiahan in #12809
Bug Fixes 🐞
- fix(cli): Vue SFC style binding failure by @zoy-l in #12799
- fix(ImagePreview): swipeItem may be undefined by @inottn in #12818
- fix(Highlight): render correctly when keywords is empty by @Jungzl in #12829
- fix(IndexBar): render active anchor correctly when passing sticky & stickyOffsetTop by @Jungzl in #12837
Document 📖
- docs: remove all Gitee links by @chenjiahan in #12845
- docs: remove gzip size badge by @chenjiahan in #12847
- docs: fix Rsbuild HTML build failed by @chenjiahan in #12848
Other Changes
- chore(deps): update dependency terser to ^5.30.3 by @renovate in #12795
- chore(deps): update dependency eslint-plugin-vue to ^9.25.0 by @renovate in #12794
- chore(deps): update all patch dependencies by @renovate in #12773
- chore(workflow): upgrade to pnpm v9 by @chenjiahan in #12808
- chore: bump github-pages-deploy-action@v4.6.0 by @chenjiahan in #12810
- chore(deps): update dependency @vitejs/plugin-vue to v5 by @renovate in #12840
- chore(deps): update dependency commander to v12 by @renovate in #12841
- chore(deps): update actions/setup-node action to v4 by @renovate in #12814
- chore(deps): update github/issue-labeler action to v3.4 by @renovate in #12813
- chore(deps): update codecov/codecov-action action to v4 by @renovate in #12815
- chore(deps): update all patch dependencies by @renovate in #12812
New Contributors
v4.8.11
2024-04-14
New Features 🎉
Bug Fixes 🐞
- fix: warning
is not a valid value for v-model
in JetBrains IDE by @anyesu in #12787 - fix(Cli): remove site tsconfig by @chenjiahan in #12792
Document 📖
- docs(list): update Error loading module code by @wangjue666 in #12778
Other Changes
- chore(deps): update dependency eslint-plugin-vue to ^9.24.1 by @renovate in #12774
- chore(deps): bump Rsbuild v0.6 by @chenjiahan in #12790
New Contributors
- @wangjue666 made their first contribution in #12778
- @anyesu made their first contribution in #12787
v4.8.10
2024-04-06
New Features 🎉
- feat(TimePicker): support confirm and getSelectedTime methods by @bluesky335 in #12761
- feat(DatePicker): support confirm and getSelectedDate method by @bluesky335 in #12762
- feat(Coupon): support for checkbox usage by @CatsAndMice in #12744
Other Changes
- chore(deps): update dependency vite to v5.0.13 [security] by @renovate in #12767
- chore(deps): update all patch dependencies by @renovate in #12756
- chore(deps): update dependency @types/lodash to ^4.17.0 by @renovate in #12757
- chore: correct return type of getSelectedTime by @chenjiahan in #12768
- refactor(Coupon): simplify the checkbox usage by @chenjiahan in #12771
New Contributors
- @bluesky335 made their first contribution in #12761
v4.8.9
2024-04-06
Invalid version, please do not use it.
v4.8.8
2024-03-31
New Features 🎉
- feat(image-preview): export onLoad and style for image slot by @chouchouji in #12740
- feat(AddressList): add event param for click-item by @chenjiahan in #12748
Bug Fixes 🐞
- fix(floating-bubble): update offset when the value changed by @chouchouji in #12730
- fix(vant-cli): support defineOptions named by @wChenonly in #12734
- fix(PickerGroup): rendering correctly when using v-for by @inottn in #12732
- fix(TextEllipsis): should recalculate the ellipsis state when the component is activated by @inottn in #12741
Document 📖
- docs(button): Keep Chinese and English documents consistent by @chouchouji in #12708
- docs(cell): correct the type of label by @chouchouji in #12721
- docs(ImagePreview): add image slot scale guide by @chenjiahan in #12751
Other Changes
- chore(deps): update dependency vue-router to v4.3.0 by @renovate in #12702
- chore(deps): update dependency esbuild to ^0.20.0 by @renovate in #12696
- chore(workflow): let renovate bump package.json by @chenjiahan in #12714
- chore(deps): update dependency eslint to ^8.57.0 by @renovate in #12723
- chore(docs): update the vue3-vant-mobile reference by @CharleeWa in #12735
- chore(deps): update dependency commander to ^11.1.0 by @renovate in #12718
- chore(deps): update dependency enquirer to v2.4.1 by @renovate in #12695
- chore(deps): update dependency @vue/test-utils to ^2.4.5 by @renovate in #12716
- chore(deps): bump Rsbuild v0.5 by @chenjiahan in #12747
- chore(deps): update dependency eslint-config-prettier to ^9.1.0 by @renovate in #12724
- chore(deps): update dependency fs-extra to ^11.2.0 by @renovate in #12745
- chore(deps): update dependency highlight.js to ^11.9.0 by @renovate in #12746
- chore(deps): update dependency fast-glob to ^3.3.2 by @renovate in #12731
- chore(deps): update dependency less to ^4.2.0 by @renovate in #12752
- chore(workflow): let renovate group patch updates by @chenjiahan in #12754
New Contributors
- @CharleeWa made their first contribution in #12735
v4.8.7
2024-03-18
Other Changes
- Revert "chore(deps): update dependency typescript to v5.4.2" by @renovate in #12700
- chore: Update homepage by @yoyo837 in #12704
v4.8.6
2024-03-17
New Features 🎉
- feat(ImagePreview): add vertical prop by @suncohey in #12660
- feat(signature): export clear and submit method by @chouchouji in #12654
- feat: support unplugin-auto-import plugin by @DragonnZhang in #12679
- feat(ActionSheet): add icon support to the actions data by @wjw-gavin in #12671
Bug Fixes 🐞
- fix(ImagePreview): allow user to swipe to next image when the current image is moved to the edge by @inottn in #12666
- fix(ActionSheet): icon class name by @chenjiahan in #12701
Document 📖
- docs(ImagePreview): add vertical prop by @chenjiahan in #12663
- docs: change tab's 'Before Change' into a real async function by @gxy5202 in #12693
Other Changes
- chore(deps): bump Rsbuild 0.4.12 by @chenjiahan in #12665
- chore(deps): update dependency @vue/test-utils to v2.4.5 by @renovate in #12681
- chore(deps): update dependency autoprefixer to v10.4.18 by @renovate in #12682
- chore(workflow): disable dependency dashboard by @chenjiahan in #12686
- chore(deps): update dependency prettier to v3.2.5 by @renovate in #12685
- chore(deps): update rsbuild to v0.4.15 by @renovate in #12688
- chore(deps): update dependency eslint to v8.57.0 by @renovate in #12697
- chore(deps): update dependency typescript to v5.4.2 by @renovate in #12700
New Contributors
- @chouchouji made their first contribution in #12654
- @renovate made their first contribution in #12681
- @gxy5202 made their first contribution in #12693
- @DragonnZhang made their first contribution in #12679
v4.8.5
2024-02-25
New Features 🎉
Bug Fixes 🐞
Document 📖
- docs: update docs for params related to Picker events by @wjw-gavin in #12619
- docs(DatePicker): fix en-docs error by @wjw-gavin in #12620
- docs(Uploader): fix miss double quote by @nemo-shen in #12627
- docs: add full registration guide by @chenjiahan in #12628
- docs: add Rsbuild import on demand guide by @chenjiahan in #12629
Other Changes
- Revert "fix(DropdownMenu): fix recursive update when passing object literal to title-class (#12614)" by @inottn in #12617
- chore(deps): bump Rsbuild v0.4 by @chenjiahan in #12625
- chore(workflow): setup renovate config by @chenjiahan in #12626
- test: skip image SSR test case by @chenjiahan in #12644
New Contributors
v4.8.4
2024-02-03
New Features 🎉
- feat(Picker): allow to hidden to toolbar buttons by @chenjiahan in #12599
Bug Fixes 🐞
- fix(Sticky): initial sticky position by @nemo-shen in #12601
- fix(DropdownMenu): fix recursive update when passing object literal to title-class by @inottn in #12614
Document 📖
Other Changes
- chore(deps): bump Rsbuild 0.3.9 and enable clean dist by @chenjiahan in #12600
- chore: avoid workflow running on forked repo by @tolking in #12607
- chore(workflow): using new M1 macOS runner by @chenjiahan in #12615
v4.8.3
2024-01-20
New Features 🎉
- feat(Notify): add teleport prop by @inottn in #12556
- feat(TextEllipsis): add
action
slot by @nemo-shen in #12560 - feat(ImagePreview): add close-on-click-image prop by @inottn in #12566
- feat(icons): add icon
arrow-double-left
andarrow-double-right
by @nemo-shen in #12579 - feat(Toast): add z-index prop by @inottn in #12587
Bug Fixes 🐞
- fix(Tab): tab(with sticky prop) loss 'fixed' classname after switch tab by @nemo-shen in #12547
- fix(Image): ImagePosition type is not exported before by @Jungzl in #12549
- fix(Tabs): van-border-radius-sm to van-radius-sm by @edram in #12576
Document 📖
- docs(Lazyload): fix preLoad type error and spelling mistakes by @RSS1102 in #12554
- docs(home): update heading level by @inottn in #12577
Other Changes
- test: bump vitest v1.1.3 by @inottn in #12546
- chore(deps): bump Rsbuild to v0.3.2 by @chenjiahan in #12565
- chore(deps): bump vue to v3.4.13 by @inottn in #12567
- chore(deps): bump vite from 5.0.11 to 5.0.12 by @dependabot in #12588
New Contributors
v4.8.2
2024-01-03
New Features 🎉
- feat: support link css from shadow dom by @yoyo837 in #12526
- feat(DropdownMenu): add auto-locate prop by @inottn in #12251
Performance 🚀
- perf(CLI): improve markdown compile performance by @chenjiahan in #12541
Bug Fixes 🐞
- fix(ci): eslint on windows by @Jungzl in #12516
- fix(ImagePreview): double-scale and close-on-click-overlay may not work in certain scenarios by @inottn in #12521
Other Changes
- chore(deps): bump Rsbuild v0.2.8 by @chenjiahan in #12519
- chore(deps): bump Vue 3.4.0-beta.4 by @chenjiahan in #12520
- test: bump vitest v1.1.0 by @chenjiahan in #12522
- chore(deps): bump vite v5 by @chenjiahan in #12523
- chore(deps): bump esbuild v0.19 by @chenjiahan in #12524
- chore: lock Rspack v0.4.3 to fix CSS issue by @chenjiahan in #12525
- chore(workflow): adjust issue templates by @chenjiahan in #12528
- chore(workflow): update codesandbox URL by @chenjiahan in #12529
- chore: update vitest config by @inottn in #12530
- chore(deps): bump Rsbuild and Vue by @chenjiahan in #12532
- chore(ImagePreview): reuse isTap ref by @inottn in #12536
- test(Toast): reduce test run time by @inottn in #12538
- test(FloatingBubble): reduce test run time by @inottn in #12539
v4.8.1
2023-12-17
New Features 🎉
- perf(TextEllipsis): reuse windowWidth to avoid repeat calculations by @inottn in #12471
- feat(TextEllipsis): add the toggle instance method by @wjw-gavin in #12472
- feat(cli): bump Rsbuild v0.2.2 by @chenjiahan in #12502
Performance 🚀
- perf(cli): disable source map to make compilation faster by @chenjiahan in #12484
Bug Fixes 🐞
- fix(cli): remove unused script in template by @chenjiahan in #12482
- fix(TextEllipsis): fix missing param for toggle by @wjw-gavin in #12483
Document 📖
- docs(collapse): fix missing ref tags by @RSS1102 in #12460
- docs(collapse): fix translation Error by @RSS1102 in #12464
- docs(dialog): fix translation Error and keep the sample code the same by @RSS1102 in #12465
- docs(TreeSelect): correct variable names by @inottn in #12469
- docs: add Rsbuild scaffold guide by @chenjiahan in #12475
- docs(image-preview): usage of Supplementing className by @RSS1102 in #12491
- docs(Quickstart): unplugin-vue-components usage updated (#12499) by @wChenonly in #12500
Other Changes
- chore(workflow): add perf label for PR by @chenjiahan in #12473
- refactor(CLI): integrate Rsbuild to build website by @chenjiahan in #12481
- chore: bump Rspack 0.4.2 to fix Chinese path by @chenjiahan in #12496
- chore(deps): bump vite from 4.4.9 to 4.4.12 by @dependabot in #12493
New Contributors
v4.8.0
2023-11-19
New Component 🎉
- Added Highlight component, contributed by @wjw-gavin and @inottn ❤️ #12434
New Features
- feat(ImagePreview): expose resetScale method by @inottn in #12426
- feat(Checker): add checked and disabled params to the default slot by @inottn in #12436
- feat(Row): gutter support vertical space by @cc-hearts in #12439
Bug Fixes 🐞
- fix(Calendar): subtitle supports reactive by @cc-hearts in #12425
Document 📖
- docs(field): update props size by @Simon-He95 in #12429
- docs(cell): update props size by @Simon-He95 in #12427
- docs(Highlight): add version tip by @chenjiahan in #12438
- docs(Overlay): add set z-index demo by @chenjiahan in #12454
- docs: add Rsbuild to quickstart by @chenjiahan in #12455
Other Changes
- chore(deps): fix security alerts of babel and postcss by @chenjiahan in #12414
New Contributors
- @cc-hearts made their first contribution in #12425
v4.7.3
2023-10-29
New Features 🎉
- feat(locale): add Arabic Locale by @mo9a7i in #12381
- feat(Form): add required prop and support auto display by @chenjiahan in #12380
- feat(auto-import-resolver): add module option by @chenjiahan in #12383
- style: replace word-break with overflow-wrap by @wjw-gavin in #12396
- feat(Tab): add show-header prop by @yoyo837 in #12394
- style(Search): use consistent padding when display error msg by @chenjiahan in #12409
- feat(Signature): expose resize method by @inottn in #12405
Bug Fixes 🐞
- fix(ConfigProvider): export missing theme vars by @inottn in #12371
- fix(AddressEdit): area field validate error when showArea is false by @zhousg in #12393
- fix(@vant/area-data): add exports types by @Alkaidcc in #12397
- fix(Search): fix search style when has error message by @johnsonwong666 in #12385
- fix(PickerGroup): only filter Comment vnode by @zhousg in #12402
Document 📖
- docs(auto-import-resolver): add doc for importStyle option by @chenjiahan in #12382
- docs(Tab): keep docs and example the same by @wjw-gavin in #12395
- chore: add vscode-common-intellisense to the Community Ecosystem by @Simon-He95 in #12406
- docs(Signature): add resize method by @chenjiahan in #12411
- docs(progress): remove outdated resize method by @chenjiahan in #12412
Other Changes
- chore(Field): required label css will active when rules contain required by @morance in #12376
- test(ImagePreview): fix incorrect onClose test case by @chenjiahan in #12386
- chore: forked repo, skip CI running by @yoyo837 in #12410
New Contributors
- @morance made their first contribution in #12376
- @mo9a7i made their first contribution in #12381
- @Alkaidcc made their first contribution in #12397
- @johnsonwong666 made their first contribution in #12385
v4.7.2
2023-10-15
New Features 🎉
- feat(Icon): add font-family css var by @JeremyFan in #12354
- feat(ImagePreview): add doubleScale option by @coderXMin in #12360
Bug Fixes 🐞
- fix(Icons): compatible with the browser range of Vant 2 by @chenjiahan in #12356
- fix(Uploader): multiple reupload only choose one & cancel chose problem by @zhousg in #12359
Other Changes
- refactor(Signature): avoid setting the canvas width and height in the next tick by @inottn in #12347
- refactor(Signature): use scale method to enhance clarity by @inottn in #12363
- chore(deps): bump rslog v1.1.0 by @chenjiahan in #12364
- chore(cli): merge greet logs by @chenjiahan in #12365
- chore(ImagePreview): rename doubleScale and add test case by @chenjiahan in #12366
New Contributors
- @coderXMin made their first contribution in #12360
v4.7.1
2023-10-06
New Features 🎉
- feat(FloatingPanel): optimize bounce animate by @zhousg in #12317
- feat(cli): using rslog by @chenjiahan in #12334
- style(Swipe): declare transition-property by @chenjiahan in #12336
- feat(Notify): add JSDoc for utility functions by @chenjiahan in #12342
- feat(Dialog): add JSDoc for utility functions by @chenjiahan in #12343
- feat(Toast): add JSDoc for utility functions by @chenjiahan in #12344
Bug Fixes 🐞
- fix(Popup): fix failed to inherit scopedId by @chenjiahan in #12327
- fix(CellGroup): failed to inherit scopeId with title by @chenjiahan in #12328
- fix(Popover): failed to inherit scopedId by @chenjiahan in #12329
Document 📖
- docs: fix typo in Form by @zcvvvbb in #12322
- docs: add more ecosystem projects by @chenjiahan in #12338
- docs(ImagePreview): improve English document by @chenjiahan in #12345
- docs: mistypo Georqia to Georgia by @mahnunchik in #12331
Other Changes
- chore(Swipe): limit the decimal length of transform by @chenjiahan in #12337
- chore: bump pnpm v8.8.0 by @chenjiahan in #12339
- chore(deps): bump postcss from 8.4.27 to 8.4.31 by @dependabot in #12341
New Contributors
- @zcvvvbb made their first contribution in #12322
- @mahnunchik made their first contribution in #12331
v4.7.0
2023-09-24
🍭 Icon Updates
- Icon: add new
user
icon - Icon: add new
notes
icon - Icon: add new
newspaper
icon - Icon: add new
list-switch
icon - Icon: add new
list-switching
icon - Icon: add a filled
records
icon - Icon: add a filled
contact
icon - Icon: add a filled
discount
icon - Icon: add a filled
completed
icon - Icon: add a filled
description
icon - Icon: add a filled
cash-back-record
icon - Icon: rename the previous
records
icon torecords-o
- Icon: rename the previous
contact
icon tocontact-o
- Icon: rename the previous
discount
icon todiscount-o
- Icon: rename the previous
completed
icon tocompleted-o
- Icon: rename the previous
description
icon todescription-o
- Icon: rename the previous
cash-back-record
icon tocash-back-record-o
New Features 🎉
- feat(Calendar): add click-disabled-date event by @LadyChatterleyLover in #12274
- feat(Uploader): add --van-uploader-border-radius css variables by @xieyezi in #12280
- feat(SwipeCell): fix triggered close by clickAway when in running beforeClose by @nined9 in #12309
- feat(AddressEdit): add change event for name and tel input by @zhousg in #12310
- types(Dialog): improve showDialog return type by @chenjiahan in #12316
Bug Fixes 🐞
- fix(Picker): fix bug the content of the popup window is not consistent with the Chinese version under the English version by @lllomh in #12300
- fix(Signature): fix checking if canvas is empty when backgroundColor is set by @sywyyhykkk in #12304
- fix(FloatingPanel): dragging down causes the page to move by @zhousg in #12314
Document 📖
- docs(Picker): improve picker document by @MrXwq in #12275
- docs(Uploader): add FAQ about camera permission by @chenjiahan in #12289
Other Changes
- test(Dialog): enable function-call test cases by @chenjiahan in #12315
- fix(cli): allow missing build script when releasing by @chenjiahan in #12292
New Contributors
- @nined9 made their first contribution in #12309
- @sywyyhykkk made their first contribution in #12304
v4.6.8
2023-09-10
New Features 🎉
- feat(Cell): add CSS vars to customize font size of the value by @inottn in #12260
- feat(ConfigProvider): supplement the type declaration of ConfigProviderThemeVars by @xieyezi in #12264
- feat(NavBar): add leftDisabled and rightDisabled prop by @m-xlsea in #12258
Bug Fixes 🐞
- fix(ConfigProvider): failed to set some basic theme vars by @chenjiahan in #12272
- fix(ConfigProvider): ConfigProviderThemeVars fontSizeXs hump by @xieyezi in #12267
Document 📖
- docs(NavBar): add disable button demo by @chenjiahan in #12270
Other Changes
- chore(CI): enable single-commit to reduce the repo size by @chenjiahan in #12268
- chore(CI): bump actions version by @chenjiahan in #12269
- chore: move axure to vant-assets repo by @chenjiahan in #12271
New Contributors
v4.6.7
2023-09-04
New Features 🎉
- feat(vant-use): add useRaf by @Simon-He95 in #12211
- feat(Checkbox): add indeterminate status by @wjw-gavin in #12216
- feat(auto-import-resolver): add auto-import-resolver package by @wChenonly in #12227
- feat(ConfigProvider): add theme-vars-scope props enable root affects by @zhousg in #12240
Bug Fixes 🐞
- fix(auto-import-resolver): type mismatch in TS projects by @chenjiahan in #12243
- fix(eslint): using ignorePatterns to replace .eslintignore by @MrXwq in #12237
Document 📖
- docs: improve the menu position of back-top by @wjw-gavin in #12223
- docs: improve use-raf document by @chenjiahan in #12224
- docs: add Vite and Nuxt guide to quickstart by @chenjiahan in #12239
- docs(auto-import-resolver): update README and folder name by @chenjiahan in #12241
- docs(auto-import-resolver): add Rspack usage by @chenjiahan in #12242
- docs(ConfigProvider): update the guide of modify CSS vars by @chenjiahan in #12246
Other Changes
- test: migrate test runner to vitest by @chenjiahan in #12206
- chore(CI): fix codecov reporter by @chenjiahan in #12210
- chore: use workspace protocol for internal deps by @chenjiahan in #12225
- test: fix vitest canvas mock by @chenjiahan in #12226
v4.6.6
2023-08-20
New Features 🎉
- feat(DropdownItem): supports boolean value in options by @baboon-king in #12208
Bug Fixes 🐞
- fix(FloatingBubble): drag should not trigger click on child elements by @zhousg in #12201
- fix(FloatingBubble): does not update state while hidden by @zhousg in #12207
Other Changes
- chore(CI): update issue comment messages by @chenjiahan in #12204
- refactor(cli): remove execa dependency by @chenjiahan in #12205
v4.6.5
2023-08-16
New Features 🎉
- feat(DropdownMenu): add swipe-threshold prop by @inottn in #12117
- types(Toast): add
ToastWrapperInstance
export by @long-woo in #12166 - feat(FloatingBubble): use component attrs by @zhousg in #12171
Bug Fixes 🐞
- fix(FloatingPanel): Lag caused by scrollbar and panel movement #12146 by @yue1123 in #12161
- fix(FloatingPanel): change the default value of lock-scroll to false by @inottn in #12162
- fix(cli): should escape curly brackets in markdown by @chenjiahan in #12188
Document 📖
- docs: add instructions for bun package manager by @colinhacks in #12182
Other Changes
- chore: add script to format GitHub changelog by @chenjiahan in #12158
- chore(FloatingPanel): improve code style by @chenjiahan in #12175
- refactor(cli): rewrite vite-plugin-md by @chenjiahan in #12179
- chore(deps): bump markdown-it v13 and commander v11 by @chenjiahan in #12180
- chore(CI): do not run codeql for pull request by @chenjiahan in #12181
New Contributors
- @long-woo made their first contribution in #12166
- @yue1123 made their first contribution in #12161
- @colinhacks made their first contribution in #12182
- @xincheng-1999 made their first contribution in #12189
v4.6.4
2023-08-06
New Features 🎉
- feat(area-data): update counties of WuHu by @nivin-studio in #12122
- feat(Locale): add Serbian language to internationalization by @RogerZXY in #12145
- feat(ImagePreview): add closeOnClickOverlay option by @chenjiahan in #12153
- feat(List): add scroller prop by @chenjiahan in #12154
- feat(FloatingPanel): add lock-scroll prop by @inottn in #12157
Bug Fixes 🐞
- fix(TextEllipsis): dots repeated by @muzaisimao in #12120
- fix(TextEllipsis): fix the logic of calculating the position of ellipsis by @inottn in #12137
Document 📖
- docs: move PR title format to contribution guide by @chenjiahan in #12114
- docs(Radio): add document description for the css var '--van-radio-dot-size' by @wjw-gavin in #12152
Other Changes
- chore: avoid prettier breaking hbs template by @chenjiahan in #12113
- chore(deps): bump release-it v16 by @chenjiahan in #12115
- feat(get-deps): import('../foo.vue') => import('../foo.mjs') 的替换 by @suncohey in #12046
- refactor(cli): rewrite release command by @chenjiahan in #12133
- feat(cli): support gitTag option for release command by @chenjiahan in #12134
- chore(CI): automatically generate changelog via GitHub by @chenjiahan in #12135
- chore: add PR labeler action by @chenjiahan in #12136
- chore(TextEllipsis): reuse actionText variable by @chenjiahan in #12138
- refactor(cli): use GitHub changelog instead of conventional-changelog by @chenjiahan in #12139
- chore: add Serbian to doc and rename the file by @chenjiahan in #12150
- chore(eslint-config): bump dependencies by @chenjiahan in #12155
New Contributors
- @muzaisimao made their first contribution in #12120
- @suncohey made their first contribution in #12046
- @nivin-studio made their first contribution in #12122
- @RogerZXY made their first contribution in #12145
v4.6.3
2023-07-23
Feature
- AddressList: add show-add-button prop #12090
- CheckboxGroup: add shape prop #12092
- RadioGroup: add shape prop #12092
Bug Fixes
v4.6.2
2023-07-09
Feature
- Field: add autocapitalize, autocorrect and spellcheck props #12065
- FloatingBubble: add CSS vars to override border radius #12070
- Radio: add dot shape #12057
- TextEllipsis: add position prop, contributed by cxybd ❤️ #12058
Bug Fixes
v4.6.1
2023-07-02
Feature
- ellipsis: improve break lines of Chinese, Japanese, or Korean text #12030
Bug Fixes
- FloatingBubble: floatingBubbleBackground type should be optional #12029
- SubmitBar: remove redundant theme types #12031
- Uploader: render objectUrl to avoid perf issue #12051
v4.6.0
2023-06-24
New Component
- add new FloatingBubble component, contributed by @zhousg ❤️ #11880
- add new RollingText component, contributed by @cunzaizhuyi ❤️ #11911
Feature
- Rate: add clearable prop #11969
Bug Fixes
- DropdownMenu: fix missing exported type #11979
- Field: should not set
for
attr to label when using input slot #11966 - FloatingPanel: fix missing floatingPanelProps export #11978
- FloatingPanel: remove passive event warning #11992
- Picker: optimize the animation effect of sliding multiple columns simultaneously #11945
- Rate: should change value when half icon is touchmoved #12002
v4.5.0
2023-06-11
New Component
Feature
- AddressList: add new right-icon props #11959
- DropdownMenu: add close method #11921
- Slider: add dragging param for button slot #11946
- TimePicker: add min-time and max-time prop #11887
- TimePicker: add values param for filter method #11916
- CI: add issue helper #11963
Bug Fixes
- BackTop: should hide when deactivated #11938
v4.4.1
2023-05-28
Feature
- Popover: add actions-direction prop #11888
Bug Fixes
- ImagePreview: stop animation during initialization #11897
- Popup: opened event is emitted twice when duration is 0 #11902
- Slider: should update startValue when the slider is clicked #11904
- Tab: maximum recursive updates exceeded in Tabs #11898
v4.4.0
2023-05-21
New Component
Feature
- Cascader: scroll the selected option into view when switching tabs #11869
- Divider: add vertical prop #11883
- Document: sync mobile position on anchor click #11879
- ImagePreview: optimize the preview effect of long images #11857
- Signature: improve signature clarity by devicePixelRatio #11835
- Uploader: add reupload prop #11854
Bug Fixes
- AddressEdit: should hide border of the last cell #11872
- Area: areaProps omit allow-html show-toolbar #11871
- BackTop: use the closest parent scroll element as target #11858
- ContactList: increase right icon size and optimize styles #11873
- DatePicker: should display correctly when modelValue is updated from external #11839
- Dialog: fix the rounded corners of shadow when button is clicked #11863
v4.3.2
2023-05-14
Feature
- ImagePreview: use the touched point as the center of zooming #11848
- PickerGroup: the tab of PickerGroup supports controlled mode #11771
- Checkbox: disabled unchecked options when the limit is exceeded #11814
Bug Fixes
- Filed: onclick label execute twice #11838
- Steps: fix the style that occurs when there is only one step #11822
- SubmitBar: Unused CSS variables #11845
- Tab: should cancel raf before the next scroll #11819
v4.3.1
2023-05-04
Bug Fixes
- Fix failed to install Vant v4.3.0 #11815
v4.3.0
2023-05-03
New Component
- add new Signature component, contributed by @LIjiAngChen8 ❤️ #11733
Feature
- Field: increase default icon size to 18px #11799
Bug Fixes
- Field: disabled cursor should be not-allowed #11800
- Image: failed to display loading when using lazy-load #11809
v4.2.1
2023-04-30
Feature
Bug Fixes
- Pagination: don't show click feedback when button is disabled #11779
- Sticky: resize or orientationchange wrapper no reset width and height #11753
- Tabs: re-render when line-width or line-height changed #11776
- Tabs: should scroll active tab into view after resized #11777
- Watermark: add xlink namespace and fix blob MIME type #11762
v4.2.0
2023-04-16
New Component
- add new Watermark component, contributed by @HuberTRoy ❤️ #11721
Feature
Bug Fixes
- Swipe: should resize after props.width and props.height changed #11747
v4.1.2
2023-03-26
Feature
- Locale: add Khmer translations #11701
Bug Fixes
- Field: label-align top works well with label-width #11684
- Field: should emit blur event when readonly #11699
- ImagePreview: long vertical images sliding up and down #11702
v4.1.1
2023-03-19
Feature
- Uploader: support avif image format #11655
Bug Fixes
- @vant/use: add vue as peer dependencies #11662
- DatePicker: fix display back wrong of date-picker #11656
- Field: fix
FieldRuleFormatter
typo #11674 - TextEllipsis: fix that numbers and letters cannot display ellipses #11669
v4.1.0
2023-03-05
New Component
- add new TextEllipsis component, contributed by @wjw-gavin ❤️ #11593
Feature
- Swipe: add index param to drag-start/drag-end event #11632
- TreeSelect: add nav-text slot #11602 #11641
Bug Fixes
- DropdownMenu: fix dropdown-item position when expanded by default #11640
- Field: fix label-align top not work when set label-width #11611
- Locale: improve Ukrainian translation #11629
v4.0.11
2023-02-20
Feature
- Add new vant-nuxt module for Nuxt #11588
- BackTop: support css variable and prop of z-index #11582
- Picker: expose option index to option slot #11594
- @vant/use: support cleanup useEventListener #11540
Bug Fixes
- PickerGroup: confirm event missing params #11566
- PickerGroup: fix style of tab-line caused by v-show #11547
- PickerGroup: fix slots not work #11564
- Popover: fix the arrow position of
*-start/end
placements #11584 - Popover: should update location after transition #11568
- Space: Text is not defined in SSR #11549
v4.0.10
2023-02-02
Bug Fixes
- DatePicker: fix the value is not updated in time of change event #11529
- Slider: fix button does not work properly in two-thumb mode #11526 #11534
v4.0.9
2023-01-26
Feature
- BackTop: add immediate prop #11515
- Calendar: add month-title slot #11500
- Cascader: add useCascaderAreaData method #11518
- ImagePreview: allow swipe when image is moved to edge #11505
- Locale: add Esperanto translations #11520
- Locale: add useCurrentLang method #11517
- Swipe: add drag-start, drag-end event #11502
Bug Fixes
- ImagePreview: disable zoom when swiping #11504
- Locale: fix Italian general revision #11519
- Swipe: avoid resetting position on multi-finger touch #11503
v4.0.8
2023-01-15
Feature
- PickerGroup: add next-step-text prop #11487
Bug Fixes
- Picker: change confirm button color to primary color #11479
- NumberKeyboard: change confirm button color to primary color #11479
- Icons: add woff format to compat some special webview #11485
- Picker: ensure title align in center #11489
- Skeleton: fix can not register skeleton image component #11470 #11469
- Tabs: incorrect insert position in some cases #11462
v4.0.7
2023-01-02
Bug Fixes
- Icons: fix delete / delete-o icon #11441
- Icons: no longer support woff/ttf format #11442
- ImagePreview:fix teleport prop not work #11429
- Locale: fix typo of "Calendar" in ru-RU #11425
- Swipe: failed to render inside keep-alive #11437
v4.0.6
2022-12-26
Bug Fixes
- Fix missing declaration files caused by upgrading vite v4 #11423
v4.0.5
2022-12-25
Feature
Bug Fixes
- Badge: fix badge offset of different position #11400
- Form: filter no name field's value #11410
- Picker: picker loading color in dark theme #11405
v4.0.4
2022-12-23
Bug Fixes
- Field: incorrect cursor position when value length exceeds maxlength or when formatter is used #11360
- Image: load event missing params #11406
v4.0.3
2022-12-13
Bug Fixes
- Field: failed to dynamically set empty label #11373
- ImagePreview: fix loading when previewing images #11376
v4.0.2
2022-12-03
Bug Fixes
- Field: incorrect cursor position when using formatter #11348
- Image: load event not triggered in nuxt3 128972
- NavBar: update placeholder height when window resized #11351
v4.0.1
2022-12-01
Feature
- Picker: add selectedIndexes to the confirm event #11329
Bug Fixes
- Field: set selection range only when focused #11333
v4.0.0
2022-11-26
Feature
- List: add disabled prop #11307
- BackTop: allow dynamically set target prop #11311
- BackTop: allow using css var to custom position #11312
- BackTop: rename visibility-height prop to offset #11309
Bug Fixes
- Field: keep selection position after updating value #11308
v4.0.0-rc.9
2022-11-24
Bug Fixes
v4.0.0-rc.8
2022-11-20
Feature
- add new BackTop component, note that the API is not stable yet, we may change the API before 4.0 release. #11236
Bug Fixes
- DropdownItem: should inherit attrs when using teleport #11273
- List: incorrect initial loading value #11275
- NumberKeyboard: should inherit attrs when using teleport #11274
v4.0.0-rc.7
2022-11-13
New Component
- Add new SkeletonAvatar、SkeletonTitle、SkeletonImage、SkeletonParagraph components #11173
Feature
Bug Fixes
- ActionSheet: fix that close is invalid without title #11213
- DatePicker: only throw error in development #11248
- Lazyload: lazy-image h is not a function #11229
- Picker: correct v-model when emit confirm event #11194
- Picker: empty column will cause error #11249
- Uploader: chooseFile is invalid when show-upload is false #11218
v4.0.0-rc.6
2022-10-23
Feature
- Calendar: add params for subtitle slot #11168
- Cell: add tag prop #11139
- ImagePreview: add image slot #11133
- Toast: add wordBreak prop #11147
Bug Fixes
- CouponList: fix the style of coupon checkbox #11153
- CouponList: incorrect field style #11155
- Swipe: failed to render when inside popup #11162
v4.0.0-rc.5
2022-10-07
Feature
- Field: support label-position top #11102
- Loading: add icon slot #11109
- NavBar: add clickable prop #11048
- Stepper: add auto-fixed prop #11071
Bug Fixes
- DatePicker: format value when exceed max date #11122
- Tabs: incorrect nav scroll animation in some cases #11116
- Tabs: scroll position when using nav-bottom slot #11115
v4.0.0-rc.4
2022-09-25
Feature
- Field: add message param to 'end-validate' method #11080
Bug Fixes
- Tabs: incorrect scroll position in some cases #11085
- Tabs: incorrect scroll position when inited #11059
v4.0.0-rc.3
2022-09-12
Feature
- ConfigProvider: add ConfigProviderThemeVars type #11034
- Notify: add z-index prop #11032
- remove popperjs to reduce install size #11030
Types
- Toast: fix missing global components type #11033
v4.0.0-rc.2
2022-09-11
Breaking Changes
- attach css variables to :root element #11026
Bug Fixes
v4.0.0-rc.1
2022-09-10
Feature
- export props of all components #11024
- Dialog: message-align can be justify #11014
- Image: add block prop #11022
- Toast: add message slot #11018
Bug Fixes
v4.0.0-rc.0
2022-09-04
New Component
- Add new component PickerGroup #11005
Bug Fixes
v4.0.0-beta.1
2022-08-24
Breaking Changes
- Popup: improve style when position is center #10965
// Vant 3
.van-popup--center {
left: 50%;
transform: translate3d(-50%, -50%, 0);
}
// Vant 4
.van-popup--center {
left: 0;
right: 0;
width: fit-content;
max-width: calc(100vw - var(--van-padding-md) * 2);
margin: 0 auto;
transform: translateY(-50%);
}
New Component
- Add new component Space, contributed by @LadyChatterleyLover #10857 ❤️
Feature
- ConfigProvider: add z-index prop #10915
- Form: add validateEmpty option of rule #10913
- Popup: add role and tabindex for a11y #10894
- TouchEmulator: support .mjs extension #10888
Feature
- ConfigProvider: add theme-vars-dark and theme-vars-light props #10939
- Picker: add clickOption event #10865
- add correct passive flag to improve scroll performance #10951
- @vant/use: improve useEventListener typing #10952
Bug Fixes
- ConfigProvider: should remove theme class on unmount #10898
- reduce passive event warning of touchstart event #10954
- Tabs: resize not work for swipeable tabs #10964
- Fix incorrect tag name in WebStorm #10946
- Badge: should hide string zero when using show-zero prop #10921
- Calendar: content disappeared when hiding #10910
- Calendar: reading getFullYear error in some cases #10909
- Empty: generate unique id to avoid render issue #10943
- Popover: can not scroll inside popup #10949
- PullRefresh: fix passive event warning #10938
- Search: --van-search-input-height var not work #10911
v4.0.0-beta.0
2022-07-16
Breaking Changes
- Toast: redesign function-call API #10804
- Dialog: redesign function-call API #10781
- Notify: redesign function-call API #10782
- ImagePreview: redesign function-call API #10802
Feature
- add @vant/compat package #10806
- Calendar: expose getSelectedDate method 419a8e
- remove less source file to remove bundle size #10752
Bug Fixes
- Uploader: should not preview failed images #10790
v4.0.0-alpha.4
2022-05-31
Feature
- using mjs extension for esmodule #10625
v4.0.0-alpha.3
2022-05-02
Feature
- Form: support setting multiple validate-trigger #10544
- Empty: localize all images #10514 #10515 #10516
- Loading: add aria to improve a11y #10568
Bug Fixes
v4.0.0-alpha.2
2022-04-16
- CalendarDay: add default margin-bottom #10441
- Empty: support set the image size separately #10465
- Field: add enterkeyhint prop #10478
- Form: add getValues method #10511
- Icon: add some icons for ShareSheet #10468
- Locale: add Danish lang #10513
- ShareSheet: no longer rely on CDN images #10469
- Add event arguments in web-types.json #10474
Bug Fixes
- DatetimePicker: modeValue is inconsistent with the selected data #10448
- Rate: support precisely selected #10500
v4.0.0-alpha.1
2022-03-19
Feature
Bug Fixes