介紹

Vant 遵循 Semver 語義化版本規(guī)范。

發(fā)布節(jié)奏

• 修訂號：每周發(fā)布，包含新特性和問題修復。
• 次版本號：每隔一至二個月發(fā)布，包含新特性和較大的功能更新，向下兼容。
• 主版本號：發(fā)布時間不定，包含不兼容更新，預計下一個主版本會與 Vue 3.0 同期發(fā)布。

v2.4.6

2020-02-01

Bug Fixes

• Picker: 修復更新 columns 數(shù)據(jù)不生效的問題 #5614

v2.4.5

2020-02-01

Feature

• Picker: 支持級聯(lián)選擇 #4247
• Slider: 新增 button-size 屬性 1e9b8c
• 優(yōu)化 props 類型，原有 number 類型的 props 現(xiàn)在支持傳入 string

Style

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

Bug Fixes

• ImagePreview: 修復雙擊縮放時 max-zoom 屬性不生效的問題 1baa60
• Popup: 修復 position 為 center 時 duration 屬性不生效的問題 44072e
• Step: 修復 active-color 未改變分隔線顏色的問題 cfadce

v2.4.4

2020-01-24

Feature

• Card: 優(yōu)化圖片拉伸模式 e766d5
• Calendar: 新增 get-contaienr 屬性 #5609
• Calendar: 新增 close-on-popstate 屬性 2b82dc
• CountDown: 新增 change 事件 #5599
• GoodsActionButton: 新增 icon 屬性 b83bed

Bug Fixes

• Sku: 修復 get-container 屬性不能為 string 類型的問題 #5608

v2.4.3

2020-01-19

Feature

• Swipe: 頁面隱藏時暫停自動輪播 113157
• Stepper: 新增 long-press 屬性 2f3ec6
• Calendar: 新增 max-range、range-prompt 屬性 #5583
• ImagePreview: 新增 @image-preview-index-text-shadow 變量 e2f302

Improvement

• Icon: 更新 share 圖標 2f77ac
• Field: 優(yōu)化 readonly 狀態(tài)下的光標類型 60173d
• Stepper: 優(yōu)化 disable-input 狀態(tài)下的輸入框顏色 959eca

Bug Fixes

• GoodsAction: 修復未設(shè)置容器高度的問題 #5593

Types

• Calendar: 新增類型定義 dac60c
• Toast: 修復 setDefaultOptions 方法參數(shù)定義錯誤 #5582

v2.4.2

2020-01-14

Feature

• Sku: 新增 properties 屬性 #5525
• Field: 新增 digit 類型 #5524
• Field: 新增 formatter 屬性 #5534
• Image: 新增 error-icon 屬性 #5470
• Image: 新增 loading-icon 屬性 #5469
• Swipe: 新增 prev、next 方法 #5548
• GoodsAcitonIcon: 新增 color 屬性 #5576

Improvement

• AddressList: 優(yōu)化樣式細節(jié) #5507
• AddressEdit: 優(yōu)化錯誤提示展示方式 #5479
• ActionSheet: 優(yōu)化關(guān)閉按鈕樣式 #5574
• CouponList: 優(yōu)化樣式細節(jié) #5501
• Calendar: 彈出時自動滾動到當前選中的日期 #5526
• ImagePreview: 優(yōu)化圖片加載失敗提示樣式 #5570
• 優(yōu)化所有組件的光標類型 c1a535

Bug Fixes

• Button: 修復加載狀態(tài)下仍會有點擊反饋的問題 0a70d3
• Card: 修復圖片圓角樣式未生效的問題 #5480
• Calendar: 修復選中的日期無法展示提示信息的問題 #5536
• Checkbox: 修復設(shè)置 label-disabled 后空白區(qū)域仍然可以點擊的問題 3d10d4
• CouponList: 修復點擊反饋區(qū)域錯誤的問題 #5521
• Field: 修復 type 為 number 時在 iOS 上仍然能輸入非數(shù)字字符的問題 #5520
• ImagePreview: 修復在桌面端使用時無法拖拽的問題 #4487
• Picker: 修復點擊事件偶爾會丟失的問題 5cbb9e
• PullRefresh:修復 head-height 屬性未正確設(shè)置高度的問題 028747
• Tabs: 修復容器設(shè)置 fixed 布局時無法渲染底部條的問題 #5496

v2.4.1

2020-01-02

Feature

• ContactEdit: 優(yōu)化錯誤提示展示方式 #5437
• CouponCell: 優(yōu)先展示 value 字段的數(shù)值 #5438

Bug Fixes

• Calendar: 修復日期對應的星期數(shù)展示錯誤的問題 #5452
• List: 修復 direction 為 up 時加載事件觸發(fā)時機錯誤的問題 #5439

v2.4.0

2020-01-01

New Component

• 新增 Calendar 日歷組件

Feature

• List: 新增 error 插槽 e9a938
• List: 新增 finished 插槽 8a0705
• Picker: 新增 confirm 方法 5eb2a4
• PullRefresh: 新增 success 插槽 56e450
• CouponList: 更新底部按鈕樣式 #5368
• DatetimePicker: 新增 getPicker 方法 1dc1fe
• TreeSelect: 新增 @tree-select-item-selected-size 變量 373159
• Image: 新增 @image-loading-icon-size、@image-error-icon-size 變量 d7ae8c

Compatibility

