更新日志

介绍

Vant 遵循 Semver 语义化版本规范。

发布节奏

  • 修订号：每周发布，包含新特性和问题修复。
  • 次版本号：每隔一至二个月发布，包含新特性和较大的功能更新，向下兼容。
  • 主版本号：无固定的发布时间，包含不兼容更新和重大功能更新。

Bug Fixes

  • Tabs: 修复开启 scrollspy 时个别情况下标题栏滚动位置错误的问题 #11116
  • Tabs: 修复开启 scrollspy 时 nav-bottom 插槽遮挡内容的问题

2022-09-24

Feature

  • Dialog: message-align 属性支持设置为 justify #11014
  • Image: 新增 block 属性

Bug Fixes

  • Tabs: 修复个别情况下页面滚动位置错误的问题 #11085
  • Tabs: 修复初始化时菜单横向滚动位置错误的问题
  • Locale: 修复读取 i18n 文案时可能获取到 JS 原生方法的问题 #11010

v3.6.2

2022-09-04

Bug Fixes

  • 修复 touchmove 事件导致控制台出现 passive event warning 的问题
  • Calendar: 修复使用 allow-same-day 属性时 default-date 不能设置为同一天的问题 #10976
  • indexBar: 修复个别情况下无法滚动到正确位置的问题 #10994
  • Swipe: 修复 touchmove 事件在边界情况下被 preventDefault 的问题
  • @vant/area-data: 更新大兴安岭相关地区码 #11000

v3.6.1

2022-08-24

Feature

  • 为 scroll 事件添加了正确的 passive 标记来提升滚动性能
  • @vant/use: 优化 useEventListener 类型定义 #10952

Bug Fixes

  • 修复 touchstart 导致控制台出现 passive event warning 的问题
  • Tabs: 修复开启 swipeable 时，resize 方法无法正确生效的问题 #10964

v3.6.0

2022-08-21

New Component

Feature

  • ConfigProvider: 新增 z-index 属性，用于设置弹窗组件的 z-index #10915
  • Form: 新增 rule 的 validateEmpty 选项
  • Popup: 新增 role 和 tabindex，优化无障碍访问 #10894
  • TouchEmulator: 支持 .mjs 后缀

Bug Fixes

  • 修复在 WebStorm 下标签无法自动补全的问题 #10946
  • Badge: 修复使用 show-zero 时字符串 '0' 不生效的问题
  • Calendar: 修复关闭弹窗过程中内容白屏的问题 #10910
  • Calendar: 修复控制台出现读取 getFullYear 异常的问题
  • Empty: 修复在 Tab 下嵌套使用时渲染异常的问题 #10943
  • Popover: 修复在 Popup 下嵌套使用时无法滚动的问题
  • PullRefresh: 修复 Chrome 控制台出现 passive event warning 的问题 #10938
  • Search: 修复 —van-search-input-height 样式变量不生效的问题

2022-08-06

Bug Fixes

  • 修复 CDN 资源中包含 NODE_ENV 导致报错的问题 #10887

v3.5.3

2022-07-31

Feature

  • Calendar: 新增 getSelectedDate 方法
  • Collapse: 新增 toggleAll 方法 #10818

Bug Fixes

  • Tabbar: 修复使用 placeholder 属性时可能无法获取底部安全区高度的问题 #10827
  • NavBar: 修复使用 placeholder 属性时可能无法获取底部安全区高度的问题
  • Popover: 修复动态设置 offset 属性不生效的问题 #10840
  • Uploader: 修复点击预览大图时会展示上传失败的图片的问题

2022-06-26

Feature

  • ActionBar: 新增 placeholder 属性 #10724
  • Field: 新增 start-validate 和 end-validate 事件
  • SubmitBar: 新增 placeholder 属性 #10725

Bug Fixes

  • List: 修复父节点样式包含 overflow: overlay 时未被判定为滚动容器的问题

2022-06-12

Feature

  • PullRefresh: 新增 change 事件 #10702

Bug Fixes

  • Calender: 修复动态设置 maxDate 或 minDate 可能导致月份渲染失败的问题
  • Popup: 修复未使用 teleport 时 deactivated 后会自动关闭的问题 #10706
  • Toast: 修复 toast.clear 缺少类型定义的问题
  • Uploader: 修复 preview-options 属性中 images 为必填字段的问题 #10698

v3.5.0

2022-06-05

支持 Nuxt 3

为了支持 Nuxt 3，我们调整了部分 ESModule 文件的后缀名，从 .js 调整为 .mjs：

  • vant/es/**/*.js —> vant/es/**/*.mjs
  • @vant/use/dist/index.esm.js —> @vant/use/dist/index.esm.mjs
  • @vant/popperjs/dist/index.esm.js —> @vant/popperjs/dist/index.esm.mjs
  • @vant/area-data/dist/index.esm.js —> @vant/area-data/dist/index.esm.mjs

webpack、vite 等构建工具默认支持 .mjs 后缀，因此不需要额外配置。对于 uni-app 等工具，可能需要添加配置来解析 .mjs 文件。

Feature

  • @vant/use @vant/popperjs 等 npm 包添加 exports 字段
  • Dialog: 支持禁用按钮 #10665
  • Locale: 新增 Bulgarian 保加利亚语
  • Locale: 新增 Farsi 波斯语 #10637
  • Locale: 新增 Greek 希腊语
  • Locale: 新增 Hebrew 希伯来语 #10591
  • Switch: 新增 node 插槽
  • Switch: 新增 background 插槽 #10666
  • Form: 新增 getValidationStatus 方法
  • Uploader: 新增 preview-delete 插槽 #10606

Bug Fixes

  • Area: 修复二次打开时未正确渲染遮罩层的问题
  • field: 修复动态渲染插槽时可能导致输入框拼音被清空的问题 #10582
  • Picker: 修复动态设置 columns-field-names 不生效的问题

2022-05-02

Feature

  • Form: 支持同时设置多个 validate-trigger 值 #10544
  • Empty: 支持在无网络的环境下离线使用，图片从 CDN 调整为内联的 SVG 图片 #10515
  • Loading: 优化无障碍访问 #10568

