更新日志
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
插槽