在之前的版本中，有較多同學反饋在 iOS 10 ~ 11 上會偶現(xiàn)組件無法操作的情況，該問題的原因是 Vue 2.6.x 版本在綁定事件時存在事件無法冒泡的兼容性問題。相關(guān) issue

從 2.4 版本開始，我們通過手動綁定事件的方式來規(guī)避這個問題，涉及以下組件：

• Area
• DatetimePicker
• ImagePreview
• Rate
• Slider
• Swipe
• SwipeCell
• NumberKeyboard
• Picker
• PullRefresh

Bug Fixes

• Icon: 修復 medel-o 圖標不展示的問題 7b905a
• ImagePreview: 修復 close 事件重復觸發(fā)的問題 #5410
• PullRefresh: 修復下拉到頂部時可能不觸發(fā)下拉刷新的問題 e00058
• Tag: 修復動態(tài)設(shè)置 closeable 時動畫錯誤的問題 fe6e2f
• Tag: 修復 close 時會觸發(fā) click 事件的問題 #5351
• Toast: 修復同時存在多個 Toast 時 forbidClick 可能失效的問題 #5398
• Picker: 修復在桌面端使用時拖動后回彈的問題 #5430
• Stepper: 修復在 safari 上禁用時文字顏色不正確的問題 #5428
• IndexBar: 修復 IndexAnchor 沒有父容器時定位錯誤的問題 #5429

Types

• AddressEdit: 新增 setAddressDetail 方法的類型定義 #5352
• Area: 新增 reset 方法的類型定義 #5353
• Checkbox: 新增 toggle 方法的類型定義 #5354
• CountDown: 新增 start、end、reset 方法的類型定義 0438bd
• DropdownItem: 新增 toggle 方法的類型定義 5c1883
• Field: 新增 focus、blur 方法的類型定義 0b5c8e
• List: 新增 check 方法的類型定義 285bce
• Picker: 新增 getValues 等方法的類型定義 46d2b0
• Sku: 新增 methods types d2bb9f
• Swipe: 新增 swipeTo、resize 方法的類型定義 a1831b
• SwipeCell: 新增 open、close 方法的類型定義 9a9676
• Tabs: 新增 resize 方法的類型定義 3c526e
• Uploader: 新增 closeImagePreview 方法的類型定義 cf191e

v2.3.3

2019-12-21

Bug Fixes

• 修復 babel-plugin-import 按需引入部分組件時編譯報錯的問題

v2.3.2

2019-12-20

Bug Fixes

• 修復 Area 未自動引入依賴的 Picker 樣式的問題
• 修復 DatetimePicker 未自動引入依賴的 Picker 樣式的問題
• 修復 CountDown 在特定情況下內(nèi)部計時器未清除的問題 #5340
• 修復 ImagePreview 在特定情況下會重復 onClose 回調(diào)的問題 #5341

v2.3.1

2019-12-20

Bug Fixes

• 修復全量引入組件時，入口文件中存在未編譯的 ES6 代碼的問題

v2.3.0

2019-12-20

Style

在 2.3.0 版本中，我們對業(yè)務組件的樣式進行了全新升級，涉及以下組件：

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

Features

• 內(nèi)部構(gòu)建流程升級，使用 @vant/cli 進行構(gòu)建
• AddressList: 新增 default-tag-text 屬性 #5106
• Card: 新增 price-top 插槽 #5134
• Checkbox: 優(yōu)化 toggleAll 性能 #5285
• Circle: 新增 stroke-linecap 屬性 #5087
• CouponList: 新增 show-count 屬性 #5139
• ContactList: 新增 default-tag-text 屬性 #5089
• ContactCard: 新增 show-set-default 屬性 #5083
• ContactCard: 新增 set-default-label 屬性 #5083
• CountDown: 支持 SS 和 S 格式 #5154
• Sku: 新增 new startSaleNum 屬性 #5105
• Sku: 新增 resetSelectedSku 方法 #5318
• SubmitBar: 新增 text-align 屬性 #5130
• SwipeCell: 新增 open 事件 #5324
• SwipeCell: 新增 before-close 屬性 #5320
• Tab: 新增 dot 屬性 #5272
• Tab: 新增 info 屬性 #5274
• Tab: 新增 rendered 事件 #5315
• Tab: 新增 scrollspy 屬性 #5273
• Toast: 完善 TS 類型定義 #5086

Bug Fixes

• 修復 ActionSheet 按鈕會提交表單的問題 #5181
• 修復 Card 在未使用 price 屬性的情況下 bottom 插槽不生效的問題 #5116
• 修復 Dialog 快速點擊按鈕時可能重復觸發(fā) before-close 的問題 #5267
• 修復 DropdownMenu 在頁面滾動時菜單位置錯誤的問題 #5313
• 修復 Icon medal 圖標名稱拼寫錯誤的問題 #5242
• 修復 NumberKeyboard 在隱藏狀態(tài)下也會觸發(fā) blur 事件的問題 #5110
• 修復 Picker 按鈕會提交表單的問題 #5182
• 修復 Popup 在 activated 后未重新打開的問題 #5286
• 修復 Switch size 屬性未定義 Number 類型的問題 #5229
• 修復 SubmitBar 價格為整數(shù)時顯示錯誤的問題 #5224
• 修復 Sku 重置時未校驗數(shù)量的問題 #5231
• 修復 Sku 步進器可能輸入小數(shù)的問題 #5202
• 修復 Sku 步進器事件可能拋出小數(shù)的問題 #5210
• 修復 Stepper 按鈕會提交表單的問題 #5183
• 修復 Stepper 在 max、min 屬性變化時未更新輸入框值的問題 #5257
• 修復 TreeSelect 事件觸發(fā)順序錯誤的問題 #5153
• 修復 TouchEmulator 在 Firefox 上的兼容性問題 #5118
• 修復 Uploader 重復上傳同張圖片時不會觸發(fā) oversize 事件的問題 #5177
• 修復主題定制時使用低版本 Less 會報錯的問題 #5157