Bug Fixes

  • @vant/area-data: 修复发布到 npm 时包含 tsconfig.json 文件导致编译错误的问题

2022-04-16

Feature

  • CalendarDay: 增加日期行间距 #10441
  • Empty: 支持单独设置 image 的宽高
  • Field: 新增 enterkeyhint 属性 #10478
  • Form: 新增 getValues 方法
  • Icon: 新增 qq、weibo 等图标 #10468
  • Locale: 新增 Danish 丹麦语
  • ShareSheet: 不再依赖 CDN 上的图片资源，使用 iconfont 代替 #10469
  • web-types.json 文件增加 event arguments 信息

Bug Fixes

  • DatetimePicker: 修复 modeValue 与选中的数据不一致的问题 #10448
  • Rate: 修复多行时滑动选中不正确的问题

2022-03-29

Feature

  • @vant/area-data: 新增南京市江北新区 #10410
  • CouponList: 更新优惠券为空时的占位图
  • Locale: 新增 Icelandic 冰岛语 #10418
  • Locale: 新增 Lao 老挝语
  • Locale: 新增 Swedish 瑞典语 #10419
  • NumberKeyboard: 优化随机排序算法
  • Uploader: preview-size 属性支持单独设置宽度和高度 #10438

Bug Fixes

  • Calendar: 修复 scrollToDate 方法在个别情况下不生效的问题
  • DatetimePicker: 修复动态改变最大值或最小值时，currentDate 不准确的问题 #10431
  • IndexBar: 修复底部索引高亮状态不正确的问题
  • Tab: 修复使用 v-if 延迟渲染更新不正确的问题 #10392

v3.4.6

2022-03-13

Feature

  • Style: 新增 van-safe-area-top 样式类
  • Calendar: 新增 safe-area-inset-top 属性 #10358
  • Popup: 新增 safe-area-inset-top 属性

Bug Fixes

  • Skeleton: 修复个别情况下出现 non-props attributes warning 的问题 #10384
  • SwipeCell: 修复阻止滑动事件冒泡无效的问题
  • Toast: 修复切换 type 时 message 不显示的问题 #10311
  • 修复提示 VisibilityState 类型不存在的问题

2022-02-14

Feature

  • CollapseItem: 新增 lazy-render 属性 #10270
  • Dialog: 支持通过 enter/esc 进行键盘操作
  • Locale: 新增 Bangla 孟加拉语 #10287
  • Locale: 新增 Indonesian 印度尼西亚语
  • Locale: 新增 Italian 意大利语 #10288
  • Locale: 新增 Ukrainian 乌克兰语
  • Locale: 新增 Vietnamese 越南语 #10294

style

  • SubmitBar: 将冒号调整为英文冒号

Types

  • IndexBar: 修复 index-list 属性无法传入 number 类型的问题 #10273
  • Toast: 修复缺少 teleport 属性定义的问题
  • Uploader: 修复 UploaderBeforeRead 类型定义不准确的问题 #10274

v3.4.4

2022-02-07

  • Vant 3 对应的 npm tag 切换为 latest

v3.4.3

2022-01-26

Feature

  • Locale: 新增 Hindi 印地语
  • Locale: 新增 Korean 韩语 #10243
  • 优化 cursor 样式

Bug Fixes

  • Icon: 修复使用图片作为图标时水平未对齐的问题 #10220
  • TreeSelect: 修复重复点击时无法触发 click-nav 事件的问题

2022-01-17

Feature

  • Cascader: 新增 show-header 属性 #10202
  • Image: 新增 position 属性
  • ImagePreview: 优化缩放手势的流畅度 #10187
  • Overlay: 新增 lazy-render 属性
  • web-types.json 现在默认使用英文描述 #10207

Bug Fixes

  • Calendar: 修复范围选择包括被禁用的日期时可能选择错误的问题
  • Image: 修复使用 lazy-load 时可能无法正常加载的问题 #10193
  • ImagePreview: 修复快速缩放手势导致预览关闭的问题
  • Skeleton: 修复 row 属性为字符串类型时不生效的问题 #10172
  • NavBar: 修复在 safari 上占位元素高度错误的问题
  • Tabbar: 修复在 safari 上占位元素高度错误的问题 #10195

v3.4.1

2022-01-10

Bug Fixes

  • Area: 修复缺少遮罩层的问题
  • DatetimePicker: 修复边界场景下出现报错的问题 #10140
  • Popover: 修复箭头和弹出框之间存在缝隙的问题

2022-01-01

Bug Fixes

  • Icons: 修复 URL 缺少协议导致个别浏览器出现异常的问题 #10079
  • Picker: 修复选项为空时也会渲染选择框的问题
  • Popup: 修复 close 事件触发两次的问题 #10132
  • PullRefresh: 修复在个别浏览器上会触发原生回弹效果的问题
  • Step: 修复 inactive-color 属性未正确生效的问题 #10049
  • SwipeCell: 修复打开状态下也会触发 open 事件的问题
  • swipe: 修复个别情况下无法正确滚动的问题 #10052
  • Tabs: 修复标签页为空时会渲染一个错误的底部条的问题 #10063

Feature

  • ActionBarIcon: 新增 badge-props 属性
  • ActionSheet: 新增 option 插槽 #10065
  • Badge: 新增 badge-props 属性
  • GridItem: 新增 badge-props 属性 #10097
  • Icons: 新增 cash-o 图标
  • ImagePreview: 新增 overlayClass 选项 #10044
  • Notify: 新增 position 属性
  • Popover: 新增 action 插槽 #10091
  • Search: 新增 click-left-icon、click-right-icon 事件
  • SidebarItem: 新增 badge-props 属性 #10106
  • Swipe: indicator 插槽新增 total 参数
  • TabbarItem: 新增 badge-props 属性 #10092
  • Tabs: 新增 shrink 属性

style

  • PullRefresh: 移除 user-select: none 样式 #10078
  • TreeSelect: 允许选中 content 插槽中的文字

