vant-weapp/docs/markdown/changelog.md

更新日志

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

• button: 新增 form-type 属性 #3208
• grid: 新增 icon-size、badge 属性 #3236
• grid: 新增 direction 属性 #3192

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

• Button: 新增 class-prefix 属性 #3159
• Collapse: 新增 open、close 事件 #3176

Bug Fixes

• 修复控制台提示选择器错误的问题 #3137
• 修复 GoodsActionButton 在某些情况下报错的问题 #3145

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

• Field: 修复未设置 autosize 时 wxs 报错 #3038
• Field: 避免设置 showClear 为 undefined #3012

v1.2.1

2020-04-12

Features

• Field: 支持小程序双向绑定 #2986
• Calendar: 多选模式下新增 unselect 事件 #2990

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

• Button: 移除 lang 属性默认值 #2883
• Button: 修复 disabled 属性对原生事件无效 #2878

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

• GoodsActionButton: 新增默认 slot #2779
• SubmitBar: 更新圆角样式 #2755
• Card: 更新样式 #2754
• 优化 relation 部分代码 #2760

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

• npm 包默认输出 es5 版本代码 #2639
• Steps: 新增外部样式类 desc-class #2630

Bug Fixes

• Tab: 解决动态添加选项时，顺序错乱和下划线长度不变的问题 #2663
• NavBar: 修复返回图标未居中的问题 #2633

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

• IndexBar: 修复字母未全部定义时 click 事件报错 #2605
• Field: 修复点击清除图标后下一次点击无效 #2602

v1.0.1

2019-12-23

Features

• Uploader: 新增 sizeType 属性 #2563
• GoodsActionButton: 新增 plain 属性 #2559
• Uploader: 去除 use-slot 属性 #2551
• 新增样式覆盖说明文档 #2566

Improvements

• 使用 nextTick 优化部分异步逻辑 #2561
• wxs 新增 addUnit 方法以减少 setData 调用次数 #2550

Bug Fixes

• Tag: 修复未依赖 van-icon 组件 #2579
• Notify: 修复 safeAreaInsetTop 不生效 #2558
• Uploader: 修复 capture 属性不生效 #2551

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插槽