v2.2.16

2019-12-03

Features

• Stepper: 新增 disable-plus 屬性 #5180
• Stepper: 新增 disable-minus 屬性 #5180

v2.2.15

2019-11-28

Bug Fixes

• 修復 List 組件在部分情況下加載狀態(tài)未重置的問題

v2.2.14

2019-11-22

Features

• Tabs: 新增 title-style 屬性 #5048
• Tabs: 新增 resize 方法 #5071
• Swipe: 新增 resize 方法 #5070

Bug Fixes

• 修復 Cell value 過長時不換行的問題 #5029
• 修復 SwipeCell 在桌面端無法使用的問題 #5077
• 修復 Field 在 Safari 下輸入換行符時字數(shù)統(tǒng)計錯誤的問題 #5049
• 修復 Tabbar 設(shè)置 safe-area-inset-bottom 后可能出現(xiàn)樣式錯位的問題 #5079
• 修復 DropdownMenu 使用 get-container 屬性時點擊后會立即關(guān)閉的問題 #5047

v2.2.13

2019-11-14

Features

• Area: 新增 swipe-duration 屬性 #5014
• Swipe: 新增 stop-propagation 屬性 #4972
• Toast: 新增 overlay 選項 #4969
• Toast: 新增 clickOnClickOverlay 選項 #4967
• SwipeCell: 新增 opened 事件 #4986
• ActionSheet: 新增 close-icon 屬性 #5016
• DropdownItem: 新增 title 插槽 #4975
• DatetimePicker: 新增 swipe-duration 屬性 #5015

Bug Fixes

• 修復 Tab name 設(shè)置為 0 時無法正確匹配的問題 #5017
• 修復 Indexbar 隱藏時可能出現(xiàn)錨點位置錯誤的問題 #5012
• 修復 Indexbar 設(shè)置 sticky-offset-top 后可能出現(xiàn)錨點位置錯誤的問題 #5012
• 修復 DatetimePicker 使用 filter 并返回空數(shù)組時無法切換時間的問題 #4973
• 修復 DateTimePicker 動態(tài)設(shè)置 max-hour 并小于 v-model 綁定的時間時出現(xiàn)錯誤的問題 #5006
• 修復 ImagePreview 類型中定義缺少 swipeDuration 選項的問題 #4968

v2.2.12

2019-11-07

Features

• Stepper: 新增 name 屬性 #4931
• Uploader: 新增 deletable 屬性 #4925

Bug Fixes

• 修復 Sku 內(nèi)容最小高度錯誤的問題 #4942
• 修復 List 在初始化時可能同時觸發(fā)兩次 load 事件的問題 #4953
• 修復 @border-color 變量無法定制某些組件邊框顏色的問題 #4939

v2.2.11

2019-11-04

Features

• Switch: 新增 click 事件 #4915
• Switch: size 屬性支持 number 類型 #4913
• Toast: 默認持續(xù)時間由 3 秒調(diào)整為 2 秒 #4886
• Uploader: 新增 closeImagePreview 方法 #4901

Bug Fixes

• 修復 Button 加載圖標顏色不正確的問題 #4868
• 修復 CountDown 在銷毀時未清除定時器的問題 #4918
• 修復 CountDown 在 keep-alive 狀態(tài)下未暫停定時器的問題 #4919
• 修復 Grid 使用 icon 插槽時 info、dot 屬性不生效的問題 #4902

v2.2.10

2019-10-27

Features

• Icon: 新增 font-display: auto 樣式 #4831
• Popup: 新增 close-on-popstate 屬性 #4845
• Picker: 新增 swipe-duration 屬性 #4816
• Toast: 支持針對指定類型的 Toast 修改默認配置 #4848

Bug Fixes

• 修復 Uploader 文件預覽圓角樣式錯誤的問題 #4846
• 修復 DatetimePicker 同時使用 min-date 和 filter 時初始值錯誤的問題 #4837

v2.2.9

2019-10-20

Features

• Tag: 新增 closeable 屬性 #4763
• Loading: 新增若干個 Less 變量 #4781
• Progress: 新增若干個 Less 變量 #4790
• Progress: 新增 track-color 屬性 #4789
• Toast: 新增 @toast-loading-icon-color 變量 #4782
• Picker: 新增 @picker-loading-icon-color 變量 #4787
• ImagePreview: 新增 cover 插槽 #4766

Bug Fixes

• 修復 Tag 圓角不夠圓的問題 #4762
• 修復 Sku 重置時不觸發(fā) sku-selected 事件的問題 #4755
• 修復 ImagePreview 點擊索引時會關(guān)閉預覽的問題 #4764
• 修復 AddressEdit 設(shè)置 area-placeholder 后無法選擇海外地址的問題 #4769

v2.2.8

2019-10-17

Features