Types

  • 增加所有组件的全局类型，在 volar 中提供默认提示 #10136
  • Field: 修复 type 属性定义不全的问题
  • Popup: 导出 PopupInstance 类型 #10062
  • Search: 修复事件类型定义不全的问题

2021-12-12

Feature

  • Badge: 新增 position 属性 #10024

Bug Fixes

  • DatetimePicker: 修复调用 Picker 实例方法后日期未正确更新的问题
  • Field: 修复输入内容包含 emoji 时，长度计算错误的问题 #10033
  • Pagination: 修复 change 事件不触发的问题
  • 修复 tree shaking 不生效的问题 #10034

v3.3.6

2021-12-05

Bug Fixes

  • 修复 ssr.js 文件引用路径错误的问题

2021-12-02

Bug Fixes

  • 修复 exports field 导致 SSR 无法正确引入的问题 #9988
  • 修复 exports field 导致 unplugin-vue-components 引用报错的问题

2021-12-01

  • 修复 lib/ssr.js 文件不存在导致 SSR 失败的问题

2021-11-30

Feature

  • 支持在 nuxt3 中使用 #9970
  • Locale: 新增 pt-BR 葡萄牙语 (巴西)

Bug Fixes

  • Swipe: 修复 iOS 系统下圆角失效的问题 #9958
  • Uploader: 修复图片预览卡顿的问题

2021-11-28

Feature

  • 新增 中的 exports 字段 #9952
  • Tabbar: 支持在 route 模式下匹配子路由
  • Tabs: 将 van-tab__pane-wrapper 类重命名为 van-tab__panel-wrapper #9951

Bug Fixes

  • Calendar: 修复 scrollToDate 方法无法精确滚动到对应日期的问题
  • Swipe: 修复开始滑动时未阻止 touchmove 事件行为的问题 #9920

2021-11-23

Bug Fixes

  • AddressEdit: 修复表单校验不通过时也会触发 save 事件的问题 #9917

v3.3.0

2021-11-19

Accessibility

改善以下组件的无障碍访问体验：

  • Cascader: 增加 role=”menu”, tabindex, aria-checked, aria-disabled 属性
  • CountDown: 增加 role=”timer” 属性 #9906
  • DropdownMenu: 增加 role=”menu”, tabindex, aria-labelledby 属性
  • Field: 增加 aria-labelledby 属性 #9883
  • List: 增加 role=”button”, tabindex 属性
  • Pagination: 增加 role=”navigation” 和 button 标签 #9901
  • Popover: 增加 tabindex, aria-disabled 属性
  • Rate: 增加 aria-disabled, aria-readonly 属性 #9881
  • Search: 提供默认的 id 属性 属性
  • Sidebar: 增加 role=”tab”, tabindex, aria-selected 属性 #9903
  • Slider: 增加 aria-disabled, aria-readonly 属性
  • Stepper: 增加 aria-disabled 属性 #9877
  • Stepper: 增加 role=”group” 属性
  • Switch: 增加 tabindex 属性 #9887
  • Tabbar: 增加 role=”tab”, tabindex, aria-selected 属性
  • Tabs: 增加 aria-controls 属性 #9882
  • Tabs: 增加 aria-disabled 属性
  • Tabs: 增加 tabindex, aria-orientation 属性 #9872
  • Uploader: 删除按钮增加 role=”button”, tabindex, aria-label 属性
  • 移除禁用元素的 tabindex 属性 #9879

Feature

  • Popup: 移除多余的 click 事件监听
  • Field: 导出 FieldRuleValidator 等多个类型定义 #9843
  • Empty: 压缩 svg 图标
  • NumberKeyboard: 压缩 svg 图标 #9869
  • Tabs: 将 van-tab__pane 类重命名为 van-tab__panel

Bug Fixes

  • Popover: 修复 useClickAway 方法在 SSR 时报错的问题 #9899
  • CouponList: 修复列表高度不正确的问题
  • Field: 修复点击只读输入框会触发表单验证的问题 #9862
  • Switch: 修复全局设置 font-size 时样式错误的问题
  • Tabbar: 修复 route 模式下无法触发 before-change 属性的问题 #9856

v3.2.8

2021-11-09

Feature

  • Cascader: 新增 options-bottom 插槽
  • SubmitBar: 新增 SubmitBarTextAlign 类型 f95567
  • PasswordInput: 新增 PasswordInputProps 类型

Bug Fixes

  • NavBar: 修复 NavBarProps 拼写错误的问题 #9818
  • Progress: 修复圆角大小错误的问题
  • SubmitBar: 修复未导出 SubmitBarProps 的问题 #9819
  • Tabs: 修复 click-tab 触发顺序早于 before-change 的问题

2021-11-04

Feature

  • 导出所有组件的 Props 类型 #9717
  • 新增 —van-text-color-2 CSS 变量
  • 新增 —van-text-color-3 CSS 变量 #9776
  • Cascader: 新增 options-top 插槽
  • Coupon: 新增 —van-coupon-content-text-color CSS 变量 #9760
  • Picker: 新增 —van-picker-mask-color CSS 变量

Bug Fixes

  • Field: 修复 textarea 在聚焦和失焦时未重新计算高度的问题 #9719
  • 修复 —van-border-color 变量不生效的问题

2021-10-24

  • AddressEdit: 移除点击删除按钮的弹窗交互 #9671
  • Calendar: 新增 confirm-text 插槽
  • Progress: 新增 —van-progress-inactive-color 样式变量 #9711
  • ShareSheet: 新增 round 属性
  • 支持通过 css vars 定义渐变的背景色 #9678

Performance

  • 减少 useWindowSize 绑定的事件监听器数量
  • Empty: 压缩 empty 图标 #9673

Types

  • Cascader: 新增 CascaderProps 类型
  • Checkbox: 导出更多类型定义 #9665
  • Steps: 新增 StepsDirection 类型

Bug Fixes

  • ActionSheet: 修复 closeOnPopstate 属性不生效的问题 #9644
  • AddressEdit: 修复 address-edit-button-font-size 变量不生效的问题
  • Badge: 修复使用 dot 属性且自定义大小时样式错误的问题 #9686

2021-10-08

