diff --git a/docs/markdown/changelog.en-US.md b/docs/markdown/changelog.en-US.md index 76c1628e7..1cf2ac2b8 100644 --- a/docs/markdown/changelog.en-US.md +++ b/docs/markdown/changelog.en-US.md @@ -1,191 +1,13 @@ -# Changelog +# 更新日志 -### [v2.0.0-beta.5](https://github.com/youzan/vant/tree/v2.0.0-beta.5) -`2019-06-10` - -##### ActionSheet - -- Add `click-overlay` event - -##### Field - -- Add `input` slot - -##### Image - -- Fix can not display loading status when use lazy-load prop - -##### Toolbar - -- Add `toolbar-position` prop - - -### [v2.0.0-beta.4](https://github.com/youzan/vant/tree/v2.0.0-beta.4) -`2019-06-05` - -##### Checkbox - -- Fix `label-position` prop not work - -##### Field - -- Add `click` event -- Add `clickable` prop - -##### Radio - -- Fix `label-position` prop not work - -##### Stepper - -- Support `Number` type of `input-width` prop - -##### SwipeCell - -- Fix render error when one side is empty - -##### Uploader - -- Support bind `v-model` -- Add `max-count` prop -- Add `preview-size` prop -- Add `preview-image` prop - - -### [v2.0.0-beta.3](https://github.com/youzan/vant/tree/v2.0.0-beta.3) -`2019-05-31` - -##### Field - -- No longer update v-model during IME composition - -##### IndexBar - -- Add `sticky` prop -- Add `highlight-color` prop - -##### Notify - -- Add `onClose` option -- Add `onOpened` option - -##### Picker - -- Optimize animation - -##### Rate - -- Add `gutter` prop -- Support `size` prop of `String` type - -##### Search - -- No longer update v-model during IME composition - -##### SwipeCell - -- Support auto calc `left-width` and `right-width` - -##### Toast - -- Add `onOpened` option - - -### [v2.0.0-beta.2](https://github.com/youzan/vant/tree/v2.0.0-beta.2) - -#### Accessibility - -Improve accessibility for those components： - -- List -- Rate -- Dialog -- Slider -- Switch -- NoticeBar -- GoodsAction -- DropdownMenu -- NumberKeyboard - -##### Area - -- `reset` method support `code` param - -##### Button - -- Add `icon` prop - -##### ImagePreview - -- Add `close-on-popstate` prop - -##### Search - -- Add `clearable` prop -- Add `left-icon` prop -- Add `right-icon` prop -- Add `right-icon` slot - -##### Slider - -- Add `drag-start` event -- Add `drag-end` event - -##### Uploader - -- Add default upload style -- Add `upload-text` prop - - -### [v2.0.0-beta.1](https://github.com/youzan/vant/tree/v2.0.0-beta.1) - -#### Accessibility - -Improve accessibility for those components： - -- Accordion -- Checkbox -- Radio -- Stepper -- Tab - -##### ActionSheet - -- Add `lock-scroll` prop - -##### DatetimePicker - -- Add `filter` prop - -##### DropdownMenu - -- Add `duration` prop - -##### DropdownItem - -- Add `title-class` prop -- Fix incorrect position in some browsers - -##### Picker - -- Support inertial scrolling - -##### Tab - -- Add `border` prop - -##### Uploader - -- `oversize` event add `detail` param - - -### [v2.0.0-beta.0](https://github.com/youzan/vant/tree/v2.0.0-beta.0) -`2019-05-21` +### [v2.0.0](https://github.com/youzan/vant/tree/v2.0.0) +`2019-06-12` #### Overview - Add four new components - Add dozens of APIs +- Improve accessibility - New card style document, support document search - All components support custom styles via `less` variables - Rename several components, deprecate several APIs @@ -197,6 +19,8 @@ Improve accessibility for those components： - `IndexBar`、`IndexAnchor` Component - `DropdownMenu`、`DropdownItem` Component + + #### Breaking Changes ##### Actionsheet @@ -250,71 +74,144 @@ Improve accessibility for those components： - Remove Waterfall component，please use `List` instead，or use [@vant/waterfall](https://github.com/chenjiahan/vant-waterfall)。 -#### New Features +--- + +#### Accessibility + +Improve accessibility for those components： + +- Accordion +- Checkbox +- Dialog +- DropdownMenu +- GoodsAction +- List +- NoticeBar +- NumberKeyboard +- Radio +- Rate +- Stepper +- Tab +- Slider +- Switch + +#### New Feature ##### ActionSheet -- add `close-on-click-action` prop -- support use `title` and `actions` prop at same time +- Add `lock-scroll` prop +- Add `click-overlay` event +- Add `close-on-click-action` prop +- Support both use `title` and `actions` prop + +##### Area + +- `reset` method support `code` param ##### Button -- add `loading-type` prop +- Add `icon` prop +- Add `loading-type` prop ##### Checkbox -- add `icon-size` prop +- Add `icon-size` prop + +##### DatetimePicker + +- Add `filter` prop ##### Field -- add `label-class` prop +- Add `input` slot +- Add `click` event +- Add `clickable` prop +- Add `label-class` prop +- No longer update v-model during IME composition ##### GoodsActionButton -- add `type` prop +- Add `type` prop ##### Icon -- Support `size` prop of `Number` type +- Support `Number` type of `size` prop + +##### ImagePreview + +- Add `close-on-popstate` prop ##### Loading -- add `default` slot -- add `vertical` prop -- add `text-size` prop -- Support `size` prop of `Number` type +- Add `default` slot +- Add `vertical` prop +- Add `text-size` prop +- Support `Number` type of `size` prop ##### Notify -- add `onClick` prop +- Add `onClick` option +- Add `onClose` option +- Add `onOpened` option ##### NoticeBar -- add `left-icon` slot -- add `right-icon` slot +- Add `left-icon` slot +- Add `right-icon` slot ##### PasswordInput -- add `gutter` prop +- Add `gutter` prop + +##### Picker + +- Support inertial scrolling +- Add `toolbar-position` prop ##### Popup -- add `click` event -- add `duration` prop +- Add `click` event +- Add `duration` prop ##### Radio -- add `icon-size` prop +- Add `icon-size` prop + +##### Rate + +- Add `gutter` prop +- Support`String` type of `size` prop + +##### Search + +- Add `clearable` prop +- Add `left-icon` prop +- Add `right-icon` prop +- Add `right-icon` slot +- No longer update v-model during IME composition + +##### Slider + +- Add `drag-start` event +- Add `drag-end` event ##### Steps -- add `inactive-icon` prop -- add `inactive-icon` slot +- Add `inactive-icon` prop +- Add `inactive-icon` slot + +##### Stepper + +- Support`Number` type of `input-width` prop ##### SubmitBar -- add `tip-icon` prop -- add `suffix-label` prop +- Add `tip-icon` prop +- Add `suffix-label` prop + +##### SwipeCell + +- Auto calc `left-width` and `right-width` ##### Switch @@ -322,25 +219,41 @@ Improve accessibility for those components： ##### SwitchCell -- add `border` prop -- add `cell-size` prop +- Add `border` prop +- Add `cell-size` prop ##### Sku -- add `preview-open` event -- add `preview-close` event +- Add `preview-open` event +- Add `preview-close` event ##### Tab -- Optimize `animated` performance +- Add `border` prop +- Optimize `animated` animation performance - Fix incorrect tab pane height when use `animated` prop ##### Tabbar -- add `route` prop -- add `border` prop -- add `inactive-color` prop +- Add `route` prop +- Add `border` prop +- Add `inactive-color` prop ##### TabbarItem -- add `name` prop +- Add `name` prop + +##### Toast + +- Add `onOpened` option + +##### Uploader + +- Add default upload style +- Add `delete` event +- Add `upload-text` prop +- Add `max-count` prop +- Add `preview-size` prop +- Add `preview-image` prop +- Support use `v-model` to bind file-list +- `oversize` event add `detail` param diff --git a/docs/markdown/changelog.zh-CN.md b/docs/markdown/changelog.zh-CN.md index 8132762ce..7aa9dc33c 100644 --- a/docs/markdown/changelog.zh-CN.md +++ b/docs/markdown/changelog.zh-CN.md @@ -1,192 +1,7 @@ # 更新日志 -### [v2.0.0-beta.5](https://github.com/youzan/vant/tree/v2.0.0-beta.5) -`2019-06-10` - -##### ActionSheet - -- 新增`click-overlay`事件 - -##### Field - -- 新增`input`插槽 - -##### Image - -- 修复懒加载模式下无法展示加载状态和错误状态的问题 - -##### List - -- 优化滚动判断逻辑 - -##### Toolbar - -- 新增`toolbar-position`属性 - - -### [v2.0.0-beta.4](https://github.com/youzan/vant/tree/v2.0.0-beta.4) -`2019-06-05` - -##### Checkbox - -- 修复`label-position`不生效的问题 - -##### Field - -- 新增`click`事件 -- 新增`clickable`属性 - -##### Radio - -- 修复`label-position`不生效的问题 - -##### Stepper - -- 支持`Number`类型的`input-width`属性 - -##### SwipeCell - -- 修复只渲染单侧内容时报错的问题 - -##### Uploader - -- 支持通过`v-model`绑定文件列表 -- 新增`max-count`属性 -- 新增`preview-size`属性 -- 新增`preview-image`属性 - - -### [v2.0.0-beta.3](https://github.com/youzan/vant/tree/v2.0.0-beta.3) -`2019-05-31` - -##### Field - -- 优化输入体验，输入法拼写过程中不再会触发`v-model`更新 - -##### IndexBar - -- 新增`sticky`属性 -- 新增`highlight-color`属性 - -##### Notify - -- 新增`onClose`选项 -- 新增`onOpened`选项 - -##### Picker - -- 优化动画延时 -- 点击确认按钮时自动终止动画 - -##### Rate - -- 新增`gutter`属性 -- 支持`String`类型的`size`属性 - -##### Search - -- 优化输入体验，输入法拼写过程中不再会触发`v-model`更新 - -##### SwipeCell - -- 支持自动计算`left-width`和`right-width` - -##### Toast - -- 新增`onOpened`选项 - - -### [v2.0.0-beta.2](https://github.com/youzan/vant/tree/v2.0.0-beta.2) -`2019-05-28` - -#### 无障碍访问 - -对以下组件增加了无障碍访问的支持： - -- List -- Rate -- Dialog -- Slider -- Switch -- NoticeBar -- GoodsAction -- DropdownMenu -- NumberKeyboard - -##### Area - -- 支持`reset`方法传入`code`参数 - -##### Button - -- 新增`icon`属性 - -##### ImagePreview - -- 新增`close-on-popstate`属性 - -##### Search - -- 新增`clearable`属性 -- 新增`left-icon`属性 -- 新增`right-icon`属性 -- 新增`right-icon`插槽 - -##### Slider - -- 新增`drag-start`事件 -- 新增`drag-end`事件 - -##### Uploader - -- 增加上传区域默认样式 -- 新增`upload-text`属性 - - -### [v2.0.0-beta.1](https://github.com/youzan/vant/tree/v2.0.0-beta.1) -`2019-05-24` - -#### 无障碍访问 - -对以下组件增加了无障碍访问的支持： - -- Accordion -- Checkbox -- Radio -- Stepper -- Tab - -##### ActionSheet - -- 新增`lock-scroll`属性 - -##### DatetimePicker - -- 新增`filter`属性 - -##### DropdownMenu - -- 新增`duration`属性 - -##### DropdownItem - -- 新增`title-class`属性 -- 修复在部分浏览器上定位错误的问题 - -##### Picker - -- 支持惯性滚动 - -##### Tab - -- 新增`border`属性 - -##### Uploader - -- `oversize`事件增加`detail`参数 - -### [v2.0.0-beta.0](https://github.com/youzan/vant/tree/v2.0.0-beta.0) -`2019-05-21` +### [v2.0.0](https://github.com/youzan/vant/tree/v2.0.0) +`2019-06-12` #### 主要变动 @@ -199,16 +14,32 @@ #### 新组件 -在 2.0 版本中，我们按照社区反馈新增以下组件： +在 2.0 版本中，我们引入了社区中呼声最高的四个组件，分别是： - `Image`图片组件 - `Skeleton`骨架屏组件 - `IndexBar`、`IndexAnchor`索引栏组件 - `DropdownMenu`、`DropdownItem`下拉菜单组件 + + +#### 新文档 + +文档方面，我们重新设计了文档站点，用卡片的方式组织段落，更加直观。对一些较为复杂的组件，我们对示例进行细粒度的拆分，添加更多的用法介绍，以帮助大家更快地上手使用。 + +此外，文档站点也支持了搜索和版本切换。 + + + +#### 样式定制 + +移动端 UI 风格多变，对组件的可定制性要求较高。从 2.0 版本开始，Vant 中的所有组件都支持通过 Less 变量进行样式定制。同时我们新增了较多样式相关的 Props，便于快速定制组件风格。 + + + #### 不兼容更新 -在 2.0 版本中，我们对部分组件和 API 进行重命名，以更加符合业界的命名规范，同时移除了少量不常用的属性，具体改动如下： +2.0 版本中包含少量不兼容更新，主要是调整命名和移除个别属性。对于正在使用 1.x 版本的项目，请按照下方的列表依次检查，大部分项目可以无痛升级。 ##### Actionsheet @@ -261,24 +92,60 @@ - 移除在 1.0 版本废弃的 Waterfall 组件，请使用`List`组件代替，或使用独立的[@vant/waterfall](https://github.com/chenjiahan/vant-waterfall)包。 +--- + +#### 无障碍访问 + +对以下组件增加了无障碍访问的支持： + +- Accordion +- Checkbox +- Dialog +- DropdownMenu +- GoodsAction +- List +- NoticeBar +- NumberKeyboard +- Radio +- Rate +- Stepper +- Tab +- Slider +- Switch + #### 新特性 ##### ActionSheet +- 新增`lock-scroll`属性 +- 新增`click-overlay`事件 - 新增`close-on-click-action`属性 - 支持同时使用`title`和`actions`属性 +##### Area + +- 支持`reset`方法传入`code`参数 + ##### Button +- 新增`icon`属性 - 新增`loading-type`属性 ##### Checkbox - 新增`icon-size`属性 +##### DatetimePicker + +- 新增`filter`属性 + ##### Field +- 新增`input`插槽 +- 新增`click`事件 +- 新增`clickable`属性 - 新增`label-class`属性 +- 优化输入体验，输入法拼写过程中不再会触发`v-model`更新 ##### GoodsActionButton @@ -288,6 +155,14 @@ - 支持`Number`类型的`size`属性 +##### ImagePreview + +- 新增`close-on-popstate`属性 + +##### List + +- 优化滚动判断逻辑 + ##### Loading - 新增`default`插槽 @@ -297,7 +172,9 @@ ##### Notify -- 新增`onClick`属性 +- 新增`onClick`选项 +- 新增`onClose`选项 +- 新增`onOpened`选项 ##### NoticeBar @@ -308,6 +185,11 @@ - 新增`gutter`属性 +##### Picker + +- 支持惯性滚动 +- 新增`toolbar-position`属性 + ##### Popup - 新增`click`事件 @@ -317,16 +199,42 @@ - 新增`icon-size`属性 +##### Rate + +- 新增`gutter`属性 +- 支持`String`类型的`size`属性 + +##### Search + +- 新增`clearable`属性 +- 新增`left-icon`属性 +- 新增`right-icon`属性 +- 新增`right-icon`插槽 +- 优化输入体验，输入法拼写过程中不再会触发`v-model`更新 + +##### Slider + +- 新增`drag-start`事件 +- 新增`drag-end`事件 + ##### Steps - 新增`inactive-icon`属性 - 新增`inactive-icon`插槽 +##### Stepper + +- 支持`Number`类型的`input-width`属性 + ##### SubmitBar - 新增`tip-icon`属性 - 新增`suffix-label`属性 +##### SwipeCell + +- 支持自动计算`left-width`和`right-width` + ##### Switch - 加载图标颜色现在会跟随背景色变化 @@ -343,6 +251,7 @@ ##### Tab +- 新增`border`属性 - 优化`animated`动画性能 - 修复开启`animated`后高度错误的问题 @@ -355,3 +264,30 @@ ##### TabbarItem - 新增`name`属性 + +##### Toast + +- 新增`onOpened`选项 + +##### Uploader + +- 新增上传区域默认样式 +- 新增`delete`事件 +- 新增`upload-text`属性 +- 新增`max-count`属性 +- 新增`preview-size`属性 +- 新增`preview-image`属性 +- 支持通过`v-model`绑定文件列表 +- `oversize`事件增加`detail`参数 + +--- + +#### 后续计划 + +我们计划在今年下半年推出 VantWeapp 1.0 版本，目标是对标 Vant 2.0 版本，将大部分新组件和新功能同步到小程序端。 + +同时，Vant 3.0 版本也在酝酿当中，不出意外的话，3.0 版本会基于 Vue 3.0 实现，并争取和 Vue 3.0 同期发布。 + +对于 Vant 1.x 版本，后续会进入维护期，跟进问题修复，但不再引入功能性改动。 + + diff --git a/package.json b/package.json index 5b30afdad..03c2836d5 100644 --- a/package.json +++ b/package.json @@ -71,7 +71,7 @@ "@babel/preset-env": "^7.4.5", "@babel/preset-typescript": "^7.3.3", "@types/jest": "^24.0.13", - "@vant/doc": "^2.3.0", + "@vant/doc": "^2.3.1", "@vant/eslint-config": "^1.1.2", "@vant/markdown-loader": "^2.0.0", "@vant/touch-emulator": "^1.0.0", diff --git a/yarn.lock b/yarn.lock index b2b46f1cd..f591a48cb 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1071,10 +1071,10 @@ lodash.unescape "4.0.1" semver "5.5.0" -"@vant/doc@^2.3.0": - version "2.3.0" - resolved "https://registry.yarnpkg.com/@vant/doc/-/doc-2.3.0.tgz#27ab1d8cf763a5e5128b205a217daae4601ce703" - integrity sha512-O6tk9UN9DXfHA8VJljr8tDtvaIIRUhHbKo+BIpanucfe4wJiWYJ/L793itulh2ussKdb8oO8i3GDnymZ3zkxAA== +"@vant/doc@^2.3.1": + version "2.3.1" + resolved "https://registry.yarnpkg.com/@vant/doc/-/doc-2.3.1.tgz#6b2fa62e7fb2070764bb78d18d99fc66e9a53762" + integrity sha512-PLyRcGhvODTlxJpiOJu6fvA3kyfDes1t1zENRtVtv0KDUCH/bd3+M4aKEVpRnNYeBIt969T+TNYDqKFtMIl/Zg== dependencies: cheerio "0.22.0" commander "^2.17.1"