• Slider: 優(yōu)化點擊區(qū)域 #4701
• Slider: 增加過渡動畫 #4700
• Dialog: 更新圓角樣式 #4730
• Uploader: 更新刪除圖標樣式，添加圖片圓角樣式 #4712
• Field: 新增 show-word-limit 屬性 #4721
• ActionSheet: 新增 description 屬性 #4691
• Stepper: 設(shè)置 decimal-length 屬性后會在輸入過程中進行校驗 #4747
• 新增漸變色相關(guān)的 Less 變量 #4752
• 新增多行文字省略的內(nèi)置樣式 #4690

Bug Fixes

• 修復 Slider 寬度異常的問題 #4699
• 修復 Rate 由于 inline-block 導致的錯誤高度 #4693
• 修復 AddressEdit 省市區(qū)未選擇完全時能夠保存的問題 #4724

v2.2.7

2019-10-11

Features

• Dialog: 新增 width 屬性 #4687
• Dialog: 新增 overlay-class 屬性 #4683
• Dialog: 新增 overlay-style 屬性 #4682
• Uploader: 新增 file 類型的 result-type #4680
• TreeSelect: 新增 className 選項 #4671

Bug Fixes

• 修復 Dialog 可能出現(xiàn)文字模糊的問題 #4686
• 修復 Stepper 的 step 值很小時無法生效的問題 #4675
• 修復 DatetimePicker 動態(tài)修改時間范圍時, confirm 事件無法獲取到正確結(jié)果的問題 #4676
• 修復 Field 同時設(shè)置 error 和 disabled 屬性時文字顏色錯誤的問題 #4666

v2.2.6

2019-10-08

Features

• Grid: 新增 icon-size 屬性 #4656
• Toast: 新增 transition 屬性 #4638
• Dialog: 新增 transition 屬性 #4636
• Dialog: 新增 open、close 事件 #4633
• Dialog: 新增 opened、closed 事件 #4634
• NumberKeyboard: 新增 extra-key 插槽 #4644
• CheckboxGroup: 新增 toggleAll 方法 #4640

Bug Fixes

• 修復 GoodsAction 圓角錯誤的問題 #4653
• 修復 Tabs 類型為 card 時上邊距錯誤的問題 #4658
• 修復 AddressList input 事件重復觸發(fā)的問題 #4659
• 修復 NumberKeyboard 在 Vue 2.6 下的兼容問題 #4632

v2.2.5

2019-09-28

Features

• Picker: 新增 columns-top 插槽 #4607
• Picker: 新增 columns-bottom 插槽 #4607
• Overlay: 新增 default 插槽 #4571
• Overlay: 新增 custom-style 屬性 #4572
• Checkbox: 新增 bind-group 屬性 #4600
• DropdownItem: 新增 get-container 屬性 #4611
• Area: 新增 columns-placeholder 屬性 #4580
• AddressEdit: 新增 area-columns-placeholder 屬性 #4584

Bug Fixes

• 修復 Overlay 未添加 TypeScript 定義的問題 #4601
• 修復 Swipe swipeTo 方法在某些邊界情況下過渡動畫不正確的問題 #4570
• 修復 Uploader 預覽 URL 相同的圖片時索引錯誤的問題 #4577

v2.2.4 [已廢棄]

2019-09-28 ????????

Tips

• 本版本存在樣式丟失問題，請使用 2.2.5 版本

v2.2.3

2019-09-24

Features

• Cell: 優(yōu)化無障礙訪問 #4519
• Popup: 優(yōu)化無障礙訪問 #4516
• Search: 優(yōu)化無障礙訪問 #4522
• Picker: 優(yōu)化無障礙訪問 #4521
• GridItem: 優(yōu)化無障礙訪問 #4517
• ActionSheet: 優(yōu)化無障礙訪問 #4525
• Sku: 新增 previewImgUrl 字段 #4562
• RadioGroup: 新增 icon-size 屬性 #4529
• RadioGroup: 新增 checked-color 屬性 #4532
• CheckboxGroup: 新增 icon-size 屬性 #4530
• CheckboxGroup: 新增 checked-color 屬性 #4531
• ActionSheet: 默認開啟 round 屬性 #4542
• ActionSheet: 默認開啟 safe-area-inset-bottom 屬性 #4524
• NumberKeyboard: 默認開啟 safe-area-inset-bottom 屬性 #4544

v2.2.2

2019-09-19

Features

• Dialog: 優(yōu)化文字換行 #4506
• Search: 新增 action-text 屬性 #4501
• Popup: 新增 close-icon-position 屬性 #4507
• Uploader: 回調(diào)函數(shù)增加 index 參數(shù) #4460
• GoodsActionButton: 加大按鈕高度 #4461
• AddressList: 新增 @address-list-item-radio-icon-color 變量 #4481

Bug Fixes

• 修復 Field 禁用狀態(tài)在 safari 上文字顏色過淺的問題 #4508
• 修復 DatetimePicker 選項為純文字時陷入死循環(huán)的問題 #4485
• 修復 ImagePreview 手勢縮放時可能出現(xiàn)縮放比例異常的問題 #4477

v2.2.1

2019-09-12

Features

• Icon: 新增 dot 屬性 #4425
• Icon: 新增 down、wap-home 圖標 #4404
• GridItem: 新增 dot 屬性 #4426
• GridItem: 新增 info 屬性 #4424
• TreeSelect: 新增 dot 選項 #4433
• Tab: 新增 to、url、replace 屬性 #4422
• Progress: 新增 stroke-width 屬性 #4397
• Popup: 新增 safe-area-inset-bottom 屬性 #4419
• Stepper: 新增 decimal-length 屬性 #4443
• Sku: 新增 stock-threshold 屬性 #4444
• Sku: 新增 safe-area-inset-bottom 屬性 #4428
• SidebarItem: 新增 dot 屬性 #4432
• Sku: 優(yōu)化樣式細節(jié) #4437
• Circle: 優(yōu)化文本樣式 #4401