Feature

  • Field: 新增 error-message 插槽 #9634

Performance

  • 移除 CustomEvent polyfill
  • 移除 passive event polyfill #9590

Types

  • Button: 新增 ButtonNativeType、ButtonIconPosition 类型
  • Skeleton: 新增 SkeletonAvatarShape 类型 #9605

Bug Fixes

  • Toast: 修复同步调用 Toast.clear 不生效的问题
  • 修复全量引入时，useCustomFieldValue 不生效的问题 #9642

2021-09-26

Feature

  • Icon: 新增 guide-o 图标 c5f45a
  • Search: 新增 autocomplete 属性
  • Search: 新增 name 属性 #9563

Performance

  • Lazyload: 移除生产环境的 log 信息
  • Lazyload: 移除 edge 15 polyfill 00b156
  • @vant/use: 移除 raf polyfill

Types

  • 导出部分组件的 props 类型 a3380f
  • 修复 $toast、$dialog、$notify 类型缺失的问题
  • Popover: PopoverAction 类型支持扩展字段 #9554

Bug Fixes

  • Collapse: 修复 wrapper ref 可能为空导致报错的问题
  • CouponList: 修复错误的滚动条样式 #9480
  • Radio: 修复 icon ref 可能为空导致报错的问题
  • Tabs: 修复多个 Tabs 组件同时存在时动画失效的问题 #9543

v3.2.3

2021-09-12

Bug Fixes

  • Button: 修复无法通过 CSS 变量设置渐变背景色的问题
  • Calendar: 日历组件已经禁用部分日期依然可以选择日期区间的问题 #9361
  • Field: 修复全局设置 user-select: none 时 IOS 下无法输入的问题
  • FIeld: 修复 field-error-message-font-size 变量名称错误的问题 #9394
  • Popup: 修复在 keep-alive 下激活时无法开启自动轮播的问题
  • Theme: 移除了内部 less import 的波浪号 a7ab2f
  • slider: 修复双滑块情况下，传入空数组无法滑动的问题
  • Uploader: 修复 —van-uploader-delete-icon-size 变量未正确生效的问题 #9453

v3.2.2

2021-09-02

Feature

  • Field: 新增 id 属性
  • Field: 新增 van-field__error 类名 #9327
  • Field: label 现在会使用原生 label 标签
  • Popover: 新增 show-arrow 属性 #9372
  • Progress: 新增过渡动画效果
  • Search: 新增 id 属性 #9349
  • Tab: 新增 show-zero-badge 属性
  • Locale: 精简一部分国际化文本配置 #9329

Bug Fixes

  • AddressEdit: 移除了无效的样式变量
  • Progress: 修复在 v-show 内使用时无法正确渲染的问题 841e09
  • Progress: 修复 percentage 属性缺少默认值的问题
  • 修复动画相关的 CSS 变量不生效的问题 #9337

v3.2.1

2021-08-22

Feature

  • Circle: 新增 start-position 属性
  • Slider: 新增 reverse 属性 #9308
  • NumberKeyboard: 新增 van-number-keyboard-key-background-color CSS 变量
  • PasswordInput: add password-input-text-color CSS 变量 #9304

Bug Fixes

  • Calendar: 修复 month-show 事件缺少 title 参数的问题
  • Dialog: 修复 beforeClose 重复触发的问题 #9283
  • Field: 修复 FieldInstance 类型未导出的问题 #9254
  • Rate: 修复 count 属性传入字符串类型时展示错误的问题
  • TreeSelect: 修复 CSS 负数变量不生效导致样式错误的问题 #9306

v3.2.0

2021-08-12

Feature

  • Form: 新增 useCustomFieldValue 方法，用于自定义表单项
  • Button: loading-size 属性支持 number 类型 #9177
  • Style: 新增 van-safe-area-bottom 样式类

Types

  • AddressEdit: 新增 AddressEditInstance 类型 #9197
  • Area: 新增 AreaInstance 类型
  • Calendar: 新增 CalendarInstance 类型 #9165
  • Checkbox: 新增 CheckboxInstance 类型
  • CheckboxGroup: 新增 CheckboxGroupInstance 类型 #9142
  • CollapseItem: 新增 CollapseItemInstance 类型
  • CountDown: 新增 CountDownInstance 类型 #9153
  • DatetimePicker: 新增 DatetimePickerInstance 类型
  • DropdownItem: 新增 DropdownItemInstance 类型 #9214
  • Field: 新增 FieldInstance 类型
  • Form: 新增 FormInstance 类型 #9139
  • ImagePreview: 新增 ImagePreviewInstance 类型
  • IndexBar: 新增 IndexBarInstance 类型 #9246
  • List: 新增 ListInstance 类型
  • NoticeBar: 新增 NoticeBarInstance 类型 #9245
  • Picker: 新增 PickerInstance 类型
  • Progress: 新增 ProgressInstance 类型 #9247
  • Search: 新增 SearchInstance 类型
  • Swipe: 新增 SwipeInstance 类型 #9158
  • SwipeCell: 新增 SwipeCellInstance 类型
  • Tabs: 新增 TabsInstance 类型 #9174
  • Uploader: 新增 UploaderInstance 类型

Bug Fixes

  • Badge: 修复 offset 为负数时不生效的问题 #9199
  • Image: 修复圆角数值不正确的问题
  • Field: 修复 Textarea 内容较多时，输入会导致页面滚动到顶部的问题 #9206
  • Notify: 修复默认选项被错误覆盖的问题
  • Rate: 修复星星较多时无法自动换行的问题 #9192
  • Tabs: 修复 card 类型内边距错误的问题
  • Toast: 修复某些情况下 message 无法更新的问题 #9196

v3.1.5

2021-07-26

Feature

  • AddressEdit: 新增 address-edit-button-font-size 样式变量
  • Icon: 新增 shield-o 图标 #9082
  • Locale: 新增 Russian 俄罗斯语言包
  • Toast: 优化不可点击状态下的光标展示 #9116
  • Uploader: 新增 click-upload 事件
  • Uploader: 新增 readonly 属性 #9118

