Merge branch 'dev' into feature/form

2025-04-06 03:57:59 +08:00 · 2020-02-10 10:06:57 +08:00 · 2020-02-10 10:06:57 +08:00 · f385c94040
commit f385c94040
parent 70ed34aa24 aceaa2f739
64 changed files with 168 additions and 161 deletions
--- a/packages/vant-cli/site/desktop/components/Content.vue
+++ b/packages/vant-cli/site/desktop/components/Content.vue
@ -37,6 +37,7 @@ export default {
  }

  a {
+    margin: 0 1px;
    color: @van-doc-green;
    -webkit-font-smoothing: auto;
  }
@ -162,7 +163,7 @@ export default {
      box-sizing: border-box;
      width: 6px;
      height: 6px;
-      margin-top: 8px;
+      margin-top: 10px;
      border: 1px solid @van-doc-dark-grey;
      border-radius: 50%;
      content: '';
--- a/src/action-sheet/README.md
+++ b/src/action-sheet/README.md
@ -153,7 +153,7 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| select | Triggered when click option | item, index |
+| select | Triggered when click option | *action: Action, index: number* |
 | cancel | Triggered when cancel click | - |
 | click-overlay | Triggered when click overlay | - |
 | open | Triggered when open ActionSheet | - |
--- a/src/action-sheet/README.zh-CN.md
+++ b/src/action-sheet/README.zh-CN.md
@ -169,7 +169,7 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| select | 选中选项时触发，禁用或加载状态下不会触发 | item: 选项对应的对象, index: 选择对应的索引 |
+| select | 选中选项时触发，禁用或加载状态下不会触发 | *action: Action, index: number* |
 | cancel | 取消按钮点击时触发 | - |
 | click-overlay | 点击遮罩层时触发 | - |
 | open | 打开菜单时触发 | - |
--- a/src/button/README.md
+++ b/src/button/README.md
@ -125,5 +125,5 @@ Vue.use(Button);

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click button and not disabled or loading | event: Event |
-| touchstart | Triggered when touch start | event: TouchEvent |
+| click | Triggered when click button and not disabled or loading | *event: Event* |
+| touchstart | Triggered when touch start | *event: TouchEvent* |
--- a/src/button/README.zh-CN.md
+++ b/src/button/README.zh-CN.md
@ -148,5 +148,5 @@ Vue.use(Button);

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击按钮，且按钮状态不为加载或禁用时触发 | event: Event |
-| touchstart | 开始触摸按钮时触发 | event: TouchEvent |
+| click | 点击按钮，且按钮状态不为加载或禁用时触发 | *event: Event* |
+| touchstart | 开始触摸按钮时触发 | *event: TouchEvent* |
--- a/src/calendar/README.md
+++ b/src/calendar/README.md
@ -249,8 +249,8 @@ Set `poppable` to `false`, the calendar will be displayed directly on the page i

 | Event | Description | Arguments |
 |------|------|------|
-| select | Triggered when select date | value: Date \| Date[] |
-| confirm | Triggered after date selection is complete，if `show-confirm` is` true`, it is triggered after clicking the confirm button | value: Date \| Date[] |
+| select | Triggered when select date | *value: Date \| Date[]* |
+| confirm | Triggered after date selection is complete，if `show-confirm` is` true`, it is triggered after clicking the confirm button | *value: Date \| Date[]* |

 ### Slots

--- a/src/calendar/README.zh-CN.md
+++ b/src/calendar/README.zh-CN.md
@ -251,8 +251,8 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| select | 点击任意日期时触发 | value: Date \| Date[] |
-| confirm | 日期选择完成后触发，若`show-confirm`为`true`，则点击确认按钮后触发 | value: Date \| Date[] |
+| select | 点击任意日期时触发 | *value: Date \| Date[]* |
+| confirm | 日期选择完成后触发，若`show-confirm`为`true`，则点击确认按钮后触发 | *value: Date \| Date[]* |

 ### Slots

--- a/src/card/README.md
+++ b/src/card/README.md
@ -82,8 +82,8 @@ Use slot to custom content.

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when clicked | event: Event |
-| click-thumb | Triggered when thumb clicked | event: Event |
+| click | Triggered when clicked | *event: Event* |
+| click-thumb | Triggered when thumb clicked | *event: Event* |

 ### Slots

--- a/src/card/README.zh-CN.md
+++ b/src/card/README.zh-CN.md
@ -84,8 +84,8 @@ Vue.use(Card);

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
-| click-thumb | 点击自定义图片时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |
+| click-thumb | 点击自定义图片时触发 | *event: Event* |

 ### Slots

--- a/src/cell/README.md
+++ b/src/cell/README.md
@ -137,7 +137,7 @@ Vue.use(CellGroup);

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click cell | event: Event |
+| click | Triggered when click cell | *event: Event* |

 ### CellGroup Slots

--- a/src/cell/README.zh-CN.md
+++ b/src/cell/README.zh-CN.md
@ -148,7 +148,7 @@ Vue.use(CellGroup);

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击单元格时触发 | event: Event |
+| click | 点击单元格时触发 | *event: Event* |

 ### CellGroup Slots

--- a/src/checkbox/README.md
+++ b/src/checkbox/README.md
@ -187,9 +187,9 @@ export default {

 | Attribute | Description | Type | Default |
 |------|------|------|------|
+| v-model (value) | Check status | *boolean* | `false` |
 | name | Checkbox name | *any* | - |
 | shape | Can be set to `square` | *string* | `round` |
-| v-model | Check status | *boolean* | `false` |
 | disabled | Disable checkbox | *boolean* | `false` |
 | label-disabled | Whether to disable label click | *boolean* | `false` |
 | label-position | Can be set to `left` | *string* | `right` |
@ -201,7 +201,7 @@ export default {

 | Attribute | Description | Type | Default |
 |------|------|------|------|
-| v-model | Names of all checked checkboxes | *any[]* | - |
+| v-model (value) | Names of all checked checkboxes | *any[]* | - |
 | max | Maximum amount of checked options | *number \| string* | `0`(Unlimited) |
 | disabled | Disable all checkboxes | *boolean* | `false` |
 | icon-size `v2.2.3` | Icon size of all checkboxes | *number \| string* | `20px` |
@ -211,21 +211,21 @@ export default {

 | Event | Description | Parameters |
 |------|------|------|
-| change | Triggered when value changed | current value |
-| click | Triggered when click checkbox | event: Event |
+| change | Triggered when value changed | *checked: boolean* |
+| click | Triggered when click checkbox | *event: Event* |

 ### CheckboxGroup Events

 | Event | Description | Parameters |
 |------|------|------|
-| change | Triggered when value changed | current value |
+| change | Triggered when value changed | *names: any[]* |

 ### Checkbox Slots

 | Name | Description | SlotProps |
 |------|------|------|
 | default | Custom label | - |
-| icon | Custom icon | checked: whether to be checked |
+| icon | Custom icon | *checked: boolean* |

 ### CheckboxGroup Methods

@ -233,7 +233,7 @@ Use [ref](https://vuejs.org/v2/api/#ref) to get CheckboxGroup instance and call

 | Name | Description | Attribute | Return value |
 |------|------|------|------|
-| toggleAll | Toggle check status of all checkboxes | checked?: boolean | - |
+| toggleAll | Toggle check status of all checkboxes | *checked?: boolean* | - |

 ### Checkbox Methods

@ -241,4 +241,4 @@ Use [ref](https://vuejs.org/v2/api/#ref) to get Checkbox instance and call insta

 | Name | Description | Attribute | Return value |
 |------|------|------|------|
-| toggle | Toggle check status | checked?: boolean | - |
+| toggle | Toggle check status | *checked?: boolean* | - |
--- a/src/checkbox/README.zh-CN.md
+++ b/src/checkbox/README.zh-CN.md
@ -203,9 +203,9 @@ export default {

 | 参数 | 说明 | 类型 | 默认值 |
 |------|------|------|------|
+| v-model (value) | 是否为选中状态 | *boolean* | `false` |
 | name | 标识符 | *any* | - |
 | shape | 形状，可选值为 `square` | *string* | `round` |
-| v-model | 是否为选中状态 | *boolean* | `false` |
 | disabled | 是否禁用复选框 | *boolean* | `false` |
 | label-disabled | 是否禁用复选框文本点击 | *boolean* | `false` |
 | label-position | 文本位置，可选值为 `left` | *string* | `right` |
@ -217,7 +217,7 @@ export default {

 | 参数 | 说明 | 类型 | 默认值 |
 |------|------|------|------|
-| v-model | 所有选中项的标识符 | *any[]* | - |
+| v-model (value) | 所有选中项的标识符 | *any[]* | - |
 | disabled | 是否禁用所有复选框 | *boolean* | `false` |
 | max | 最大可选数，0 为无限制 | *number \| string* | `0` |
 | icon-size `v2.2.3` | 所有复选框的图标大小，默认单位为`px` | *number \| string* | `20px` |
@ -227,21 +227,21 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| change | 当绑定值变化时触发的事件 | 当前组件的值 |
-| click | 点击复选框时触发 | event: Event |
+| change | 当绑定值变化时触发的事件 | *checked: boolean* |
+| click | 点击复选框时触发 | *event: Event* |

 ### CheckboxGroup Events

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| change | 当绑定值变化时触发的事件 | 当前组件的值 |
+| change | 当绑定值变化时触发的事件 | *names: any[]* |

 ### Checkbox Slots

 | 名称 | 说明 | SlotProps |
 |------|------|------|
 | default | 自定义文本 | - |
-| icon | 自定义图标 | checked: 是否为选中状态 |
+| icon | 自定义图标 | *checked: boolean* |

 ### CheckboxGroup 方法

@ -249,7 +249,7 @@ export default {

 | 方法名 | 说明 | 参数 | 返回值 |
 |------|------|------|------|
-| toggleAll | 切换所有复选框，传`true`为选中，`false`为取消选中，不传参为取反 | checked?: boolean | - |
+| toggleAll | 切换所有复选框，传`true`为选中，`false`为取消选中，不传参为取反 | *checked?: boolean* | - |

 ### Checkbox 方法

@ -257,4 +257,4 @@ export default {

 | 方法名 | 说明 | 参数 | 返回值 |
 |------|------|------|------|
-| toggle | 切换选中状态，传`true`为选中，`false`为取消选中，不传参为取反 | checked?: boolean | - |
+| toggle | 切换选中状态，传`true`为选中，`false`为取消选中，不传参为取反 | *checked?: boolean* | - |
--- a/src/col/README.md
+++ b/src/col/README.md
@ -112,10 +112,10 @@ Setting `type` to `flex` to enable flex layout

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click row | event: Event |
+| click | Triggered when click row | *event: Event* |

 ### Col Events

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click col | event: Event |
+| click | Triggered when click col | *event: Event* |
--- a/src/col/README.zh-CN.md
+++ b/src/col/README.zh-CN.md
@ -115,10 +115,10 @@ Layout 组件提供了`24列栅格`，通过在`Col`上添加`span`属性设置

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |

 ### Col Events

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |
--- a/src/contact-card/README.md
+++ b/src/contact-card/README.md
@ -145,7 +145,7 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when clicked | event: Event |
+| click | Triggered when clicked | *event: Event* |

 ### ContactList Props

--- a/src/contact-card/README.zh-CN.md
+++ b/src/contact-card/README.zh-CN.md
@ -149,7 +149,7 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |

 ### ContactList Props

--- a/src/count-down/README.md
+++ b/src/count-down/README.md
@ -130,15 +130,15 @@ export default {
 | Event | Description | Arguments |
 |------|------|------|
 | finish | Triggered when count down finished | - |
-| change `v2.4.4` | Triggered when count down changed | timeData |
+| change `v2.4.4` | Triggered when count down changed | *timeData: TimeData* |

 ### Slots

 | Name | Description | SlotProps |
 |------|------|------|
-| default | Custom Content | timeData |
+| default | Custom Content | *timeData: TimeData* |

-### timeData Structure
+### TimeData Structure

 | Name | Description | Type |
 |------|------|------|
--- a/src/count-down/README.zh-CN.md
+++ b/src/count-down/README.zh-CN.md
@ -140,15 +140,15 @@ export default {
 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
 | finish | 倒计时结束时触发 | - |
-| change `v2.4.4` | 倒计时变化时触发 | timeData |
+| change `v2.4.4` | 倒计时变化时触发 | *timeData: TimeData* |

 ### Slots

 | 名称 | 说明 | SlotProps |
 |------|------|------|
-| default | 自定义内容 | timeData |
+| default | 自定义内容 | *timeData: TimeData* |

-### timeData 格式
+### TimeData 格式

 | 名称 | 说明 | 类型 |
 |------|------|------|
--- a/src/field/README.md
+++ b/src/field/README.md
@ -249,13 +249,13 @@ Field support all native events of input tag

 | Event | Description | Parameters |
 |------|------|------|
-| input | Triggered when input value changed | value: current value |
-| focus | Triggered when input gets focus | event: Event |
-| blur | Triggered when input loses focus | event: Event |
-| clear | Triggered when click clear icon | event: Event |
-| click | Triggered when click Field | event: Event |
-| click-left-icon | Triggered when click the left icon of Field | event: Event |
-| click-right-icon | Triggered when click the right icon of Field | event: Event |
+| input | Triggered when input value changed | *value: string* |
+| focus | Triggered when input gets focus | *event: Event* |
+| blur | Triggered when input loses focus | *event: Event* |
+| clear | Triggered when click clear icon | *event: Event* |
+| click | Triggered when click Field | *event: Event* |
+| click-left-icon | Triggered when click the left icon of Field | *event: Event* |
+| click-right-icon | Triggered when click the right icon of Field | *event: Event* |

 ### Methods

--- a/src/field/README.zh-CN.md
+++ b/src/field/README.zh-CN.md
@ -268,13 +268,13 @@ export default {

 | 事件 | 说明 | 回调参数 |
 |------|------|------|
-| input | 输入框内容变化时触发 | value: 输入框当前值 |
-| focus | 输入框获得焦点时触发 | event: Event |
-| blur | 输入框失去焦点时触发 | event: Event |
-| clear | 点击清除按钮时触发 | event: Event |
-| click | 点击时触发 | event: Event |
-| click-left-icon | 点击左侧图标时触发 | event: Event |
-| click-right-icon | 点击右侧图标时触发 | event: Event |
+| input | 输入框内容变化时触发 | *value: string (当前输入的值)* |
+| focus | 输入框获得焦点时触发 | *event: Event* |
+| blur | 输入框失去焦点时触发 | *event: Event* |
+| clear | 点击清除按钮时触发 | *event: Event* |
+| click | 点击时触发 | *event: Event* |
+| click-left-icon | 点击左侧图标时触发 | *event: Event* |
+| click-right-icon | 点击右侧图标时触发 | *event: Event* |

 ### 方法

--- a/src/grid/README.md
+++ b/src/grid/README.md
@ -126,7 +126,7 @@ Vue.use(GridItem);

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when clicked | event: Event |
+| click | Triggered when clicked | *event: Event* |

 ### GridItem Slots

--- a/src/grid/README.zh-CN.md
+++ b/src/grid/README.zh-CN.md
@ -144,7 +144,7 @@ Vue.use(GridItem);

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击格子时触发 | event: Event |
+| click | 点击格子时触发 | *event: Event* |

 ### GridItem Slots

--- a/src/icon/README.md
+++ b/src/icon/README.md
@ -97,4 +97,4 @@ import 'vant/lib/icon/local.css';

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click icon | event: Event |
+| click | Triggered when click icon | *event: Event* |
--- a/src/icon/README.zh-CN.md
+++ b/src/icon/README.zh-CN.md
@ -103,4 +103,4 @@ import 'vant/lib/icon/local.css';

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击图标时触发 | event: Event |
+| click | 点击图标时触发 | *event: Event* |
--- a/src/image/README.md
+++ b/src/image/README.md
@ -96,7 +96,7 @@ Vue.use(Lazyload);

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click image | event: Event |
+| click | Triggered when click image | *event: Event* |
 | load | Triggered when image loaded | - |
 | error | Triggered when image load failed | - |

--- a/src/image/README.zh-CN.md
+++ b/src/image/README.zh-CN.md
@ -128,7 +128,7 @@ Vue.use(Lazyload);

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击图片时触发 | event: Event |
+| click | 点击图片时触发 | *event: Event* |
 | load | 图片加载完毕时触发 | - |
 | error | 图片加载失败时触发 | - |

--- a/src/notice-bar/README.md
+++ b/src/notice-bar/README.md
@ -77,8 +77,8 @@ Vue.use(NoticeBar);

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click NoticeBar | event: Event |
-| close | Triggered when closed | event: Event |
+| click | Triggered when click NoticeBar | *event: Event* |
+| close | Triggered when closed | *event: Event* |

 ### Slots

--- a/src/notice-bar/README.zh-CN.md
+++ b/src/notice-bar/README.zh-CN.md
@ -85,8 +85,8 @@ Vue.use(NoticeBar);

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击通知栏时触发 | event: Event |
-| close | 关闭通知栏时触发 | event: Event |
+| click | 点击通知栏时触发 | *event: Event* |
+| close | 关闭通知栏时触发 | *event: Event* |

 ### Slots

--- a/src/overlay/README.md
+++ b/src/overlay/README.md
@ -69,7 +69,7 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when clicked | event: Event |
+| click | Triggered when clicked | *event: Event* |

 ### Slots

--- a/src/overlay/README.zh-CN.md
+++ b/src/overlay/README.zh-CN.md
@ -75,7 +75,7 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |

 ### Slots

--- a/src/popup/README.md
+++ b/src/popup/README.md
@ -139,7 +139,7 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when click Popup | event: Event |
+| click | Triggered when click Popup | *event: Event* |
 | open | Triggered when open Popup | - |
 | opened | Triggered when opened Popup | - |
 | close | Triggered when close Popup | - |
--- a/src/popup/README.zh-CN.md
+++ b/src/popup/README.zh-CN.md
@ -150,7 +150,7 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击弹出层时触发 | event: Event |
+| click | 点击弹出层时触发 | *event: Event* |
 | open | 打开弹出层时触发 | - |
 | opened | 打开弹出层且动画结束后触发 | - |
 | close | 关闭弹出层时触发 | - |
--- a/src/radio/README.md
+++ b/src/radio/README.md
@ -148,7 +148,7 @@ export default {

 | Attribute | Description | Type | Default |
 |------|------|------|------|
-| v-model | Name of checked radio | *any* | - |
+| v-model (v-model) | Name of checked radio | *any* | - |
 | disabled | Disable all radios | *boolean* | `false` |
 | icon-size `v2.2.3` | Icon size of all radios | *number \| string* | `20px` |
 | checked-color `v2.2.3` | Checked color of all radios | *string* | `#1989fa` | - |
@ -157,17 +157,17 @@ export default {

 | Event | Description | Parameters |
 |------|------|------|
-| click | Triggered when click radio | event: Event |
+| click | Triggered when click radio | *event: Event* |

 ### RadioGroup Events

 | Event | Description | Parameters |
 |------|------|------|
-| change | Triggered when value changed | current value |
+| change | Triggered when value changed | *name: string* |

 ### Radio Slots

 | Name | Description | SlotProps |
 |------|------|------|
 | default | Custom label | - |
-| icon | Custom icon | checked: whether to be checked |
+| icon | Custom icon | *checked: boolean* |
--- a/src/radio/README.zh-CN.md
+++ b/src/radio/README.zh-CN.md
@ -158,7 +158,7 @@ export default {

 | 参数 | 说明 | 类型 | 默认值 |
 |------|------|------|------|
-| v-model | 当前选中项的标识符 | *any* | - |
+| v-model (value) | 当前选中项的标识符 | *any* | - |
 | disabled | 是否禁用所有单选框 | *boolean* | `false` |
 | icon-size `v2.2.3` | 所有单选框的图标大小，默认单位为`px` | *number \| string* | `20px` |
 | checked-color `v2.2.3` | 所有单选框的选中状态颜色 | *string* | `#1989fa` |
@ -167,17 +167,17 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击单选框时触发 | event: Event |
+| click | 点击单选框时触发 | *event: Event* |

 ### RadioGroup Events

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| change | 当绑定值变化时触发的事件 | 当前选中项的 name |
+| change | 当绑定值变化时触发的事件 | *name: string* |

 ### Radio Slots

 | 名称 | 说明 | SlotProps |
 |------|------|------|
 | default | 自定义文本 | - |
-| icon | 自定义图标 | checked: 是否为选中状态 |
+| icon | 自定义图标 | *checked: boolean* |
--- a/src/search/README.md
+++ b/src/search/README.md
@ -135,11 +135,11 @@ Use `action` slot to custom right button, `cancel` event will no longer be trigg

 | Event | Description | Arguments |
 |------|------|------|
-| search | Triggered when confirm search | value: current value |
-| input | Triggered when input value changed | value: current value |
-| focus | Triggered when input gets focus | event: Event |
-| blur | Triggered when input loses focus | event: Event |
-| clear | Triggered when click clear icon | event: Event |
+| search | Triggered when confirm search | *value: string* |
+| input | Triggered when input value changed | *value: string* |
+| focus | Triggered when input gets focus | *event: Event* |
+| blur | Triggered when input loses focus | *event: Event* |
+| clear | Triggered when click clear icon | *event: Event* |
 | cancel | Triggered when click cancel button | - |

 ### Slots
--- a/src/search/README.zh-CN.md
+++ b/src/search/README.zh-CN.md
@ -135,11 +135,11 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| search | 确定搜索时触发 | value: 输入框当前值 |
-| input | 输入框内容变化时触发 | value: 输入框当前值 |
-| focus | 输入框获得焦点时触发 | event: Event |
-| blur | 输入框失去焦点时触发 | event: Event |
-| clear | 点击清除按钮后触发 | event: Event |
+| search | 确定搜索时触发 | *value: string (当前输入的值)* |
+| input | 输入框内容变化时触发 | *value: string (当前输入的值)* |
+| focus | 输入框获得焦点时触发 | *event: Event* |
+| blur | 输入框失去焦点时触发 | *event: Event* |
+| clear | 点击清除按钮后触发 | *event: Event* |
 | cancel | 点击取消按钮时触发 | - |

 ### Slots
--- a/src/stepper/README.md
+++ b/src/stepper/README.md
@ -130,9 +130,9 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| change | Triggered when value change | value: current value, detail: Detail info, contains name |
+| change | Triggered when value change | *value: string, detail: { name: string }* |
 | overlimit | Triggered when click disabled button | - |
 | plus | Triggered when click plus button | - |
 | minus | Triggered when click minus button | - |
-| focus | Triggered when input focused | event: Event |
-| blur | Triggered when input blured | event: Event |
+| focus | Triggered when input focused | *event: Event* |
+| blur | Triggered when input blured | *event: Event* |
--- a/src/stepper/README.zh-CN.md
+++ b/src/stepper/README.zh-CN.md
@ -131,7 +131,7 @@ export default {

 | 参数 | 说明 | 类型 | 默认值 |
 |------|------|------|------|
-| v-model | 当前输入值 | *number \| string* | - |
+| v-model | 当前输入的值 | *number \| string* | - |
 | min | 最小值 | *number \| string* | `1` |
 | max | 最大值 | *number \| string* | - |
 | default-value | 初始值，当 v-model 为空时生效 | *number \| string* | `1` |
@ -154,9 +154,9 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| change | 当绑定值变化时触发的事件 | value: 当前组件的值, detail: 额外信息，包含 name 的字段 |
+| change | 当绑定值变化时触发的事件 | *value: string, detail: { name: string }* |
 | overlimit | 点击不可用的按钮时触发 | - |
 | plus | 点击增加按钮时触发 | - |
 | minus | 点击减少按钮时触发 | - |
-| focus | 输入框聚焦时触发 | event: Event |
-| blur | 输入框失焦时触发 | event: Event |
+| focus | 输入框聚焦时触发 | *event: Event* |
+| blur | 输入框失焦时触发 | *event: Event* |
--- a/src/swipe/README.md
+++ b/src/swipe/README.md
@ -170,7 +170,7 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when clicked | event: Event |
+| click | Triggered when clicked | *event: Event* |

 ### Swipe Methods

--- a/src/swipe/README.zh-CN.md
+++ b/src/swipe/README.zh-CN.md
@ -176,7 +176,7 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |

 ### Swipe 方法

--- a/src/switch/README.md
+++ b/src/switch/README.md
@ -91,7 +91,7 @@ export default {

 | Attribute | Description | Type | Default |
 |------|------|------|------|
-| v-model | Check status of Switch | *any* | `false` |
+| v-model | Check status of Switch | *ActiveValue \| InactiveValue* | `false` |
 | loading | Whether to show loading icon | *boolean* | `false` |
 | disabled | Whether to disable switch | *boolean* | `false` |
 | size `v2.2.11` | Size of switch | *number \| string* | `30px` |
@ -104,5 +104,5 @@ export default {

 | Event | Description | Parameters |
 |------|------|------|
-| change | Triggered when check status changed | checked: is switch checked |
-| click `v2.2.11` | Triggered when clicked | event: Event |
+| change | Triggered when check status changed | *value: any* |
+| click `v2.2.11` | Triggered when clicked | *event: Event* |
--- a/src/switch/README.zh-CN.md
+++ b/src/switch/README.zh-CN.md
@ -109,12 +109,12 @@ export default {
 | size `v2.2.11` | 开关尺寸，默认单位为`px` | *number \| string* | `30px` |
 | active-color | 打开时的背景色 | *string* | `#1989fa` |
 | inactive-color | 关闭时的背景色 | *string* | `white` |
-| active-value | 打开时的值 | *any* | `true` |
-| inactive-value | 关闭时的值 | *any* | `false` |
+| active-value | 打开时对应的值 | *any* | `true` |
+| inactive-value | 关闭时对应的值 | *any* | `false` |

 ### Events

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| change | 开关状态切换回调 | checked: 是否选中开关 |
-| click `v2.2.11` | 点击时触发 | event: Event |
+| change | 开关状态切换时触发 | *value: any* |
+| click `v2.2.11` | 点击时触发 | *event: Event* |
--- a/src/tabs/index.js
+++ b/src/tabs/index.js
@ -6,10 +6,11 @@ import { isHidden } from '../utils/dom/style';
 import { on, off } from '../utils/dom/event';
 import { BORDER_TOP_BOTTOM } from '../utils/constant';
 import {
-  setRootScrollTop,
+  getScroller,
+  getVisibleTop,
  getElementTop,
  getVisibleHeight,
-  getVisibleTop,
+  setRootScrollTop,
 } from '../utils/dom/scroll';

 // Mixins
@ -27,9 +28,14 @@ export default createComponent({
  mixins: [
    ParentMixin('vanTabs'),
    BindEventMixin(function(bind) {
+      if (!this.scroller) {
+        this.scroller = getScroller(this.$el);
+      }
+
      bind(window, 'resize', this.resize, true);
+
      if (this.scrollspy) {
-        bind(window, 'scroll', this.onScroll, true);
+        bind(this.scroller, 'scroll', this.onScroll, true);
      }
    }),
  ],
@ -152,9 +158,9 @@ export default createComponent({

    scrollspy(val) {
      if (val) {
-        on(window, 'scroll', this.onScroll, true);
+        on(this.scroller, 'scroll', this.onScroll, true);
      } else {
-        off(window, 'scroll', this.onScroll);
+        off(this.scroller, 'scroll', this.onScroll);
      }
    },
  },
--- a/src/tag/README.md
+++ b/src/tag/README.md
@ -135,5 +135,5 @@ export default {

 | Event | Description | Arguments |
 |------|------|------|
-| click | Triggered when clicked | event: Event |
+| click | Triggered when clicked | *event: Event* |
 | close | Triggered when click close icon | - |
--- a/src/tag/README.zh-CN.md
+++ b/src/tag/README.zh-CN.md
@ -145,5 +145,5 @@ export default {

 | 事件名 | 说明 | 回调参数 |
 |------|------|------|
-| click | 点击时触发 | event: Event |
+| click | 点击时触发 | *event: Event* |
 | close | 关闭标签时触发 | - |