Bug Fixes

• 修復 Sku 按鈕位置可能錯誤的問題 #4427
• 修復 Uploader 刪除時會觸發(fā) click-preview 事件的問題 #4407
• 修復 Progress 文字位置不準確的問題 #4396

v2.2.0

2019-09-06

Features

• Style: 更新基礎(chǔ)紅色為 #ee0a24 #4368
• Rate: 新增 touchable 屬性 #4361
• Rate: 布局調(diào)整為 inline-block #4334
• Rate: 優(yōu)化手勢滑動的流暢度 #4336
• Popup: 新增 closeable 屬性 #4362
• Popup: 新增 close-icon 屬性 #4366
• Sidebar: 移除了內(nèi)外邊框 #4382
• SidebarItem 新增 disabled 屬性 #4325
• TreeSelect: 新增 max 屬性 #4323
• TreeSelect: 支持通過 info 展示徽標 #4384
• Uploader: 新增 close-preview 事件 #4376
• ImagePreview: 新增圖片加載過程的提示 #4378

Bug Fixes

• 修復 Field 在 Safari 瀏覽器上樣式異常的問題 #4380
• 修復 Button 在 color 屬性中傳入漸變色時邊框顏色錯誤的問題 #4342
• 修復 Dialog 關(guān)閉時未重置按鈕加載狀態(tài)的問題 #4352
• 修復 Slider 初始值超出范圍時展示錯誤的問題 #4337
• 修復 Sidebar 徽標位置錯誤的問題 #4324
• 修復 DropdownItem 選項選中態(tài)顏色丟失的問題 #4330
• 修復 NumberKeyboard 在 iphoneX 上右側(cè)按鈕位置錯誤的問題 #4304
• 修復 ImagePreview 在關(guān)閉后未重置圖片縮放狀態(tài)的問題 #4319
• 修復 ImagePreview 在某些情況下頁碼不正確的問題 #4320

v2.1.8

2019-08-29

Features

• Picker: 新增 allow-html 屬性 #4278
• PasswordInput: 新增 focused 屬性 #4279
• GoodsActionButton: 新增 color 屬性 #4255
• Button: color 屬性支持傳入 linear-gradient 漸變色 #4252

Bug Fixes

• 修復 Circle stroke-width 超過 60 時樣式錯誤的問題 #4256
• 修復 Picker 滑動暫停時位置錯誤的問題 #4277
• 修復 Picker 滑動結(jié)束時觸發(fā)點擊會跳動的問題 #4273

v2.1.7

2019-08-26

Bug Fixes

• 修復 RadioGroup 設(shè)置 disabled 屬性后仍能切換的問題 #4242
• 修復 CheckboxGroup 設(shè)置 disabled 屬性后仍能切換的問題 #4242

v2.1.6

2019-08-26

Features

• Tag: 新增 warning 類型 #4232
• Image: 新增 radius 屬性 #4230
• Notify: 新增 type 屬性 #4237
• CellGroup: 新增 title 插槽 #4227
• Sku: 支持動態(tài)設(shè)置 initial-sku 屬性 #4214
• Sku: 支持預覽更高層級的規(guī)格類目圖片 #4236
• Locale: 支持西班牙語 #4235

Bug Fixes

• 修復 Tabbar 在 route 模式下選中樣式錯誤的問題 #4229
• 修復 NumberKeyboard 使用 title 屬性時按鈕位置錯誤的問題 #4228
• 修復 IndexBar 在 sticky 模式下錨點位置可能超出元素邊界的問題 #4218

v2.1.5

2019-08-23

Features

• Toast: 新增 closeOnClick 選項 #4192
• Uploader: 新增 image-fit 屬性 #4189
• Uploader: 新增 click-preview 事件 #4206
• Uploader: 新增 preview-full-image 屬性 #4205
• DropdownMenu: 新增 @dropdown-menu-title-active-text-color less 變量 #4208

Bug Fixes

• 修復 Area 無法選中部分海外地址的問題 #4195
• 修復 IndexBar 在局部滾動容器內(nèi)計算錯誤的問題 #4184
• 修復 NumberKeyboard 按鍵邊框顏色錯誤的問題 #4183

v2.1.4

2019-08-21

Features

• Col: 新增 click 事件 #4169
• Row: 新增 click 事件 #4170
• Area: 新增 is-oversea-code 屬性 #4163
• Circle: 支持漸變色 #4157
• Circle: 支持傳入 number 類型的 size 屬性 #4160
• Tabbar: 支持通過 to.name 匹配路由 #4148
• Sku: 頁面返回時自動關(guān)閉圖片預覽 #4152
• Uploader: 頁面返回時自動關(guān)閉圖片預覽 #4151
• Uploader: 圖片預覽支持更多圖片格式 #4140
• TreeSelect: 支持多選 #4130
• TreeSelect: 支持在 active-id 屬性上使用 sync 修飾符 #4133
• TreeSelect: 支持在 main-active-index 屬性上使用 sync 修飾符 #4132

Bug Fixes

• 修復 Sku 部分文案不支持國際化修改的問題 #4172
• 修復 Field 按鈕在 Firefox 上寬度變小的問題 #4144
• 修復 Tabbar 觸發(fā) vue-router 路由重復跳轉(zhuǎn)提示的問題 #4147
• 修復 Picker 樣式可能被重復引入的 base 樣式覆蓋的問題 #4136