Bug Fixes

  • Icon: 修复 invitation 图标名称拼写错误
  • NumberKeyboard: 修复点击外部时会触发 close 事件的问题 #9108
  • Search: 修复左侧图标颜色不正确的问题
  • Tabbar: 修复 tabbar-item-icon-margin-bottom 样式变量名称 #9101

v3.1.4

2021-07-19

Feature

  • ActionSheet: 新增 before-close 属性
  • Cascader: 新增 option 插槽 #9036
  • Cascader: 优化光标展示
  • Popup: 新增 before-close 属性 #9067
  • ShareSheet: 新增 before-close 属性
  • Tabs: 新增 click-tab 事件 #9037

Bug Fixes

  • Field: 修复 label-align 为 right 时 required 标记位置错误的问题
  • List: 修复在 Tabs 内嵌套使用时，切换 Tabs 不触发 load 事件的问题 #9022
  • Popup: 修复某些情况下未正确触发 open、close 事件的问题

2021-07-11

Feature

  • Calendar: 新增 click-subtitle 事件 #8981
  • Calendar: 新增 subtitle 插槽
  • ConfigProvider: 新增 icon-prefix 属性 #8986
  • Slider: 新增 drag 事件参数
  • Slider: 新增 left-button、right-button 插槽 #8989
  • touch-emulator: 支持通过白名单排除节点

Bug Fixes

  • Step: 修复 z-index 过高问题 #9003

v3.1.2

2021-07-03

Feature

  • Area: 新增 toolbar、confirm、cancel 插槽
  • Calendar: 优化日期较多时的加载性能 #8955
  • Cascader: 新增 disabled 选项
  • ConfigProvider: 新增 tag 属性 #8967
  • Picker: 新增 toolbar 插槽，将 default 插槽标记为废弃
  • Picker: 允许 Option 的值为 number 类型 #8951
  • Picker: 新增 picker-option-padding CSS 变量

Bug Fixes

  • Toast: 修复文字换行问题 #8965

v3.1.1

2021-06-27

Feature

  • Cell: 新增 value 插槽，将 default 插槽标记为废弃
  • CollapseItem: 新增 label 插槽 #8934
  • NoticeBar: 新增 reset 方法
  • Tabs: 新增 nav-bottom 插槽 #8915

v3.1.0

2021-06-22

New Component

  • 新增 组件，用于主题定制 #8854

Feature

  • 所有组件支持 CSS 变量 fe1cba
  • 新增 primary-color 等样式变量
  • Checkbox: icon 插槽新增 disabled 参数 #8839
  • Cascader: 新增 className 选项
  • Cascader: 新增 color 选项 #8883
  • CellGroup: 新增 inset 属性
  • GridItem: 新增 reverse 属性 #8878
  • IndexBar: 新增 teleport 属性

Bug Fixes

  • Dialog: 修复 message 作为函数时返回 HTML 字符串无效的问题 #8872
  • Slider: 修复设置 step 属性时，输入值格式化错误的问题

2021-06-03

Feature

  • Button: 新增 icon 插槽 #8783
  • CouponList: 新增 list-footer、disabled-list-footer 插槽
  • Locale: 新增 French 法语语言包 #8795
  • Popup: 新增 icon-prefix 属性
  • Popup: 新增 overlay-content 插槽 #8794

Bug Fixes

  • Collapse: 修复在 safari 上可能出现渲染异常的问题
  • NoticeBar: 修复在 Popup 内嵌套使用时播放异常的问题 #8789
  • List: 移除未使用的 @list-icon-margin-right 变量
  • @vant/touch-emulator: 修复 SSR 时报错的问题 #8767

v3.0.17

2021-05-23

Feature

  • ActionBarIcon: 新增 icon-prefix 属性
  • Calendar: 新增 over-range 事件 #8739
  • Calendar: 新增 show-range-prompt 属性
  • Calendar: 新增 top-info、bottom-info 插槽 #8716
  • GridItem: 新增 icon-color 属性
  • NoticeBar: 默认 speed 由 50 调整为 60 #8694
  • Popover: 新增 icon-prefix 属性
  • Toast: 新增不同类型 Toast 的 transition 过渡效果 #8743
  • Uploader: max-size 属性支持函数格式

Bug Fixes

  • Button: 修复 tsx 下使用时缺少 onClick 类型定义的问题 #8665
  • Calendar: 修复默认日期不正确的问题
  • DatetimePicker: 修复动态设置 minDate、maxDate 时异常的问题 #8658
  • List: 修复在开启 animated 的 Tabs 下使用时加载异常的问题
  • Tabs: 修复滚动事件监听不正确的问题 #8734
  • Toast: 修复多次调用时持续时间不正确的问题

2021-05-03

Feature

  • Swipe: 新增 indicator 插槽的 active 参数 #8645
  • Cascader: 新增 @cascader-header-padding less 变量
  • Steps: 新增 icon-prefix 属性 #8631
  • 导出更多类型定义

Bug Fixes

  • Stepper: 修复 blur 事件触发时机 #8620
  • SubmitBar: 修复 @submit-bar-price-font-size 变量不生效的问题
  • Swipe: 修复在 Popup 内时展示可能不正确的问题 #8643
  • Tabs: 修复在 Popup 内时展示可能不正确的问题

2021-04-25

Feature

  • Cascader: 新增 click-tab 事件 #8606

Bug Fixes

  • Tab: 修复 SSR 时报错的问题
  • Rate: 修复点击半星时未正确选中的问题 #8580
  • Tag: 修复使用 color 和 plain 属性时边框颜色错误的问题

2021-04-18

Feature

  • Badge: offset 属性支持传入任意单位 35edb7
  • Rate: 支持在 readonly 时渲染任意小数结果

Bug Fixes

  • ContactList: 修复 nodes 类型错误 0b764b

v3.0.13

2021-04-11

Feature

  • ActionBar: 新增 @action-bar-icon-background-color 样式变量
  • Popover: 升级依赖的 @popperjs/core 到 2.9.2 版本 0d1323
  • perf: 优化包体积

