更新日志
1.7.0
2021-07-04
Bug Fixes
- Button: 修复 type 为 getUserInfo & wx.getUserProfile 可用时 lang 参数失效 #4250
- ShareSheet: 新增内置icon
weapp-qrcode
wechat-moments
#4256
Features
- Checkbox: 增加 direction 属性,设置排列方向 #4265
- ConfigProvider: 增加全局配置组件 #4279
- Grid: 增加 reverse 属性,支持文本&图片位置互换 #4280
- GridItem: 增加 icon-prefix 属性,支持第三方字体 #4276
- Rate: 增加更多 css 变量 #4297
- Slider: 增加更多 css 变量 #4305
Improvements
- wxs style 方法支持驼峰变量命名,以便能更好的在wxml中使用 #4281
1.6.9
2021-06-06
Bug Fixes
- DatetimePicker: 修复 动态设置 min-hour min-date 显示不正确 #4245
- Tabs: 修复 tab数量较多时滚动距离不正确 #4202
- Uploader: 修复 demo 中 beforeRead 报错 #4235
1.6.9-beta.2
2021-05-22
Bug Fixes
- Button: 修复 open-type 不生效 #4222
- Calendar: 修复 allow-same-day 开启时 custom-color 属性无效 #4200
- Circle: 修复 value 是小数时抖动的情况 #4152
- NoticeBar: 调整滚动行为 #4201
- NoticeBar: 修复不正确的滚动速度 cde3876
- Radio: 支持动态设置 disabled #4191
- Rate: 支持滑动选择半星 #4195
Features
- Calendar: 增加 first-day-of-week 属性,设置周起始日 #4211
- Calendar: 增加 show-range-prompt 属性和 over-range 事件,设置是否展示提示文案 #4212
- Icons: 图标库迁移至iconfont.cn #4219
- OpenType: 支持 getUserProfile #4203
- Panel: 移除 useFooterSlot #4205
1.6.8
2021-02-26
Features
Bug Fixes
Improvements
- Circle: 当内置 canvas 不支持同层渲染时降级至默认 type (#4050)
1.6.7
2021-01-27
Features
- Radio: 新增
direction
属性 (#4007)
Bug Fixes
1.6.6
2021-01-21
Features
- Uploader: 支持文件预览 (#3975)
Bug Fixes
- Picker: 修复标题栏无法显示 (#3973)
Improvements
- Calendar: 优化模板代码 (#3972)
1.6.5
2021-01-19
Features
- Field: 新增 input 插槽 (#3932)
- Field: 新增 click-input 事件 (#3932)
- Icon: 新增 delete-o、sort、font、font-o、revoke 图标 (#3881)
Bug Fixes
Improvements
- Cell: 优化性能 (#3888)
- Col: 优化性能 (#3886)
- Divider: 优化性能 (#3887)
- Empty: 优化性能 (#3933)
- Loading: 优化性能 (#3892)
- Notice-bar: 优化性能 (#3891)
- Notify: 优化性能 (#3893)
- Picker: 优化性能 (#3949)
- Stepper: 优化性能 (#3890)
- Sticky: 优化性能 (#3879)
- SwipeCell: 优化性能 (#3928)
- Switch: 优化性能 (#3889)
- Tag: 优化性能 (#3894)
- Transition: 优化性能 (#3895)
- Uploader: 优化性能 (#3897)
1.6.4
2020-12-18
Improvements
- Tab: 优化粘性布局时的渲染性能 (#3875)
- Grid: 使用 wxs 优化性能 (#3839)
- Image: 使用 wxs 优化性能 (#3839)
- Button: 使用 wxs 优化性能 (#3839)
- Icon: 减少代码体积 (#3839)
- Checkbox: 减少代码体积 (#3839)
- Slider: 减少代码体积 (#3839)
Bug Fixes
- Calendar: 修复在 phone 设备上选择日期后显示错误 (#3833)
- GoodsAction: 修复部分设备上高度异常 (#3865)
- Slider: 修复设置
max
min
时滑动不均匀 (#3876) - Tab: 修复切换时内容区闪烁的问题 (#3866)
1.6.3
2020-12-09
Features
- Dialog: 新增
beforeClose
属性 (#3815) - uploader: 新增若干 CSS 变量 (#3797)
- Aarea: 支持不传入
county_list
数据 (#3824) - Tab: 新增
resize
方法 (#3827)
Improvements
Bug Fixes
- Field: 修复输入中文时显示字数暂时超出 maxlength (#3802)
- Info: 修复样式错误 (#3823)
- NavBar: 修复动态渲染时组件报错 (#3822)
- Progress: 修复
percentage
为 0 时样式异常 (#3808)
1.6.2
2020-11-29
Features
- Tabbar: 新增
placeholder
icon-prefix
属性 (#3792)
Bug Fixes
- DatetimePicker: 修复
type=year-month
时选择出现报错 (#3783) - Info: 修复部分安卓设备中文案不完全居中 (#3778)
- Tab: 修复
ellipsis
为false
时下划线位置不正确 (#3777) - Notify: 修复组件未全局居中 (#3751)
Improvements
- Icon: 使用 wxs 优化性能 (#3791)
1.6.1
2020-11-12
Bug Fixes
1.6.0
2020-11-11
Features
- SwipeCell: 新增外部样式类
custom-class
#3678 - ActionSheet: 调整取消文字颜色至 @gray-7 #3719
- ActionSheet: 调整顶部栏样式 #3720
- ActionSheet: 调整加载图标大小至 22px #3718
- ActionSheet: 调整描述文字样式 #3726
- Cell: 调整图标外边距至 4px #3721
- DropdownMenu: 增加默认阴影 #3723
- DropdownMenu: 调整选中态默认颜色至 #ee0a24 #3725
- Image: 调整图标大小至 36px #3724
- Popup: 调整圆角至 16px #3713
- Search: 调整左侧内边距至 12px #3716
- Sidebar: 调整宽度至 85px #3722
- TabbarItem: 调整图标大小至 22px #3717
Bug Fixes
- Field: 修复使用
label
属性时label-class
样式类不生效 #3729 - NoticeBar: 修复内容较短时开启
scrollable
不生效 #3727 - SidebarItem: 修复长数字不换行的问题 #3714
- Tag: 默认字体加入 miui #3715
1.5.2
2020-10-15
Features
- Uploader: 标准化 file-list 与事件参数 #3673
- Uploader: 新增 thumb,支持缩略图展示 #3673
- GoodsAction: 新增若干 CSS 变量 #3654
- 移动 @types/wechat-miniprogram 至 dependencies #3654
Bug Fixes
1.5.1
2020-09-29
Features
- Card: 新增
origin-price
tag
插槽 #3645 - ShareSheet: 调整默认 z-index 至 100 #3575
- ShareSheet: 新增 item 属性 openType #3575
- Uploader: 扩大删除按钮点击区域 #3631
Bug Fixes
- Uploader: 支持预览视频 #3594
- Dialog: 调整类型定义 #3630
- NavBar: 修复 CSS 变量 —nav-bar-icon-color 不生效 #3643
- NavBar: 修复未设置 title 时样式异常 #3643
- Tab: 修复 line-width 属性不支持 string #3628
1.5.0
2020-08-27
Features
- ShareSheet: 新增组件 #3559
- Icons: 升级 @vant/icons 至 v1.2.5 #3539
- sidebar: 新增 badge 属性 #3564
- Tabs: 调整默认 line-width 至 40px #3518
- Tabs: 去除默认边框 #3519
- TreeSelect: 新增 selected-icon 属性 #3565
- TreeSelect: 支持 badge、dot 显示 #3565
Bug Fixes
1.4.4
2020-08-12
Bug Fixes
v1.4.3
2020-08-07
Features
v1.4.2
2020-08-03
Features
Bug Fixes
v1.4.1
2020-07-28
Features
Bug Fixes
v1.4.0
2020-07-17
Features
- Empty: 新增 Empty 组件 #3327
- NoticeBar: 新增 background 属性 #3388
- NoticeBar: 新增 close 事件 #3388
- GridItem: 新增 icon-color 属性 #3386
- NavBar: 现在 custom-style 将影响根节点#3371
- Cell: 新增 title-style 属性, fix Field label width #3370
- Uploader: 更新 failed 图标 #3359
- Uploader: 更新删除图标样式 #3385
- Uploader: 移除圆角样式 #3384
- Field: 更新禁用态样式 #3358
- Field: 更新 label 样式 #3357
- Picker: 调整 action button 样式 #3316
Bug Fixes
- Collapse: 使用 animation 重构动画部分逻辑以修复动画卡顿 #3401
- Uploader: 修复 loading 样式错误、调整 previewSize 属性默认值 #3317
- Area: 修复低版本基础库下 columns-num 设置为 1 或 2 时真机环境报错 #3318
- DatetimePicker: 修复使用 formatter 时,事件返回值可能不正确 #3352
- Field: 修复 textarea 模式下 label 与 value 不在同一水平线上 #3383
- Dialog: show dialog after class ready #3374
- Calendar: confirm-disabled-text 属性增加默认值 #3394
v1.3.3
2020-06-24
Features
- steps: 为每一项增加 inactiveIcon、activeIcon 属性 #3315
- field: 增加外部样式类 label-class #3311
- field: 现在总会从内部 set value 值 #3313
- uploader: 为每一项增加 deletable 属性 #3270
- uploader: 扩大删除图标的可点击区域 #3265
Bug Fixes
- tabbar: 修复 iphone-se 上高度异常 #3314
- grid: 修复 text 与 icon 同时设置时样式异常 #3310
- calendar: 修复多选模式下 default-date 属性不生效 #3284
- circle: 修复 type=”2d” 时无法动态变更 value #3264
- nav-bar: 修复未设置 left-text 时左侧图标样式异常 #3263
v1.3.2
2020-06-04
Features
Bug Fixes
- Grid: 修复开启
square
时横、纵向间距不同 #3231 - uploader: 修复点击删除图标时触发 click-preview 事件 #3230
- circle: 修复
type="2d"
不生效 #3228 - calendar: 修复在选择区间时,点击确定报错 #3195
- tag: 修复 css 变量名拼写错误 #3191
v1.3.1
2020-05-24
Features
Bug Fixes
v1.3.0
2020-05-08
支持简易双向绑定
1.3.0 中,我们为数个表单组件支持了简易双向绑定,涉及组件有
Slider #3107
Search #3106
Rate #3105
Features
- sticky: 新增 scroll-top 属性 #3115
- button: 新增 dataset 属性 #3075
- uploader: 所有类型都会触发 click-preview 事件 #3071
- Uploader: 属性 accept 新增值 media #3047
- feat: 新增基础 font-family #3061
- submit-bar: 使用另一个 view 实现 safe-area-inset-bottom 以避免样式冲突 #3104
Bug Fixes
- dialog: 修复 title 多余空格的问题 #3069
- tab: 修复 tab 个数多时显示滚动条 #3072
- Sticky: 修复使用组件时页面 onPageScroll 失效 #3092
- button: 修复 disabled 属性对 open-type 类型的按钮无效 #3076
v1.2.2
2020-04-21
Features
- GoodsActionButton: 新增 CSS 变量 goods-action-line-height #3037
- Calendar: 选择区间大于 range 时自动选中最大范围 #3026
- Notify: 新增 top 属性 #3018
Bug Fixes
v1.2.1
2020-04-12
Features
Bug Fixes
- IndexBar: 移除 scroll-top 属性 #2999
- Uploader: 修复图片后缀名为大写时未正常识别 #2987
- Field: 修复 autosize 属性 设置 max-height 不生效 #3007
v1.2.0
2020-04-04
Features
- TreeSelect: 更新 nav 背景色 #2952
- Sticky: 使用 page scroll 重构组件 #2950
- Field: 新增 auto-focus、disable-default-padding、cursor 属性 #2936
- Field: 新增 linechange、keyboardheightchange 事件 #2936
- Uploader: 支持显示上传状态 #2929
- Image: mode 属性新增 widthFix、heightFix #2908
- Canvas: 新增 type 属性 #2906
- NavBar: 新增 placeholder 属性 #2896
Bug Fixes
- Field: 修复输入过快时输入框内容不断回退 #2936
- Calendar: 修复 show-confirm 为 true 时组件初始化报错 #2951
- Tab: 修复 type 为 card 时 color 对边框无效 #2941
v1.1.0
2020-03-21
Features
- 新增 Calendar 日历组件 #2894
- Grid: 新增外部样式类 custom-class、content-class、icon-class、text-class #2882
- Steps: 新增 click 事件 #2874
- SideBar: 新增 title 插槽 #2873
- Uploader: 新增 upload-icon 属性 #2869
- Uploader: 新增 show-upload 属性 #2868
- Uploader: 更新样式、调整事件触发顺序与 vant 一致 #2886
- Field: 新增 show-word-limit 属性 #2856
- Field: autosize 属性支持传入对象,指定 maxHeight 与 minHeight #2856
- Field: 新增若干 CSS 变量 #2856
Bug Fixes
v1.0.7
2020-03-04
Features
- DropdownItem: 新增
popupStyle
属性 #2804 - DropdownItem: 新增
open
close
opened
closed
事件 #2804 - Card: 新增
price
num
插槽 #2787 - Card: 新增
origin-price-class
外部样式类 #2787
Bug Fixes
- Tab: 修复内容项高度不同时粘性布局异常 #2817
- Picker: 修复未选中项样式未置灰 #2816
- GoodsActionButton: 修复仅使用一个 button 时样式异常 #2808
- Radio:
name
类型与value
统一 #2801 - Uploader: 修复文档错误 #2777
v1.0.6
2020-02-24
Features
Bug Fixes
- DropdownItem: 修复点击选项时不触发
close
事件 #2766 - GoodsActionButton: 修复低版本基础库下的样式问题 #2762
- Tabs: 修复点击禁用项时事件参数错误 #2758
- Checkbox: 修复动态设置
disabled
属性无效 #2748 - Button: add loading color when plain is true #2746
- Radio: 修复
label-disabled
文档错误 #2763
v1.0.5
2020-02-07
Features
- ActionSheet: actions 支持更多 openType #2715
- Uploader: 新增开始
disabled
时的组件样式 #2720 - Icon: 调整示例小程序页面与 vant 对齐 #2728
- 示例小程序首页与 vant 对齐 #2729
- 完善快速上手文档,增加 npm 构建说明 #2726
Bug Fixes
- Radio: 修复
disabled
属性不生效 #2711 - Tab: 修复
animated
属性无法动态切换 #2712 - Circle: 修正文档错误,
size
属性不支持string
类型 #2694 - 修正文档默认 slot 名称为 default 的错误 #2726
- TreeSelect: 修正文档示例代码标签闭合错误 #2710
v1.0.4
2020-01-21
Features
- Stepper: 新增 disable-long-press 属性 #2691
- quickstart: 快速上手新增关闭 style v2 说明 #2704
- Search: 新增 background、disabled、input-align 文档示例 #2698
- Icon: 文档新增图标文字加载失败说明 #2681
Bug Fixes
- Sticky: 修复真机上页面滚动缓慢时无法吸顶/取消吸顶 #2703
- DropdownItem: 修复 wx:key 警告 #2670
- IndexBar: 文档修复组件引入路径错误 #2689
- 升级依赖版本以避免安全警告 #2680
v1.0.3
2020-01-09
Features
Bug Fixes
v1.0.2
2019-12-31
Features
- Skeleton: 新增外部样式类
row-class``avatar-class``title-class
#2612 - SwipeCell: 支持动态修改
width
属性 #2607 - Uploader: 新增
camera``compressed``maxDuration
属性 #2584
Improvements
- Tab: 优化弹性滚动效果 #2606
Bug Fixes
v1.0.1
2019-12-23
Features
- Uploader: 新增 sizeType 属性 #2563
- GoodsActionButton: 新增 plain 属性 #2559
- Uploader: 去除 use-slot 属性 #2551
- 新增样式覆盖说明文档 #2566
Improvements
Bug Fixes
v1.0.0
2019-12-11
主要变动
- npm 包名由 vant-weapp 重命名为 @vant/weapp
- 增加十一个新组件
- 增加数十个 API
- 所有组件支持通过
CSS自定义属性
自定义样式 - 使用
env()
重构 iOS 安全区域适配 - 调整部分 API 命名,废除少量 API
新组件
在 Vant Weapp 1.0 版本中,我们新增了 11 个实用的基础组件:
- Grid 宫格,用于展示内容或进行页面导航
- Image 图片,增强版的 Image 标签,支持图片懒加载与加载失败提示
- Circle 环形进度条,告知用户当前的状态和进度
- Overaly 遮罩层,用于强调特定的页面元素,并阻止用户进行其他操作
- Divider 分割线,区隔内容的分割线
- Sticky 粘性布局,与 CSS 中
position: sticky
属性实现的效果类似 - Skeleton 骨架屏,在待加载区域展示的占位区块,提供界面加载过程中的过渡效果
- IndexBar 索引栏,通讯录中的字母索引栏,用于长列表快速索引
- Uploader 文件上传,上传一个或多个文件
- CountDown 倒计时,用于显示活动倒计时、短信验证码等
- DropdownMenu 下拉菜单,用于列表的分类选择、筛选及排序
样式定制
在 1.0 迭代计划确定之初,我们就不断思考这样一个问题 — 该如何给用户提供动态切换主题样式的功能呢?
微信小程序的环境是非常特殊的。不具有动态加载代码的机制,同时微信又限制了代码的主包大小和总大小。传统的基于预设的样式定制过于臃肿,不再适合微信小程序的环境。
微信小程序自定义组件的组件模型相当于一个简化版的 Shadow DOM,幸运的是,小程序也支持了 CSS 自定义属性 的特性。最终,我们基于 CSS 自定义属性设计了样式定制的方案,开发者使用灵活、方便,组件维护也更简单。
从 1.0 版本开始,Vant Weapp 中的所有组件都支持通过 CSS 组定义属性 进行样式定制,具体使用姿势可查看相关文档
不兼容更新
1.0 版本中包含少量不兼容更新,主要是命名调整和移除个别属性。对于正在使用 0.x 版本的项目,请按照下方的列表依次检查,大部分项目可以无痛升级。
Badge
BadgeGroup
重命名为Sidebar
Badge
重命名为SlidebarItem
active
属性重命名为activeKey
Notify
text
选项重命名为message
backgroundColor
选项重命名为background
Popup
- 去除
transitionend
事件,新增 6 个事件
SwitchCell
- 移除了
SwitchCell
组件,可以使用Cell
和Switch
组件代替
Transition
- 去除
transitionend
事件,新增 6 个事件
新特性
ActionSheet
- 新增
click-overlay
事件 - 新增
close-on-click-action
属性 - 新增
color
属性 - 新增
description
属性 - 新增
round
属性
Area
- 新增
columns-placeholder
属性 reset
方法支持传入code
参数
Button
- 新增
loading-type
属性 color
属性支持渐变色- 切换
disabled
时增加过渡效果
Checkbox
- 新增
icon-size
属性
Color
- 基础红色更新为
#ee0a24
DatetimePicker
- 新增
filter
属性
Dialog
- 优化文字换行
- 新增
title
插槽 - 新增
confirm-button-color
属性 - 新增
cancel-button-color
属性 - 新增
width
属性 - 新增
overlay-style
属性
Field
- 新增
clickable
属性 - 新增
arrow-direction
属性 - 新增
hold-keyboard
属性
GoodsActionButton
- 新增
color
属性 - 样式升级为圆角风格
GoodsActionIcon
- 新增
icon
插槽 - 新增
dot
属性
GridItem
- 新增
info
属性 - 新增
dot
属性
Icon
- 新增
dot
属性 - 新增
down
图标 - 新增
wap-hone
实底风格图标 - 支持
number
类型的size
属性
Loading
- 支持
number
类型的size
属性
NoticeBar
- 阻止关闭图标点击事件冒泡
Notify
- 新增
clear
方法
Popup
- 新增
round
属性 - 新增
closeable
属性 - 新增
close-icon
属性 - 新增
close-icon-position
属性
Progress
- 新增
stroke-width
属性
Radio
- 新增
icon-size
属性
Rate
- 优化手势判断
- 新增
gutter
属性 - 新增
touchable
属性 - 支持
string
类型的size
属性
Search
- 新增
action-text
属性 - 新增
left-icon
插槽 - 新增
right-icon
插槽
SlidebarItem
- 新增
dot
属性
Slider
- 新增
drag-start
事件 - 新增
drag-end
事件 - 支持传入任意范围的
max
和min
属性 - 支持
number
类型的bar-height
属性 - 增加滑动动画
- 增大点击区域
SwipeCell
- 新增
name
属性 - 新增
open
事件 - 支持打开状态互斥
Switch
- 加载图标的颜色会跟随开关状态变化
Stepper
- 支持长按手势
- 新增
input-width
属性 - 新增
button-size
属性 - 新增
decimalLength
属性 - 新增 disablePlus、disableMinus 属性
Steps
- 新增
active-icon
属性 - 新增
inactive-icon
属性
Tabs
- 使用 Sticky 组件重构吸顶实现
- 新增
name
属性 - 新增
line-height
属性 - 新增
ellipsis
属性 - 新增
lazy-render
属性 line-width
属性支持String
类型- 增加云开发结合示例
TreeSelect
- 新增
max
属性 - 新增
content
插槽