v2.1.3

2019-08-15

Features

• Sku: 支持國際化 #4123
• Button: 新增 color 屬性 #4124
• Uploader: 新增 before-delete 屬性 #4118
• Collapse: 新增 value 屬性類型錯誤時的提示 #4122
• TreeSelect: 新增 content 插槽 #4105
• TreeSelect: 支持 string 類型的 height 屬性 #4107
• NumberKeyboard: 優(yōu)化點擊體驗 #4116

Bug Fixes

• 修復 DropdownMenu 嵌套在 NavBar 內(nèi)時樣式錯誤的問題 #4098
• 修復 Tab 動態(tài)插入標簽頁時下劃線位置未更新的問題 #4091
• 修復 Icon service-o 圖標不完整的問題 #4088
• 修復 Icon gift-o、refund-o 圖標不完整的問題 #4089
• 修復 Slider 位置未改變時也會觸發(fā) change 事件的問題 #4087

v2.1.2

2019-08-10

Features

• ActionSheet: 新增 color 選項 #4073
• AddressEdit: 新增 postal-validator 屬性 #4067
• Stepper: 新增 show-plus、show-minus 屬性 #4056
• Icon: 新增 warning、good-job、good-job-o 圖標 #4038
• Icon: 新增 smile、music、thumb-circle、phone-circle 圖標 #4048
• Picker: 優(yōu)化事件冒泡 #4043
• Field: 優(yōu)化圖標點擊區(qū)域 #4058
• Divider: 優(yōu)化無障礙訪問 #4069
• List: 優(yōu)化底部文字大小 #4077
• Image: img 標簽繼承圓角 #4032
• Uploader: 支持 isImage 標記 #4072
• DropdownMenu: 新增多個 Less 變量 #4071
• 支持在 module 類型的 script 標簽中引入 CDN 包 #4080

Bug Fixes

• 修復 Sticky 在局部滾動容器內(nèi)位置錯誤的問題 #4055

v2.1.1

2019-08-02

Bug Fixes

• 修復 DatetimePicker 事件無法觸發(fā)的問題 #4027
• 修復 Popup 設(shè)置 z-index 順序錯誤的問題 #4026

v2.1.0

2019-08-01 ????????

Features

• Sku: UI 升級，采用更圓潤的視覺風格 #3875 #3922
• GoodsAction: UI 升級，采用更圓潤的視覺風格 #3967
• Sku: 新增 price-tag 屬性 #3875
• Sku: 新增 hide-selected-text 屬性 #3875
• Sku: 新增 sku-header-origin-price 插槽 #3958
• Dialog: 新增 title 插槽 #3985
• Dialog: 優(yōu)化垂直居中位置 #3905
• Uploader: 新增多個 less 變量 #3907
• ActionSheet: 新增多個 less 變量 #3908
• AddressList: 新增 click-item 事件 #3942
• CouponList: 新增 empty-image 屬性 #3941
• ImagePreview: 新增 swipe-duration 屬性 #3963
• SwipeCell: 新增 stop-propagation 屬性 #3952

Bug Fixes

• 修復 Tabs 在特定情況下出現(xiàn)下劃線位置錯誤的問題 #3961
• 修復 AddressList 點擊空白區(qū)域時無法選中的問題 #3909
• 修復 IndexBar 在 index-list 變化時未更新高亮選項的問題 #3943
• 修復 ImagePreview 圖片較長時遮擋索引的問題 #4002
• 修復 ImagePreview onClose 和 onChange 選項未被重置的問題 #3960
• 修復 Radio 和 Checkbox 點擊中間空白區(qū)域時無法選中的問題 #4007
• 修復 SwipeCell 在打開的情況下阻止事件冒泡的問題 #3982
• 修復 Tabs 在 sticky 模式下滾動回到頂部時存在 1 像素偏差的問題 #3949
• 修復 DatetimePicker 使用 formatter 且為 time 類型時 confirm 事件參數(shù)錯誤的問題 #3969

v2.0.9

2019-07-19

Features

• 新增 Sticky 粘性布局組件 #3888
• Grid: 優(yōu)化文字換行 #3897
• Toast: 優(yōu)化圖片圖標展示 #3895
• Image: 新增 round 屬性 #3838
• Image: 新增 show-error 屬性 #3896
• Image: 新增 show-loading 屬性 #3893
• Toast: 新增 iconPrefix 選項 #3872
• Uploader: 支持預覽網(wǎng)絡圖片 #3899
• ActionSheet: 新增 round 屬性 #3874
• TreeSelect: 新增 click-nav、click-item 事件 #3892

Bug Fixes

• 修復 SwipeCell 與 Swipe 嵌套時無法使用的問題 #3898
• 修復 Dialog closeOnPopstate 無法被禁用的問題 #3868
• 修復 DropdownMenu toggle 方法無法打開菜單的問題 #3876

v2.0.8

2019-07-16

Features

• Sku: 支持自定義留言占位文本 #3864
• DropdownMenu: 新增 icon 選項 #3855
• DropdownMenu: 標題過長時自動截斷 #3847
• ImagePreview: 支持雙擊縮放手勢 #3839

Bug Fixes

• 修復 Tab 點擊事件參數(shù)丟失的問題 #3866
• 修復 List 在 body 標簽添加滾動樣式時異常的問題 #3844
• 修復 IndexBar 在某些情況下 active 錨點失效的問題 #3832

