diff --git a/docs/markdown/changelog.md b/docs/markdown/changelog.md index 2020ab64..fcf27f1e 100644 --- a/docs/markdown/changelog.md +++ b/docs/markdown/changelog.md @@ -1,283 +1,56 @@ # 更新日志 -### [v1.0.0-beta.6](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.6) - -#### 新特性与优化 - -##### Sidebar - -- 修复 SidebarItem 重渲染后 change 事件返回索引值错误 -- 修复文档错误，重命名 active 属性为 activeKey - -##### Stepper - -- 新增 disablePlus、disableMinus属性 - -##### TreeSelect - -- 修复动态设置 mainActiveIndex 无效 - -##### Overlay - -- 支持嵌入内容 - -##### Image - -- 修复部分图片在iOS设备中无法显示 - -##### DropdownMenu - -- 修复动态设置 value 无效 - -##### Uploader - -- 文档增加上传云存储示例 - -##### Rate - -- 修复开启 allow-half 时显示异常 - -### [v1.0.0-beta.5](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.5) +### [v1.0.0](https://github.com/youzan/vant-weapp/tree/v1.0.0) +`2019-12-11` #### 主要变动 -- 包名由 vant-weapp 重命名为 @vant/weapp -- 增加多个颜色变量 -- 增加多个 API -- 修复多个问题 - -#### 新特性与优化 - -##### SwipeCell - -- 新增 open 事件 -- 不再 catch touchend 事件 - -##### Uploader - -- 新增 deletable 属性 -- 修复 preview-size px单位重复 -- 更新样式 - -##### Image - -- 新增 radius 属性 -- 支持动态设置 width 、 height 属性 - -##### Tab - -- 修复离开页面时组件报错 -- 修复初始设置的 active 属性失效 -- 增加云开发结合示例 - -##### Notify - -- 修复安卓设备中 safe-area-inset-top 属性不生效 - -##### Grid - -- 修复同时设置 gutter square 属性时样式异常 - -##### Skeleton - -- 修复 row 属性不生效 - -##### Stepper - -- 修复禁用样式错误 - -### [v1.0.0-beta.4](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.4) - -#### 主要变动 - -- 增加一个新组件 -- 增加两个 API -- 修复多个问题 - -#### 新组件 - -- 新增`IndexBar`索引栏组件 - -#### 新特性与优化 - -##### Tab - -- 新增`ellipsis`属性 -- 新增`lazy-render`属性 -- 优化闪屏问题 -- 修复滑动切换模式下激活选项错误 -- 修复选项卡竖向滚动时不触发scroll事件 - -##### Area - -- 修复change事件返回values错误 - -##### Uploader - -- 修复`multiple`属性不生效 - -##### NavBar - -- 修复样式错误 - -##### rate - -- 修复`size`属性不生效 - -### [v1.0.0-beta.3](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.3) - -#### 主要变动 - -- 增加两个新组件 -- 增加多个 API -- 十六个组件样式支持主题定制，目前所有组件已支持主题定制 - -#### 新组件 - -- 新增`Image`图片组件 -- 新增`Skeleton`组件 - -#### 新特性 - -##### Field - -- 新增`hold-keyboard`属性 - -##### Tab - -- 使用 Sticky 组件重构吸顶实现 -- 修复动态设置active属性无效 - -##### NoticeBar - -- 阻止关闭图标点击事件冒泡 - -### [v1.0.0-beta.2](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.2) - -#### 主要变动 - -- Transition去除`transitionend`事件，新增若干事件 -- 增加一个新组件 -- 增加多个 API - -#### 新组件 - -- 新增`CountDown`倒计时组件 - -#### 新特性 - -##### NavBar - -- 修复`safeAreaInsetTop`在安卓设备上不生效 - -##### Area - -- 新增`columns-placeholder`属性 - -##### Dialog - -- 新增`width`属性 -- 新增`overlay-style`属性 -- 优化样式 - -##### Slider - -- 增加滑动动画 -- 增大点击区域 -- 修复在某些设备中造成页面横向溢出 - -##### ActionSheet - -- 新增`description`属性 - -##### Rate - -- 修复某些情况下高度异常 - -##### Stepper - -- 修复当`step`为小数时加减失效 - -##### Tabs - -- 修复组件初始化报错 - -### [v1.0.0-beta.1](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.1) - -#### 主要变动 - -- 使用`env()`重构iOS安全区域适配 -- 增加多个 API - -#### 新特性 - -##### Tab - -- 新增`name`属性 -- 新增`line-height`属性 -- `line-width`属性支持`String`类型 - -##### Popup - -- 调整圆角为`20px` - -##### Stepper - -- 新增`decimalLength`属性 - -##### SwipeCell - -- 支持打开状态互斥 - -##### Button - -- 切换`disabled`时增加过渡效果 - -##### GoodsActionButton - -- 样式升级为圆角风格 - -##### GoodsActionIcon - -- 新增`dot`属性 - -##### ActionSheet - -- 新增`color`属性 -- 新增`round`属性 - -##### GridItem - -- 新增`info`属性 -- 新增`dot`属性 - -##### Rate - -- 优化手势判断 - -### [v1.0.0-beta.0](https://github.com/youzan/vant-weapp/tree/v1.0.0-beta.0) - -#### 主要变动 - -- 支持主题定制 -- 增加四个新组件 +- npm 包名由 vant-weapp 重命名为 @vant/weapp +- 增加十一个新组件 - 增加数十个 API -- 调整部分 API 命名 +- 所有组件支持通过`CSS自定义属性`自定义样式 +- 使用`env()`重构iOS安全区域适配 +- 调整部分 API 命名，废除少量 API #### 新组件 -- 新增`Grid`宫格组件 -- 新增`Circle`环形进度条组件 -- 新增`Divider`分割线组件 -- 新增`Overlay`遮罩层组件 -- 新增`Sticky`粘性布局组件 +在 Vant Weapp 1.0 版本中，我们新增了 11 个实用的基础组件： + +- Grid 宫格，用于展示内容或进行页面导航 +- Image 图片，增强版的 Image 标签，支持图片懒加载与加载失败提示 +- Circle 环形进度条，告知用户当前的状态和进度 +- Overaly 遮罩层，用于强调特定的页面元素，并阻止用户进行其他操作 +- Divider 分割线，区隔内容的分割线 +- Sticky 粘性布局，与 CSS 中`position: sticky`属性实现的效果类似 +- Skeleton 骨架屏，在待加载区域展示的占位区块，提供界面加载过程中的过渡效果 +- IndexBar 索引栏，通讯录中的字母索引栏，用于长列表快速索引 +- Uploader 文件上传，上传一个或多个文件 +- CountDown 倒计时，用于显示活动倒计时、短信验证码等 +- DropdownMenu 下拉菜单，用于列表的分类选择、筛选及排序 + +![](https://img.yzcdn.cn/public_files/2019/12/06/748d9b70feb76eeaf44f9d6080b6e108.png) + +#### 样式定制 + +在 1.0 迭代计划确定之初，我们就不断思考这样一个问题 -- 该如何给用户提供动态切换主题样式的功能呢？ + +微信小程序的环境是非常特殊的。不具有动态加载代码的机制，同时微信又限制了代码的主包大小和总大小。传统的基于预设的样式定制过于臃肿，不再适合微信小程序的环境。 + +微信小程序自定义组件的组件模型相当于一个简化版的 [Shadow DOM](https://developers.google.com/web/fundamentals/web-components/shadowdom?hl=zh-CN)，幸运的是，小程序也支持了 [CSS自定义属性](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Using_CSS_custom_properties) 的特性。最终，我们基于CSS自定义属性设计了样式定制的方案，开发者使用灵活、方便，组件维护也更简单。 + +从 1.0 版本开始，Vant Weapp 中的所有组件都支持通过 [CSS组定义属性](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Using_CSS_custom_properties) 进行样式定制，具体使用姿势可查看[相关文档](https://youzan.github.io/vant-weapp/#/theme) + +![定制主题](https://img.yzcdn.cn/public_files/2019/06/11/9a066c1a212264c7ae56065e1f13d317.png) #### 不兼容更新 +1.0 版本中包含少量不兼容更新，主要是命名调整和移除个别属性。对于正在使用 0.x 版本的项目，请按照下方的列表依次检查，大部分项目可以无痛升级。 + ##### Badge - `BadgeGroup`重命名为`Sidebar` - `Badge`重命名为`SlidebarItem` +- `active`属性重命名为`activeKey` ##### Notify @@ -286,12 +59,17 @@ ##### Popup -- `transitionEnd`事件重命名为`transitionend` +- 去除`transitionend`事件，新增 6 个事件 ##### SwitchCell - 移除了`SwitchCell`组件，可以使用`Cell`和`Switch`组件代替 +##### Transition + +- 去除`transitionend`事件，新增 6 个事件 + +---- #### 新特性 @@ -299,15 +77,20 @@ - 新增`click-overlay`事件 - 新增`close-on-click-action`属性 +- 新增`color`属性 +- 新增`description`属性 +- 新增`round`属性 ##### Area +- 新增`columns-placeholder`属性 - `reset`方法支持传入`code`参数 ##### Button - 新增`loading-type`属性 - `color`属性支持渐变色 +- 切换`disabled`时增加过渡效果 ##### Checkbox @@ -327,19 +110,29 @@ - 新增`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 @@ -352,6 +145,14 @@ - 支持`number`类型的`size`属性 +##### NoticeBar + +- 阻止关闭图标点击事件冒泡 + +##### Notify + +- 新增`clear`方法 + ##### Popup - 新增`round`属性 @@ -363,15 +164,22 @@ - 新增`stroke-width`属性 +##### Radio + +- 新增`icon-size`属性 + ##### Rate +- 优化手势判断 - 新增`gutter`属性 - 新增`touchable`属性 - 支持`string`类型的`size`属性 -##### Radio +##### Search -- 新增`icon-size`属性 +- 新增`action-text`属性 +- 新增`left-icon`插槽 +- 新增`right-icon`插槽 ##### SlidebarItem @@ -383,32 +191,42 @@ - 新增`drag-end`事件 - 支持传入任意范围的`max`和`min`属性 - 支持`number`类型的`bar-height`属性 - -##### Search - -- 新增`action-text`属性 -- 新增`left-icon`插槽 -- 新增`right-icon`插槽 - -##### Switch - -- 加载图标的颜色会跟随开关状态变化 +- 增加滑动动画 +- 增大点击区域 ##### 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`属性