Types

  • Popup: 修复 PopupCloseIconPosition 类型错误 15d901
  • Search: 修复在 tsx 下部分 props 不存在的问题
  • Stepper: 优化 theme 属性类型定义 #8489

Bug Fixes

  • Field: 修复 autofocus 属性不生效的问题

2021-04-05

Feature

  • CollapseItem: 新增 readonly 属性 #8445
  • Field: 新增 clear-icon 属性
  • Search: 新增 clear-icon 属性 #8439
  • Search: 新增 error-message 属性
  • Search: 新增 formatter、format-trigger 属性 #8441

Bug Fixes

  • 修复 WebStorm 下组件标签提示不正确的问题

2021-03-30

Feature

  • Cascader: 新增 swipeable 属性 #8383
  • Dialog: 新增 footer 插槽
  • Dialog: 支持在 message 中传入 render 函数 #8420
  • Image: 新增 icon-size 属性
  • Row: 新增 wrap 属性 #8393

Bug Fixes

  • Field: 修复在个别情况下错误地清除错误提示的问题
  • Sticky: 修复在 SSR 时提示 Element 不存在的问题 #8407
  • Tabs: 修复在 safari 上左滑退出页面时手势判断错误的问题

2021-03-19

Feature

  • ActionSheet: 新增 cancel 插槽 #8333
  • Badge: 新增 show-zero 属性
  • Cascader: 新增 close-icon 属性 #8334
  • Popover: 新增 close-on-click-overlay 属性
  • Popover: 新增 duration 属性 #8355
  • Popover: 新增 overlay-class 属性
  • Popover: 新增 overlay-style 属性 #8354
  • ShareSheet: 新增 cancel 插槽
  • Tag: close 事件新增 event 参数 #8337
  • Toast: 新增 iconSize 选项

Feature

  • ContactList: 新增 @contact-list-item-radio-icon-color Less 变量 #8322
  • Coupon: 新增 @coupon-corner-checkbox-icon-color Less 变量
  • List: 新增 @list-loading-icon-size Less 变量 #8365
  • Loading: 新增 @button-loading-icon-size Less 变量
  • PullRefresh: 新增 @pull-refresh-loading-icon-size Less 变量 #8366

Bug Fixes

  • Popover: 修复 close-on-click-outside 属性不生效的问题
  • Swipe: 修复添加 scale 动画时宽度计算错误的问题 #8330

v3.0.9

2021-03-08

Feature

  • AddressList: 新增 tag 插槽

Bug Fixes

  • 修复主题定制不生效的问题 #8301
  • 修复在 TS 下使用 app.use 注册组件报错的问题

2021-03-07

Types

  • 完善所有组件的类型定义 #8264

Feature

  • ImagePreview: 新增 transition 属性
  • ImagePreview: 新增 overlay-style 属性 #8276
  • Locale: 新增 th-TH 泰语
  • PullRefresh: 新增 pull-distance 属性 #8280
  • Button: 新增若干个 Less 变量

Bug Fixes

  • ActionSheet: 修复返回页面时可能错误地重新打开的问题 #8272
  • Stepper: 修复在 iOS14 下禁用时输入框文字不可见的问题
  • Swipe: 修复动态插入轮播图时渲染错误的问题 #8288

2021-02-28

Feature

  • Notify: 新增 lockScroll 选项 #8168
  • Popup: click-overlay 事件新增 Event 参数
  • ShareSheet: 新增 overlay-style 属性 #8225
  • ShareSheet: 新增 overlay-class 属性
  • Step: 新增 finish-icon 插槽 #8241
  • Steps: 新增 finish-icon 属性
  • Uploader: 新增 @uploader-mask-text-color 样式变量 #8064

perf

  • 包体积优化：调整适配的浏览器版本，与 Vue 3 保持一致

Bug Fixes

  • ActionSheet: 修复 safe-area-inset-bottom 属性不生效的问题 #8085
  • DateTimePicker: 修复 v-model 为 null 时初始值不正确的问题
  • Form: 修复提交表单时可能滚动到错误的表单项的问题 #8159
  • ImagePreview: 修复第二次调用时可能出现渲染不正确的问题
  • IndexBar: 修复初始化时激活的锚点未正确渲染的问题 #8164
  • Popup: 修复动态设置 lock-scroll 属性不生效的问题
  • Swipe: 修复初始化时 active 值可能错误的问题 #8061
  • SwipeCell: 修复点击外部时 click 事件参数不正确的问题
  • Tabbar: 修复 name 为 0 时激活的选项可能不正确的问题 #8125
  • Tabs: 修复 v-model 为 0 时激活的标签页可能不正确的问题
  • Toast: 修复 SSR 时可能报错的问题 #8214

v3.0.6

2021-01-31

Feature

  • Area: 支持超过 6 位的地区码
  • Form: show-error 属性的默认值调整为 false #8016
  • Form: 支持在 validator 中返回错误提示
  • NumberKeyboard: 新增 blur-on-close 属性 #8033
  • Popover: 新增 click-overlay 事件
  • Popover: 支持在 action 选项对象中配置 color 字段 #8049
  • Sticky: 新增 position、offset-bottom 属性

Bug Fixes

  • Button: 修复加载状态下会触发表单提交的问题 #8018
  • Calendar: 修复无法使用 scrollToDate 方法的问题
  • Empty: 修复 linearGradient id 可能导致冲突的问题 #8013
  • Toast: 修复 closeOnClickOverlay 设置为 true 不生效的问题

2021-01-24

Feature

  • Badge: 新增 offset 属性 e0b463
  • Calendar: reset 方法支持重置到指定日期
  • Icons: 新增 wechat 图标, 重命名原 wechat 图标为 wechat-pay b3cd8c
  • ImagePreview: 调用 swipeTo 方法后自动重置缩放状态
  • ImagePreview: 调整 swipeDuration 的默认值为 300ms #7970
  • ShareSheet: 新增 wechat-moments 朋友圈图标
  • Slider: 新增 readonly 属性 4cd991

style

  • ShareSheet: 更新 qrcode 图标
  • TreeSelect: 新增右侧选项点击反馈 bada31