v2.0.7

2019-07-11

Features

• 新增 CountDown 倒計時組件 #3805
• Popup: 新增 round 屬性 #3781
• IndexBar: 新增 sticky-offset-top 屬性 #3791
• PullRefresh: 新增 distance 插槽參數(shù) #3829
• Swipe: swipeTo 方法新增 immediate 參數(shù) #3821
• Slider: bar-height 屬性支持 number 類型 #3794
• DropdownMenu: 新增 close-on-click-outside 屬性 #3824

Bug Fixes

• 修復 Popup 蒙層在某些情況下遮擋元素的問題 #3831
• 修復 Stepper 在 iOS 12 下滾動位置錯誤的問題 #3804
• 修復 Dialog closeOnPopstate 方法缺少類型定義的問題 #3789
• 修復 DatetimePicker 使用 filter 屬性且為 time 類型時 confirm 事件參數(shù)錯誤的問題 #3816

v2.0.6

2019-07-05

Features

• 新增 Divider 分割線組件 #3755
• Tab: 新增 name 屬性 #3762
• Sku: 新增 add-cart-text 屬性 #3725

Bug Fixes

• 修復 Grid gutter 屬性不能傳入 String 類型的問題 #3741
• 修復 Swipe 使用 width 屬性后出現(xiàn)空白區(qū)域的問題 #3751
• 修復 PullRefresh 同步修改 loading 時狀態(tài)錯誤的問題 #3719
• 修復 Collapse 在 safari 瀏覽器上渲染內(nèi)容較多時高度錯誤的問題 #3723

v2.0.5

2019-07-02

Features

• Stepper: 支持長按手勢 #3711
• Stepper: 新增 button-size 屬性 #3714
• Dialog: 新增 close-on-popstate 屬性 #3709

Bug Fixes

• 修復 postcss 配置對 vant 不生效的問題

v2.0.4 ????????

2019-07-01

Features

• 新增 Grid、GridItem 組件 #3669 #3682 #3683
• Field: 新增 arrow-direction 屬性 #3679
• Sidebar: 新增 to、replace 屬性 #3696
• Sidebar: 支持通過 v-model 綁定當前項索引 #3698
• IndexBar: 新增選中狀態(tài)的類名，用于定制樣式 #3692
• Uploader: 支持 Number 類型的 name 屬性 #3681
• SwipeCell: 新增 name 屬性 #3680
• AddressEdit: 新增 detail-maxlength 屬性 #3707
• GoodsActionIcon: 新增 icon 插槽 #3705

Bug Fixes

• 修復 Collapse 在 safari 瀏覽器上動畫可能閃爍的問題 #3686
• 修復 Picker 在低版本 Android 機器上的兼容性問題 #3688

v2.0.3

2019-06-27

Features

• ActionSheet: 新增 duration 屬性 #3608
• ActionSheet: 新增 open、opened 事件 #3639
• ActionSheet: 新增 close、closed 事件 #3639
• ImagePreview: 新增 onChange 選項 #3630
• Popup: 優(yōu)化蒙層動畫時長 #3610
• Uploader: 支持點擊查看大圖 #3603
• Uploader: 支持預覽非圖片文件 #3604
• Stepper: 新增多個 Less 變量 #3599
• Icon: 更新 checked、comment、comment-o 圖標 #3615

Bug Fixes

• 修復 Icon 傳入圖片時被拉伸的問題 #3667
• 修復 ImagePreview 滾動穿透問題 #3645
• 修復 Tab 使用 title slot 時可能報錯的問題 #3631
• 修復 vetur 插件自動補全組件屬性不生效的問題 #3617

v2.0.2

2019-06-21

Features

• Picker: 優(yōu)化滾動速率 #3556
• Card: 新增 click-thumb 事件 #3586
• CouponList: 新增 enabled-title、disabled-title 屬性 #3578
• Slider: 支持傳入任意范圍的 min、max 值 #3566
• Uploader: 支持 before-read 屬性返回 Promise #3572
• NumberKeyboard: 支持 v-model 綁定輸入值 #3531
• NumberKeyboard: 新增 maxlength 屬性 #3532
• 新增 sideEffects 配置以支持 tree shaking #3530

Bug Fixes

• 修復 Sku 圖片預覽可能報錯的問題 #3569
• 修復 Button 在 safari 瀏覽器上存在外邊距的問題 #3577
• 修復 Toast clear 方法類型定義缺少參數(shù)的問題 #3542

v2.0.1

2019-06-15

Features

• Toast: 新增 icon 屬性 #3485
• DropdownMenu: 新增 direction 屬性 #3490
• NumberKeyboard: 新增 delete 屬性 #3499
• Icon: 使用 Image 組件優(yōu)化圖片布局 #3515
• Tab: 支持 string 類型的 line-width 和 line-height #3514

Bug Fixes

• 修復 Image 組件 TS 定義缺失的問題 #3520
• 修復 SwitchCell 加載圖標偏移的問題 #3501
• 修復 Locale 函數(shù)類型文案無法修改的問題 #3498
• 修復 Toast 在 multiple 模式下沒有淡出動畫的問題 #3504

v2.0.0

2019-06-12

主要變動

• 增加四個新組件
• 增加數(shù)十個 API
• 優(yōu)化無障礙訪問
• 全新的卡片風格文檔，支持文檔搜索
• 所有組件支持通過less變量自定義樣式
• 調(diào)整了部分不合理的命名，廢棄少量 API