Bug Fixes

  • Calendar: 修复调用 reset 方法时未重置到默认日期的问题
  • Dialog: 修复切换 allowHtml 时 message 渲染不正确的问题 #7968
  • ImagePreview: 修复 scale 事件的 index 参数为 undefined 的问题

2021-01-17

  • Cascader: 新增 field-names 属性，用于自定义字段名 #7933
  • Cell: 支持在设置 is-link 时将 clickable 设置为 false 来禁用点击状态
  • DropdownItem: 支持传入数组或对象格式的 title-class #7926
  • Popup: 支持传入数组或对象格式的 overlay-class
  • Toast: 新增 overlayClass 选项 #7925
  • Toast: 新增 overlayStyle 选项

Bug Fixes

  • AddressEdit: 修复无法调用 setAreaCode 方法的问题 6a184f
  • Circle: 修复渐变色不生效的问题
  • NumberKeyboard: 修复 delete、extra-key 插槽不生效的问题 52a0e5
  • Search: 修复控制台存在 update:modelValue warning 的问题
  • Swipe: 修复页面隐藏时未暂停自动轮播的问题 1c428f

v3.0.3

2021-01-10

Feature

  • Field: 新增 autocomplate 属性

Bug Fixes

  • Area: 修复无法调用 getValues 方法的问题 03c7b4
  • ImagePreview: 修复 close-on-popstate 属性不生效的问题
  • List: 修复更新 error 属性后未触发位置检查的问题 b79c32

v3.0.2

2021-01-02

Feature

  • Calendar: 新增 scrollToDate 方法
  • Form: 新增 disabled 属性 #7830
  • Form: 新增 readonly 属性
  • Loading: 新增 text-color 属性 #7806
  • Picker: 新增 columns-field-names 属性
  • NumberKeyboard: 新增 random-key-order 属性 #7841

Bug Fixes

  • Calendar: 修复 title 插槽不生效的问题
  • Calendar: 修复动态设置 defaultDate 不生效的问题 #7815
  • Popup: 修复组件销毁时未解除滚动锁定的问题
  • Stepper: 修复动态设置 modelValue 时未格式化的问题 81494d

v3.0.1

2020-12-27

Feature

  • Form: valdiate 方法支持校验多个表单项
  • Form: resetValidation 方法支持重置多个表单项 #7811
  • Stepper: 新增 show-input 属性，用于控制是否显示输入框
  • IndexBar: 新增 scrollTo 方法 #7794

Bug Fixes

  • Cascader: 修复动画闪烁的问题
  • CountDown: 修复 SSR 过程中内存泄露的问题 #7808
  • Image: 修复 SSR 时提示 DOM 不匹配的问题
  • Popup: 修复滚动穿透的问题 #7738
  • Stepper: 修复 change 事件重复触发的问题
  • Swipe: 修复 SSR 样式不正确的问题 #7821
  • Swipe: 修复在 keepalive 标签内使用时显示不正确的问题

更新内容

请参考 Vant 3.0 正式发布：全面拥抱 Vue 3。

v3.0.0-rc.4

2020-12-21

New Component

  • 新增 Cascader 级联选择组件

Feature

  • Stepper: 新增 show-input 属性 #7785
  • uploader: 支持在 fileList 的选项中单独配置 imageFit deletable previewSize beforeDelete 字段

Types

  • Lazyload: 修复类型定义错误 #7757

v3.0.0-rc.3

2020-12-10

Breaking Change

  • Stepper: async-change 属性重命名为 before-change，并调整使用方法

perf

  • Stepper: 优化代码包体积 #7675

Bug Fixes

  • Stepper: 修复禁用按钮仍然能点击的问题
  • Tabs: 修复动态设置 active 值无效的问题 #7717
  • 包含 v2.11.3 版本的所有改动和修复

v3.0.0-rc.2

2020-12-04

perf

  • 优化包体积大小

Bug Fixes

  • Lazyload: 修复未导出 ESModule 的问题 #7685
  • NumberKeyboard: 修复 hide-on-click-outside 属性不生效的问题 #7667
  • Uploader: 修复动态修改 status 不生效的问题
  • Types: 修复 teleport 类型定义错误的问题 #7687
  • 包含 v2.11.2 版本的所有改动和修复

v3.0.0-rc.1

2020-12-01

Breaking Change

  • Popover: trigger 属性的默认值调整为 click

Feature

  • Lazyload: 适配 Vue 3 d3ca40
  • 包含 v2.11.1 版本的所有改动和修复

style

  • Circle: 新增 @circle-color Less 变量
  • Circle: 新增 @circle-layer-color Less 变量 65a5ed
  • Circle: 新增 @circle-size Less 变量
  • IndexBar: 默认高亮颜色调整为红色 65b680
  • IndexBar: 右边距调整为 8px aad055

Bug Fixes

  • Image: 修复 lazy-load 属性不生效的问题
  • Lazyload: 修复类型定义错误的问题 d0c4c2
  • Popup: 修复 transition-appear 属性不生效的问题

2020-11-22

Bug Fixes

  • Radio: 修复 Radio 无法操作的问题 0f7c9a

v3.0.0-beta.9

2020-11-22

New Component

更新日志 - 图2

Feature

  • Search: 新增 blur 方法
  • Search: 新增 focus 方法 2833bc

Bug Fixes

  • Checkbox: 修复 bind-group 属性不生效的问题
  • Badge: 修复无类型定义的问题 c487b3
  • 包含 v2.11.0 版本的所有改动和修复

v3.0.0-beta.8

2020-11-15

Bug Fixes

  • ActionSheet: 修复选项禁用或加载时仍能点击的问题
  • ActionSheet: 修复 callback 选项不生效的问题 27b761
  • Calendar: 修复 default-date 为 null 时渲染失败的问题
  • DatetimePicker: 修复 DOM 上渲染多余属性的问题 ed332d
  • NoticeBar: 修复初始化逻辑执行多次的问题
  • Swipe: 修复在 lazy-render 模式下渲染失败的问题 e06ba4
  • Swipe: 修复初始化逻辑执行多次的问题
  • Tabs: 修复初始化逻辑执行多次的问题 599e81
  • 包含 v2.10.14 版本的所有改动和修复

v3.0.0-beta.7

2020-11-08

Bug Fixes

  • Calendar: 修复动态设置 minDate 和 maxDate 时展示错误的问题
  • DropdownMenu: 修复无法禁用 closeOnClickOutside 属性的问题 #7473
  • Uploader: 修复在 before-read 返回 true 无效的问题
  • Uploader: 修复在 delete 事件中无法获取 index 的问题 #7481
  • 包含 v2.10.13 版本的所有改动和修复

v3.0.0-beta.6

2020-11-01

Bug Fixes

  • Swipe: 修复开启 lazy-render 且 loop 为 false 时渲染节点不正确的问题
  • Swipe: 修复开启 lazy-render 时子节点被重复挂载的问题 #7466
  • Tabs: 修复初始动画错误的问题
  • ActionBar: 修复类型定义不存在的问题 #7440
  • 包含 v2.10.12 版本的所有改动和修复

2020-10-24

Bug Fixes

  • Swipe: 修复动态插入轮播时无法滚动的问题 #7366
  • Toast: 修复 forbidClick 属性不生效的问题
  • Toast: 修复 duration 变化未生效的问题 #7394
  • 包含 v2.10.11 版本的所有改动和修复

v3.0.0-beta.4

2020-10-18

refactor

  • Layout: 默认使用 flex 布局，移除 type 属性

style

  • Stepper: 布局方式调整为 inline-block e9c282

Bug Fixes

  • ContactList: 修复 select 事件重复触发的问题
  • Search: 修复布局错误的问题 9cd48e
  • Image: 修复图片加载错误时仍会渲染图片节点的问题
  • Pagination: 修复 change 事件触发时机错误的问题 346035
  • Toast: 修复展示时会锁定滚动的问题
  • 包含 v2.10.10 版本的所有改动和修复

2020-10-03

breaking changes

  • Checkbox: 在 Cell 内部使用时，现在需要手动添加 @click.stop 来阻止事件冒泡 #7023

Feature

  • 新增 Badge 徽标组件
  • Tab: 增加滑动切换动画 #1174
  • 包含 v2.10.9 版本的所有改动和修复

v3.0.0-beta.2

2020-09-28

Bug Fixes

  • 修复引入 Vant 时提示 ‘global is not defined’ 的问题

2020-09-28

breaking changes

  • DatetimePicker: change 事件的第一个参数调整为当前选中值 058665

refactor

使用 Composition API 重构以下组件：

Feature

  • Locale: 新增德语语言包 #7245
  • Pagination: 新增多个插槽

Bug Fixes

  • Picker: 修复 setIndex 方法无效的问题 d2a542
  • Dialog: 修复最小高度错误的问题
  • 包含 v2.10.8 版本的所有改动和修复

2020-09-18

breaking changes

  • Dialog: allow-html 属性的默认值调整为 false 02c7a7
  • Picker: allow-html 属性的默认值调整为 false

refactor

使用 Composition API 重构以下组件：

Bug Fixes

  • AddressEdit: 修复 emits 未声明导致 warning 的问题
  • AddressEdit: 修复点击省市区弹窗的蒙层时无法关闭的问题 02e89a
  • Field: 修复在 iOS 上中文输入过程中触发 input 事件的问题
  • 包含 v2.10.7 版本的所有改动和修复

2020-09-13

breaking changes

  • Button: native-type 属性的默认值调整为 button df8059

refactor

使用 Composition API 重构以下组件：

Feature

  • Button: 新增 icon-position 属性
  • slider: 新增 range 属性，支持范围选择 #7175
  • TabbarItem: 新增 @tabbar-item-active-background-color 变量

Bug Fixes

  • Sticky: 修复组件销毁时报错的问题 #7169

v3.0.0-alpha.4

2020-09-06

breaking changes

  • Dialog: before-close 属性用法调整，不再传入 done 函数，而是通过返回 Promise 来控制
  • SwipeCell: before-close 属性不再传入组件实例
  • ImagePreview: 移除 async-close 属性，新增 before-close 属性

refactor

使用 Composition API 重构以下组件：

Bug Fixes

  • Tag: 修复 color 属性不生效的问题
  • 修复在 TSX 中使用组件时提示类型错误的问题 #7076
  • 修复全量引入组件时提示类型错误的问题

2020-09-01

Feature

  • ActionSheet: 新增 description 插槽 #7068
  • Toast: 使用 composition api 重构

Types

  • 修复使用 app.use 注册组件时提示类型错误的问题 #7056
  • 修复 $toast、$dialog 类型不存在的问题

Bug Fixes

  • Dialog: 修复 Dialog.close 不生效的问题 476e16
  • Toast: 修复设置 toast.message 不生效的问题

2020-08-28

Bug Fixes

  • 修复使用 yarn add vant@next 安装失败的问题

2020-08-28

refactor

使用 Composition API 重构以下组件：

  • ActionBar
  • AddressList
  • Area
  • Badge
  • Button
  • Circle
  • Col
  • Collapse
  • CountDown
  • Image
  • Row
  • List
  • Loading
  • NavBar
  • NoticeBar
  • Progress
  • Rate
  • Sidebar
  • Slider
  • Steps
  • Sticky
  • Tabbar

Bug Fixes

  • Rate: 修复控制台报 emit warning 提示的问题 c32fba
  • Button: 修复 click 事件参数丢失的问题
  • CellGroup: 修复 attrs 继承错误的问题 8f978a
  • Dialog: 修复部分弹窗相关属性不生效的问题
  • Image: 修复 loading 图标和 error 图标不展示的问题 c720ee

2020-08-22

主要改动

  • 完成 Vue 3 适配
  • 调整部分组件的 v-model 和 prop.sync 用法，以适配 v-model 语法变更
  • 调整部分组件的 prop 和 event 用法
  • 重命名所有组件的 info 属性为 badge
  • 重命名所有组件的 get-container 属性为 teleport
  • 废弃 SwitchCell 组件
  • 废弃个别 API

已知问题

  • Lazyload、Panel 和 Sku 组件暂未完成 Vue 3 适配