新組件

在 2.0 版本中，我們引入了社區(qū)中呼聲最高的四個組件，分別是：

• Image 圖片，類似于小程序原生的 Image 標簽，支持多種圖片裁剪模式
• IndexBar 索引欄，通訊錄中的字母索引欄，用于長列表快速索引
• Skeleton 骨架屏，在待加載區(qū)域展示的占位區(qū)塊，提供界面加載過程中的過渡效果
• DropdownMenu 下拉菜單，用于列表的分類選擇、篩選及排序

新文檔

文檔方面，我們重新設(shè)計了文檔站點，用卡片的方式組織段落，更加直觀。對一些較為復雜的組件，我們對示例進行細粒度的拆分，添加更多的用法介紹，以幫助大家更快地上手使用。

此外，文檔站點也支持了搜索和版本切換。

樣式定制

移動端 UI 風格多變，對組件的可定制性要求較高。從 2.0 版本開始，Vant 中的所有組件都支持通過 Less 變量進行樣式定制。同時我們新增了較多樣式相關(guān)的 Props，便于快速定制組件風格。

更輕量

輕量化是 Vant 的核心開發(fā)理念之一。在過去一年多時間里，我們新增了若干個組件和數(shù)百項功能，而代碼包體積從 1.0 版本的 169kb 降低到了 2.0 版本的 161kb（45kb gzipped），平均每個組件體積下降 13%，這主要得益于組件內(nèi)部邏輯的重構(gòu)和復用。

在未來的 Vue 3.0 版本中，會提供 Function-based API 這一更優(yōu)的邏輯復用方式，預計能幫助 Vant 進一步優(yōu)化代碼包體積。

不兼容更新

2.0 版本中包含少量不兼容更新，主要是調(diào)整命名和移除個別屬性。對于正在使用 1.x 版本的項目，請按照下方的列表依次檢查，大部分項目可以無痛升級。

Actionsheet

• 重命名為ActionSheet

Button

• 移除bottom-action屬性，請使用square和size代替

Field

• 移除on-icon-click屬性，請使用click-right-icon事件代替
• icon屬性重命名為right-icon
• icon插槽重命名為right-icon
• click-icon事件重命名為click-right-icon

GoodsAction

• GoodsActionBigBtn重命名為GoodsActionButton
• GoodsActionMiniBtn重命名為GoodsActionIcon
• GoodsActionBigBtn移除primary屬性，請使用type屬性代替

Step

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

Badge

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

Loading

• 移除circle類型
• 移除gradient-circle類型

Checkbox

• 調(diào)整為flex布局，可能對原有布局產(chǎn)生影響

Radio

• 調(diào)整為flex布局，可能對原有布局產(chǎn)生影響

Waterfall

• 移除在 1.0 版本廢棄的 Waterfall 組件，請使用List組件代替，或使用獨立的@vant/waterfall包。

無障礙訪問

對以下組件增加了無障礙訪問的支持：

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

新特性

ActionSheet

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

Area

• 支持reset方法傳入code參數(shù)

Button

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

Checkbox

• 新增icon-size屬性

DatetimePicker

• 新增filter屬性

Field

• 新增input插槽
• 新增click事件
• 新增clickable屬性
• 新增label-class屬性
• 優(yōu)化輸入體驗，輸入法拼寫過程中不再會觸發(fā)v-model更新

GoodsActionButton

• 新增type屬性

Icon

• 支持Number類型的size屬性

ImagePreview

• 新增close-on-popstate屬性

List

• 優(yōu)化滾動判斷邏輯

Loading

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

Notify

• 新增onClick選項
• 新增onClose選項
• 新增onOpened選項

NoticeBar

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

PasswordInput

• 新增gutter屬性

Picker

• 支持慣性滾動
• 新增toolbar-position屬性

Popup

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

Radio

• 新增icon-size屬性

Rate

• 新增gutter屬性
• 支持String類型的size屬性

Search

• 新增clearable屬性
• 新增left-icon屬性
• 新增right-icon屬性
• 新增right-icon插槽
• 優(yōu)化輸入體驗，輸入法拼寫過程中不再會觸發(fā)v-model更新

Slider

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

Steps

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

Stepper

• 支持Number類型的input-width屬性

SubmitBar

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

SwipeCell

• 支持自動計算left-width和right-width

Switch

• 加載圖標顏色現(xiàn)在會跟隨背景色變化

SwitchCell

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

Sku

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

Tab

• 新增border屬性
• 優(yōu)化animated動畫性能
• 修復開啟animated后高度錯誤的問題

Tabbar

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

TabbarItem

• 新增name屬性

Toast

• 新增onOpened選項

Uploader

• 新增上傳區(qū)域默認樣式
• 新增delete事件
• 新增upload-text屬性
• 新增max-count屬性
• 新增preview-size屬性
• 新增preview-image屬性
• 支持通過v-model綁定文件列表
• oversize事件增加detail參數(shù)

后續(xù)計劃

我們計劃在今年下半年推出 VantWeapp 1.0 版本，目標是對標 Vant 2.0 版本，將大部分新組件和新功能同步到小程序端。

同時，Vant 3.0 版本也在醞釀當中，不出意外的話，3.0 版本會基于 Vue 3.0 實現(xiàn)，并爭取和 Vue 3.0 同期發(fā)布。

對于 Vant 1.x 版本，后續(xù)會進入維護期，跟進問題修復，但不再引入功能性改動。