Browse Source

docs(configprovider、cascader、uploader、fixednav): edit api type

richard1015 3 years ago
parent
commit
3cb025917b

+ 2 - 0
.github/PULL_REQUEST_TEMPLATE.md

@@ -25,6 +25,8 @@ https://nutui.jd.com/#/zh-CN/guide/contributing
 - [ ] NutUI 2.0
 - [ ] NutUI 3.0 H5
 - [ ] NutUI 3.0 小程序
+- [ ] NutUI 4.0 H5
+- [ ] NutUI 4.0 小程序
 
 **这个 PR 是否已自测:**
 

+ 26 - 26
src/packages/__VUE/cascader/doc.en-US.md

@@ -420,23 +420,23 @@ export default {
 |---------------------|--------------------------------------------------------------------------------------------------------------|----------|-------------|
 | v-model             | Selected value, bidirectional binding                                                                        | Array    | -           |
 | options             | Cascade data                                                                                                 | Array    | -           |
-| lazy                | Whether to enable dynamic loading                                                                            | Boolean  | -           |
+| lazy                | Whether to enable dynamic loading                                                                            | boolean  | -           |
 | lazy-load           | Dynamic loading callback, which takes effect when dynamic loading is enabled                                 | Function | -           |
-| value-key           | Customize the field of `value` in the `options` structure                                                    | String   | -           |
-| text-key            | Customize the fields of `text` in the `options` structure                                                    | String   | -           |
-| children-key        | Customize the fields of `children` in the `options` structure                                                | String   | -           |
-| convert-config      | When options is a flat structure that can be converted into a tree structure, configure the conversion rules | Object   | -           |
-| title     | Title                                                                                                        | String   | ''          |
-| close-icon-position | Cancel the button position and inherit the popup component                                                   | String   | "top-right" |
-| close-icon | Customize the close button and inherit the popup component                                                   | String   | "close"     |
-| closeable | Whether to display the close button and inherit the popup component                                          | Boolean  | true        |
-| poppable | Whether to display the popup(After setting to false, the title is invalid) | Boolean   | true     |
+| value-key           | Customize the field of `value` in the `options` structure                                                    | string   | -           |
+| text-key            | Customize the fields of `text` in the `options` structure                                                    | string   | -           |
+| children-key        | Customize the fields of `children` in the `options` structure                                                | string   | -           |
+| convert-config      | When options is a flat structure that can be converted into a tree structure, configure the conversion rules | object   | -           |
+| title               | Title                                                                                                        | string   | ''          |
+| close-icon-position | Cancel the button position and inherit the popup component                                                   | string   | "top-right" |
+| close-icon          | Customize the close button and inherit the popup component                                                   | string   | "close"     |
+| closeable           | Whether to display the close button and inherit the popup component                                          | boolean  | true        |
+| poppable            | Whether to display the popup(After setting to false, the title is invalid)                                 | boolean  | true        |
 
 ### Events
 
-| Event      | Description                               | Arguments          |
-|------------|-------------------------------------------|--------------------|
-| change     | Triggered when the selected value changes | (value, pathNodes) |
+| Event       | Description                               | Arguments          |
+|-------------|-------------------------------------------|--------------------|
+| change      | Triggered when the selected value changes | (value, pathNodes) |
 | path-change | Triggered when the selected item changes  | (pathNodes)        |
 
 ## Theming
@@ -445,16 +445,16 @@ export default {
 
 The component provides the following CSS variables, which can be used to customize styles. Please refer to [ConfigProvider component](#/en-US/config-provider).
 
-| Name | Default Value | Description |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-cascader-font-size| _var(--nut-font-size-2)_  | -  |
-| --nut-cascader-line-height| _22px_  | -  |
-| --nut-cascader-tabs-item-padding| _0 10px_  | -  |
-| --nut-cascader-bar-padding| _24px 20px 17px_  | -  |
-| --nut-cascader-bar-font-size| _var(--nut-font-size-4)_  | -  |
-| --nut-cascader-bar-line-height| _20px_  | -  |
-| --nut-cascader-bar-color| _var(--nut-title-color)_  | -  |
-| --nut-cascader-item-padding| _10px 20px_  | -  |
-| --nut-cascader-item-color| _var(--nut-title-color)_  | -  |
-| --nut-cascader-item-font-size| _var(--nut-font-size-2)_  | -  |
-| --nut-cascader-item-active-color| _var(--nut-primary-color)_  | -  |
+| Name                             | Default Value              |
+|----------------------------------|----------------------------|
+| --nut-cascader-font-size         | _var(--nut-font-size-2)_   |
+| --nut-cascader-line-height       | _22px_                     |
+| --nut-cascader-tabs-item-padding | _0 10px_                   |
+| --nut-cascader-bar-padding       | _24px 20px 17px_           |
+| --nut-cascader-bar-font-size     | _var(--nut-font-size-4)_   |
+| --nut-cascader-bar-line-height   | _20px_                     |
+| --nut-cascader-bar-color         | _var(--nut-title-color)_   |
+| --nut-cascader-item-padding      | _10px 20px_                |
+| --nut-cascader-item-color        | _var(--nut-title-color)_   |
+| --nut-cascader-item-font-size    | _var(--nut-font-size-2)_   |
+| --nut-cascader-item-active-color | _var(--nut-primary-color)_ |

+ 31 - 31
src/packages/__VUE/cascader/doc.md

@@ -416,27 +416,27 @@ export default {
 
 ### Props
 
-| 参数          | 说明                                                  | 类型     | 默认值 |
-| ------------- | ----------------------------------------------------- | -------- | ------ |
-| v-model       | 选中值,双向绑定                                      | Array    | -      |
-| options       | 级联数据                                              | Array    | -      |
-| lazy          | 是否开启动态加载                                      | Boolean  | -      |
-| lazy-load      | 动态加载回调,开启动态加载时生效                      | Function | -      |
-| value-key      | 自定义`options`结构中`value`的字段                    | String   | -      |
-| text-key       | 自定义`options`结构中`text`的字段                     | String   | -      |
-| children-key   | 自定义`options`结构中`children`的字段                 | String   | -      |
-| convert-config | 当options为可转换为树形结构的扁平结构时,配置转换规则 | Object   | -      |
-| title | 标题 | String   | ''      |
-| close-icon-position | 取消按钮位置,继承 Popup 组件 | String   | "top-right"      |
-| close-icon | 自定义关闭按钮,继承 Popup 组件 | String   | "close"     |
-| closeable | 是否显示关闭按钮,继承 Popup 组件 | Boolean   | true     |
-| poppable | 是否需要弹层展示(设置为false后,title失效) | Boolean   | true     |
+| 参数                | 说明                                                  | 类型     | 默认值      |
+|---------------------|-------------------------------------------------------|----------|-------------|
+| v-model             | 选中值,双向绑定                                      | Array    | -           |
+| options             | 级联数据                                              | Array    | -           |
+| lazy                | 是否开启动态加载                                      | boolean  | -           |
+| lazy-load           | 动态加载回调,开启动态加载时生效                      | Function | -           |
+| value-key           | 自定义`options`结构中`value`的字段                    | string   | -           |
+| text-key            | 自定义`options`结构中`text`的字段                     | string   | -           |
+| children-key        | 自定义`options`结构中`children`的字段                 | string   | -           |
+| convert-config      | 当options为可转换为树形结构的扁平结构时,配置转换规则 | object   | -           |
+| title               | 标题                                                  | string   | ''          |
+| close-icon-position | 取消按钮位置,继承 Popup 组件                         | string   | "top-right" |
+| close-icon          | 自定义关闭按钮,继承 Popup 组件                       | string   | "close"     |
+| closeable           | 是否显示关闭按钮,继承 Popup 组件                     | boolean  | true        |
+| poppable            | 是否需要弹层展示(设置为false后,title失效)          | boolean  | true        |
 
 ### Events
 
-| 事件名     | 说明             | 回调参数           |
-| ---------- | ---------------- | ------------------ |
-| change     | 选中值改变时触发 | (value, pathNodes) |
+| 事件名      | 说明             | 回调参数           |
+|-------------|------------------|--------------------|
+| change      | 选中值改变时触发 | (value, pathNodes) |
 | path-change | 选中项改变时触发 | (pathNodes)        |
 
 ## 主题定制
@@ -445,16 +445,16 @@ export default {
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-cascader-font-size| _var(--nut-font-size-2)_  | -  |
-| --nut-cascader-line-height| _22px_  | -  |
-| --nut-cascader-tabs-item-padding| _0 10px_  | -  |
-| --nut-cascader-bar-padding| _24px 20px 17px_  | -  |
-| --nut-cascader-bar-font-size| _var(--nut-font-size-4)_  | -  |
-| --nut-cascader-bar-line-height| _20px_  | -  |
-| --nut-cascader-bar-color| _var(--nut-title-color)_  | -  |
-| --nut-cascader-item-padding| _10px 20px_  | -  |
-| --nut-cascader-item-color| _var(--nut-title-color)_  | -  |
-| --nut-cascader-item-font-size| _var(--nut-font-size-2)_  | -  |
-| --nut-cascader-item-active-color| _var(--nut-primary-color)_  | -  |
+| 名称                             | 默认值                     |
+|----------------------------------|----------------------------|
+| --nut-cascader-font-size         | _var(--nut-font-size-2)_   |
+| --nut-cascader-line-height       | _22px_                     |
+| --nut-cascader-tabs-item-padding | _0 10px_                   |
+| --nut-cascader-bar-padding       | _24px 20px 17px_           |
+| --nut-cascader-bar-font-size     | _var(--nut-font-size-4)_   |
+| --nut-cascader-bar-line-height   | _20px_                     |
+| --nut-cascader-bar-color         | _var(--nut-title-color)_   |
+| --nut-cascader-item-padding      | _10px 20px_                |
+| --nut-cascader-item-color        | _var(--nut-title-color)_   |
+| --nut-cascader-item-font-size    | _var(--nut-font-size-2)_   |
+| --nut-cascader-item-active-color | _var(--nut-primary-color)_ |

+ 31 - 31
src/packages/__VUE/cascader/doc.taro.md

@@ -416,27 +416,27 @@ export default {
 
 ### Props
 
-| 参数          | 说明                                                  | 类型     | 默认值 |
-| ------------- | ----------------------------------------------------- | -------- | ------ |
-| v-model       | 选中值,双向绑定                                      | Array    | -      |
-| options       | 级联数据                                              | Array    | -      |
-| lazy          | 是否开启动态加载                                      | Boolean  | -      |
-| lazy-load      | 动态加载回调,开启动态加载时生效                      | Function | -      |
-| value-key      | 自定义`options`结构中`value`的字段                    | String   | -      |
-| text-key       | 自定义`options`结构中`text`的字段                     | String   | -      |
-| children-key   | 自定义`options`结构中`children`的字段                 | String   | -      |
-| convert-config | 当options为可转换为树形结构的扁平结构时,配置转换规则 | Object   | -      |
-| title | 标题 | String   | ''      |
-| close-icon-position | 取消按钮位置,继承 Popup 组件 | String   | "top-right"      |
-| close-icon | 自定义关闭按钮,继承 Popup 组件 | String   | "close"     |
-| closeable | 是否显示关闭按钮,继承 Popup 组件 | Boolean   | true     |
-| poppable | 是否需要弹层展示(设置为false后,title失效) | Boolean   | true     |
+| 参数                | 说明                                                  | 类型     | 默认值      |
+|---------------------|-------------------------------------------------------|----------|-------------|
+| v-model             | 选中值,双向绑定                                      | Array    | -           |
+| options             | 级联数据                                              | Array    | -           |
+| lazy                | 是否开启动态加载                                      | boolean  | -           |
+| lazy-load           | 动态加载回调,开启动态加载时生效                      | Function | -           |
+| value-key           | 自定义`options`结构中`value`的字段                    | string   | -           |
+| text-key            | 自定义`options`结构中`text`的字段                     | string   | -           |
+| children-key        | 自定义`options`结构中`children`的字段                 | string   | -           |
+| convert-config      | 当options为可转换为树形结构的扁平结构时,配置转换规则 | object   | -           |
+| title               | 标题                                                  | string   | ''          |
+| close-icon-position | 取消按钮位置,继承 Popup 组件                         | string   | "top-right" |
+| close-icon          | 自定义关闭按钮,继承 Popup 组件                       | string   | "close"     |
+| closeable           | 是否显示关闭按钮,继承 Popup 组件                     | boolean  | true        |
+| poppable            | 是否需要弹层展示(设置为false后,title失效)          | boolean  | true        |
 
 ### Events
 
-| 事件名     | 说明             | 回调参数           |
-| ---------- | ---------------- | ------------------ |
-| change     | 选中值改变时触发 | (value, pathNodes) |
+| 事件名      | 说明             | 回调参数           |
+|-------------|------------------|--------------------|
+| change      | 选中值改变时触发 | (value, pathNodes) |
 | path-change | 选中项改变时触发 | (pathNodes)        |
 
 ## 主题定制
@@ -445,16 +445,16 @@ export default {
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-cascader-font-size| _var(--nut-font-size-2)_  | -  |
-| --nut-cascader-line-height| _22px_  | -  |
-| --nut-cascader-tabs-item-padding| _0 10px_  | -  |
-| --nut-cascader-bar-padding| _24px 20px 17px_  | -  |
-| --nut-cascader-bar-font-size| _var(--nut-font-size-4)_  | -  |
-| --nut-cascader-bar-line-height| _20px_  | -  |
-| --nut-cascader-bar-color| _var(--nut-title-color)_  | -  |
-| --nut-cascader-item-padding| _10px 20px_  | -  |
-| --nut-cascader-item-color| _var(--nut-title-color)_  | -  |
-| --nut-cascader-item-font-size| _var(--nut-font-size-2)_  | -  |
-| --nut-cascader-item-active-color| _var(--nut-primary-color)_  | -  |
+| 名称                             | 默认值                     |
+|----------------------------------|----------------------------|
+| --nut-cascader-font-size         | _var(--nut-font-size-2)_   |
+| --nut-cascader-line-height       | _22px_                     |
+| --nut-cascader-tabs-item-padding | _0 10px_                   |
+| --nut-cascader-bar-padding       | _24px 20px 17px_           |
+| --nut-cascader-bar-font-size     | _var(--nut-font-size-4)_   |
+| --nut-cascader-bar-line-height   | _20px_                     |
+| --nut-cascader-bar-color         | _var(--nut-title-color)_   |
+| --nut-cascader-item-padding      | _10px 20px_                |
+| --nut-cascader-item-color        | _var(--nut-title-color)_   |
+| --nut-cascader-item-font-size    | _var(--nut-font-size-2)_   |
+| --nut-cascader-item-active-color | _var(--nut-primary-color)_ |

+ 5 - 4
src/packages/__VUE/configprovider/doc.en-US.md

@@ -180,7 +180,8 @@ Here are all the base variables:
 
 ### Props
 
-| Attribute | Description                                                          | Type   | Default |
-|-----------|----------------------------------------------------------------------|--------|---------|
-| theme     | Theme style, set to `dark` to enable dark mode, take effect globally | String | -       |
-| tag       | HTML Tag of root element                                             | String | div     |
+| Attribute  | Description                                                          | Type   | Default |
+|------------|----------------------------------------------------------------------|--------|---------|
+| theme      | Theme style, set to `dark` to enable dark mode, take effect globally | string | -       |
+| theme-vars | Customized theme variable, partially effective                       | object | -       |
+| tag        | HTML Tag of root element                                             | string | div     |

+ 5 - 5
src/packages/__VUE/configprovider/doc.md

@@ -183,8 +183,8 @@ NutUI 中的 CSS 变量分为 **基础变量** 和 **组件变量**。组件变
 
 ### Props
 
-| 参数  | 说明                                             | 类型   | 默认值 |
-|-------|--------------------------------------------------|--------|--------|
-| theme | 主题风格,设置为 `dark` 来开启深色模式,全局生效 | String | -      |
-| theme-vars | 自定义主题变量,局部生效 | Object | -      |
-| tag   | 根节点对应的 HTML 标签名                         | String | div    |
+| 参数       | 说明                                             | 类型   | 默认值 |
+|------------|--------------------------------------------------|--------|--------|
+| theme      | 主题风格,设置为 `dark` 来开启深色模式,全局生效 | string | -      |
+| theme-vars | 自定义主题变量,局部生效                         | object | -      |
+| tag        | 根节点对应的 HTML 标签名                         | string | div    |

+ 5 - 5
src/packages/__VUE/configprovider/doc.taro.md

@@ -182,8 +182,8 @@ NutUI 中的 CSS 变量分为 **基础变量** 和 **组件变量**。组件变
 
 ### Props
 
-| 参数  | 说明                                             | 类型   | 默认值 |
-|-------|--------------------------------------------------|--------|--------|
-| theme | 主题风格,设置为 `dark` 来开启深色模式,全局生效 | String | -      |
-| theme-vars | 自定义主题变量,局部生效 | Object | -      |
-| tag   | 根节点对应的 HTML 标签名                         | String | div    |
+| 参数       | 说明                                             | 类型   | 默认值 |
+|------------|--------------------------------------------------|--------|--------|
+| theme      | 主题风格,设置为 `dark` 来开启深色模式,全局生效 | string | -      |
+| theme-vars | 自定义主题变量,局部生效                         | object | -      |
+| tag        | 根节点对应的 HTML 标签名                         | string | div    |

+ 1 - 1
src/packages/__VUE/fixednav/doc.en-US.md

@@ -138,7 +138,7 @@ const navList = reactive([
 | Attribute           | Description                                         | Type    | Default                      |
 |:--------------------|:----------------------------------------------------|:--------|:-----------------------------|
 | visible             | visible is                                          | boolean | false                        |
-| nav-list            | Suspended list content data                         | array   | []                           |
+| nav-list            | Suspended list content data                         | Array   | []                           |
 | active-color`3.2.1` | list active button color                            | string  | #fa2c19 Inherit theme color  |
 | active-text         | Stow list button copy                               | string  | Close Nav                    |
 | un-active-text      | Expand list button copy                             | string  | Open Nav                     |

+ 1 - 1
src/packages/__VUE/fixednav/doc.md

@@ -139,7 +139,7 @@ const navList = reactive([
 | 字段                | 说明                       | 类型    | 默认值                       |
 |:--------------------|:---------------------------|:--------|:-----------------------------|
 | visible             | 是否打开                   | boolean | false                        |
-| nav-list            | 悬浮列表内容数据           | array   | []                           |
+| nav-list            | 悬浮列表内容数据           | Array   | []                           |
 | active-color`3.2.1` | 选中按钮文案颜色           | string  | #fa2c19 默认集成主题色       |
 | active-text         | 收起列表按钮文案           | string  | 收起导航                     |
 | un-active-text      | 展开列表按钮文案           | string  | 快速导航                     |

+ 10 - 10
src/packages/__VUE/fixednav/doc.taro.md

@@ -140,16 +140,16 @@ return {
 
 ## API
 ### Props
-| 字段                | 说明                       | 类型    | 默认值                       |
-|:--------------------|:---------------------------|:--------|:-----------------------------|
-| visible             | 是否打开                   | boolean | false                        |
-| nav-list            | 悬浮列表内容数据           | array   | []                           |
-| active-color`3.2.1` | 选中按钮文案颜色           | string  | #fa2c19 默认集成主题色       |
-| active-text         | 收起列表按钮文案           | string  | 收起导航                     |
-| un-active-text      | 展开列表按钮文案           | string  | 快速导航                     |
-| type                | 导航方向,可选值 left right | string  | right                        |
-| overlay             | 展开时是否显示遮罩         | boolean | true                         |
-| position            | fixed 垂直位置             | object  | {top: 'auto',bottom: 'auto'} |
+| 字段           | 说明                       | 类型    | 默认值                       |
+|:---------------|:---------------------------|:--------|:-----------------------------|
+| visible        | 是否打开                   | boolean | false                        |
+| nav-list       | 悬浮列表内容数据           | Array   | []                           |
+| active-color   | 选中按钮文案颜色           | string  | #fa2c19 默认集成主题色       |
+| active-text    | 收起列表按钮文案           | string  | 收起导航                     |
+| un-active-text | 展开列表按钮文案           | string  | 快速导航                     |
+| type           | 导航方向,可选值 left right | string  | right                        |
+| overlay        | 展开时是否显示遮罩         | boolean | true                         |
+| position       | fixed 垂直位置             | object  | {top: 'auto',bottom: 'auto'} |
 
 
 ### Events

+ 33 - 33
src/packages/__VUE/form/doc.en-US.md

@@ -356,10 +356,10 @@ setup(){
 ## API
 ### Form Props
 
-| Attribute   | Description                                              | Type   | Default |
-|-------------|----------------------------------------------------------|--------|---------|
-| model-value | Form data object (required when using form verification) | object |         |
-| rules | Unified configuration FormItem attr rules  | { prop: FormItemRule[] } |  {}      |
+| Attribute   | Description                                              | Type                     | Default |
+|-------------|----------------------------------------------------------|--------------------------|---------|
+| model-value | Form data object (required when using form verification) | object                   |         |
+| rules       | Unified configuration FormItem attr rules                | { prop: FormItemRule[] } | {}      |
 
 ### Form Events
 
@@ -376,7 +376,7 @@ setup(){
 | rules               | Define validation rules                                                                     | FormItemRule []  | []      |
 | label-width         | The width of the form item label. The default unit is `px`                                  | number \| string | `90px`  |
 | label-align         | Form item label alignment. The optional values are `center` `right`                         | string           | `left`  |
-| body-align          | Default Solt box alignment. The optional values are `center` `right`                               | string           | `left`  |
+| body-align          | Default Solt box alignment. The optional values are `center` `right`                        | string           | `left`  |
 | error-message-align | Error prompt text alignment. The optional values are `center` and `right`                   | string           | `left`  |
 | show-error-line     | Whether to mark the input box in red when the verification fails                            | boolean          | `true`  |
 | show-error-message  | Whether to display the error prompt under the input box when the verification fails         | boolean          | `true`  |
@@ -385,19 +385,19 @@ setup(){
 
 Use the `rules` attribute of FormItem to define verification rules. The optional attributes are as follows:
 
-| Attribute | Default                            | Type                                    |
-|-----------|------------------------------------|-----------------------------------------|
-| required  | Is it a required field             | boolean                                 |
-| message   | Error prompt copy                  | string                                  |
+| Attribute | Default                            | Type                                                              |
+|-----------|------------------------------------|-------------------------------------------------------------------|
+| required  | Is it a required field             | boolean                                                           |
+| message   | Error prompt copy                  | string                                                            |
 | validator | Verification by function           | (value:string,rule?:FormItemRule) => boolean \| string \| Promise |
-| regex     | Verification by regular expression | RegExp                                  |
+| regex     | Verification by regular expression | RegExp                                                            |
 
 ### FormItem Slots
 
-| Name            | Description         |
-|-----------------|---------------------|
-| default         | Default slot        |
-| label | Custom `label` slot |
+| Name    | Description         |
+|---------|---------------------|
+| default | Default slot        |
+| label   | Custom `label` slot |
 
 
 ``` html
@@ -411,10 +411,10 @@ Use the `rules` attribute of FormItem to define verification rules. The optional
 
 Use [ref](https://vuejs.org/guide/essentials/template-refs.html#template-refs) to get Form instance and call instance methods.
 
-| Name              | Description                                                                                                       | Arguments                   | Return value |
-|-------------------|-------------------------------------------------------------------------------------------------------------------|-----------------------------|--------------|
-| submit   | Method of submitting form for verification                                                                        | -                           | -      |
-| reset             | Clear verification results                                                                                        | -                           | -            |
+| Name     | Description                                                                                                       | Arguments                   | Return value |
+|----------|-------------------------------------------------------------------------------------------------------------------|-----------------------------|--------------|
+| submit   | Method of submitting form for verification                                                                        | -                           | -            |
+| reset    | Clear verification results                                                                                        | -                           | -            |
 | validate | Active trigger verification is used to trigger when the user customizes the scene, such as blur and change events | Same as FormItem prop value | -            |
 
 
@@ -426,18 +426,18 @@ Use [ref](https://vuejs.org/guide/essentials/template-refs.html#template-refs) t
 
 The component provides the following CSS variables, which can be used to customize styles. Please refer to [ConfigProvider component](#/en-US/config-provider).
 
-| Name | Default Value | Description |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-form-item-error-line-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-required-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-error-message-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-label-font-size| _14px_ | -  |
-| --nut-form-item-label-width| _90px_ | -  |
-| --nut-form-item-label-margin-right| _10px_ | -  |
-| --nut-form-item-label-text-align| _left_ | -  |
-| --nut-form-item-required-margin-right| _4px_ | -  |
-| --nut-form-item-body-font-size| _14px_ | -  |
-| --nut-form-item-body-slots-text-align| _left_ | -  |
-| --nut-form-item-body-input-text-align| _left_ | -  |
-| --nut-form-item-tip-font-size| _10px_ | -  |
-| --nut-form-item-tip-text-align| _left_ | -  |
+| Name                                  | Default Value               |
+|---------------------------------------|-----------------------------|
+| --nut-form-item-error-line-color      | _var(--nut-required-color)_ |
+| --nut-form-item-required-color        | _var(--nut-required-color)_ |
+| --nut-form-item-error-message-color   | _var(--nut-required-color)_ |
+| --nut-form-item-label-font-size       | _14px_                      |
+| --nut-form-item-label-width           | _90px_                      |
+| --nut-form-item-label-margin-right    | _10px_                      |
+| --nut-form-item-label-text-align      | _left_                      |
+| --nut-form-item-required-margin-right | _4px_                       |
+| --nut-form-item-body-font-size        | _14px_                      |
+| --nut-form-item-body-slots-text-align | _left_                      |
+| --nut-form-item-body-input-text-align | _left_                      |
+| --nut-form-item-tip-font-size         | _10px_                      |
+| --nut-form-item-tip-text-align        | _left_                      |

+ 35 - 35
src/packages/__VUE/form/doc.md

@@ -356,10 +356,10 @@ setup(){
 ## API
 ### Form Props
 
-| 参数        | 说明                                 | 类型   | 默认值 |
-|-------------|--------------------------------------|--------|--------|
-| model-value | 表单数据对象(使用表单校验时,_必填_) | object |        |
-| rules | 统一配置每个 FormItem 的 rules  | { prop: FormItemRule[] } |  {}      |
+| 参数        | 说明                                 | 类型                     | 默认值 |
+|-------------|--------------------------------------|--------------------------|--------|
+| model-value | 表单数据对象(使用表单校验时,_必填_) | object                   |        |
+| rules       | 统一配置每个 FormItem 的 rules       | { prop: FormItemRule[] } | {}     |
 
 ### Form Events
 
@@ -373,10 +373,10 @@ setup(){
 |---------------------|------------------------------------------------------------------|------------------|---------|
 | required            | 是否显示必填字段的标签旁边的红色星号                             | boolean          | `false` |
 | prop                | 表单域 v-model 字段, 在使用表单校验功能的情况下,该属性是必填的 | string           | -       |
-| rules               | 定义校验规则                                  | FormItemRule []          | [] |
+| rules               | 定义校验规则                                                     | FormItemRule []  | []      |
 | label-width         | 表单项 label 宽度,默认单位为`px`                                | number \| string | `90px`  |
 | label-align         | 表单项 label 对齐方式,可选值为 `center` `right`                 | string           | `left`  |
-| body-align          | 右侧插槽对齐方式,可选值为 `center` `right`                        | string           | `left`  |
+| body-align          | 右侧插槽对齐方式,可选值为 `center` `right`                      | string           | `left`  |
 | error-message-align | 错误提示文案对齐方式,可选值为 `center` `right`                  | string           | `left`  |
 | show-error-line     | 是否在校验不通过时标红输入框                                     | boolean          | `true`  |
 | show-error-message  | 是否在校验不通过时在输入框下方展示错误提示                       | boolean          | `true`  |
@@ -385,19 +385,19 @@ setup(){
 
 使用 FormItem 的`rules`属性可以定义校验规则,可选属性如下:
 
-| 键名      | 说明                   | 类型                                    |
-|-----------|------------------------|-----------------------------------------|
-| required  | 是否为必选字段         | boolean                                 |
-| message   | 错误提示文案           | string                                  |
+| 键名      | 说明                   | 类型                                                                |
+|-----------|------------------------|---------------------------------------------------------------------|
+| required  | 是否为必选字段         | boolean                                                             |
+| message   | 错误提示文案           | string                                                              |
 | validator | 通过函数进行校验       | (value:string, rule?:FormItemRule ) => boolean \| string \| Promise |
-| regex     | 通过正则表达式进行校验 | RegExp                                  |
+| regex     | 通过正则表达式进行校验 | RegExp                                                              |
 
 ### FormItem Slots
 
-| 名称            | 说明              |
-|-----------------|-------------------|
-| default         | 自定义内容        |
-| label | 自定义`label`区域 |
+| 名称    | 说明              |
+|---------|-------------------|
+| default | 自定义内容        |
+| label   | 自定义`label`区域 |
 
 
 ``` html
@@ -411,11 +411,11 @@ setup(){
 
 通过 [ref](https://vuejs.org/guide/essentials/template-refs.html#template-refs) 可以获取到 Form 实例并调用实例方法
 
-| 方法名            | 说明                                                               | 参数                | 返回值  |
-|-------------------|--------------------------------------------------------------------|---------------------|---------|
-| submit    | 提交表单进行校验的方法                                               | -                   | - |
-| reset             | 清空校验结果                                                       | -                   | -       |
-| validate | 用户主动触发校验,用于用户自定义场景时触发,例如 blur、change 事件 | 同 FormItem prop 值,不传值会校验全部 Rule | -       |
+| 方法名   | 说明                                                               | 参数                                      | 返回值 |
+|----------|--------------------------------------------------------------------|-------------------------------------------|--------|
+| submit   | 提交表单进行校验的方法                                             | -                                         | -      |
+| reset    | 清空校验结果                                                       | -                                         | -      |
+| validate | 用户主动触发校验,用于用户自定义场景时触发,例如 blur、change 事件 | 同 FormItem prop 值,不传值会校验全部 Rule | -      |
 
 
 ## 主题定制
@@ -424,18 +424,18 @@ setup(){
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-form-item-error-line-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-required-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-error-message-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-label-font-size| _14px_ | -  |
-| --nut-form-item-label-width| _90px_ | -  |
-| --nut-form-item-label-margin-right| _10px_ | -  |
-| --nut-form-item-label-text-align| _left_ | -  |
-| --nut-form-item-required-margin-right| _4px_ | -  |
-| --nut-form-item-body-font-size| _14px_ | -  |
-| --nut-form-item-body-slots-text-align| _left_ | -  |
-| --nut-form-item-body-input-text-align| _left_ | -  |
-| --nut-form-item-tip-font-size| _10px_ | -  |
-| --nut-form-item-tip-text-align| _left_ | -  |
+| 名称                                  | 默认值                      |
+|---------------------------------------|-----------------------------|
+| --nut-form-item-error-line-color      | _var(--nut-required-color)_ |
+| --nut-form-item-required-color        | _var(--nut-required-color)_ |
+| --nut-form-item-error-message-color   | _var(--nut-required-color)_ |
+| --nut-form-item-label-font-size       | _14px_                      |
+| --nut-form-item-label-width           | _90px_                      |
+| --nut-form-item-label-margin-right    | _10px_                      |
+| --nut-form-item-label-text-align      | _left_                      |
+| --nut-form-item-required-margin-right | _4px_                       |
+| --nut-form-item-body-font-size        | _14px_                      |
+| --nut-form-item-body-slots-text-align | _left_                      |
+| --nut-form-item-body-input-text-align | _left_                      |
+| --nut-form-item-tip-font-size         | _10px_                      |
+| --nut-form-item-tip-text-align        | _left_                      |

+ 35 - 35
src/packages/__VUE/form/doc.taro.md

@@ -356,10 +356,10 @@ setup(){
 ## API
 ### Form Props
 
-| 参数        | 说明                                 | 类型   | 默认值 |
-|-------------|--------------------------------------|--------|--------|
-| model-value | 表单数据对象(使用表单校验时,_必填_) | object |        |
-| rules | 统一配置每个 FormItem 的 rules  | { prop: FormItemRule[] } |  {}      |
+| 参数        | 说明                                 | 类型                     | 默认值 |
+|-------------|--------------------------------------|--------------------------|--------|
+| model-value | 表单数据对象(使用表单校验时,_必填_) | object                   |        |
+| rules       | 统一配置每个 FormItem 的 rules       | { prop: FormItemRule[] } | {}     |
 
 ### Form Events
 
@@ -373,10 +373,10 @@ setup(){
 |---------------------|------------------------------------------------------------------|------------------|---------|
 | required            | 是否显示必填字段的标签旁边的红色星号                             | boolean          | `false` |
 | prop                | 表单域 v-model 字段, 在使用表单校验功能的情况下,该属性是必填的 | string           | -       |
-| rules               | 定义校验规则                                  | FormItemRule []          | [] |
+| rules               | 定义校验规则                                                     | FormItemRule []  | []      |
 | label-width         | 表单项 label 宽度,默认单位为`px`                                | number \| string | `90px`  |
 | label-align         | 表单项 label 对齐方式,可选值为 `center` `right`                 | string           | `left`  |
-| body-align          | 右侧插槽对齐方式,可选值为 `center` `right`                        | string           | `left`  |
+| body-align          | 右侧插槽对齐方式,可选值为 `center` `right`                      | string           | `left`  |
 | error-message-align | 错误提示文案对齐方式,可选值为 `center` `right`                  | string           | `left`  |
 | show-error-line     | 是否在校验不通过时标红输入框                                     | boolean          | `true`  |
 | show-error-message  | 是否在校验不通过时在输入框下方展示错误提示                       | boolean          | `true`  |
@@ -385,19 +385,19 @@ setup(){
 
 使用 FormItem 的`rules`属性可以定义校验规则,可选属性如下:
 
-| 键名      | 说明                   | 类型                                    |
-|-----------|------------------------|-----------------------------------------|
-| required  | 是否为必选字段         | boolean                                 |
-| message   | 错误提示文案           | string                                  |
+| 键名      | 说明                   | 类型                                                                |
+|-----------|------------------------|---------------------------------------------------------------------|
+| required  | 是否为必选字段         | boolean                                                             |
+| message   | 错误提示文案           | string                                                              |
 | validator | 通过函数进行校验       | (value:string, rule?:FormItemRule ) => boolean \| string \| Promise |
-| regex     | 通过正则表达式进行校验 | RegExp                                  |
+| regex     | 通过正则表达式进行校验 | RegExp                                                              |
 
 ### FormItem Slots
 
-| 名称            | 说明              |
-|-----------------|-------------------|
-| default         | 自定义内容        |
-| label | 自定义`label`区域 |
+| 名称    | 说明              |
+|---------|-------------------|
+| default | 自定义内容        |
+| label   | 自定义`label`区域 |
 
 
 ``` html
@@ -411,11 +411,11 @@ setup(){
 
 通过 [ref](https://vuejs.org/guide/essentials/template-refs.html#template-refs) 可以获取到 Form 实例并调用实例方法
 
-| 方法名            | 说明                                                               | 参数                | 返回值  |
-|-------------------|--------------------------------------------------------------------|---------------------|---------|
-| submit    | 提交表单进行校验的方法                                               | -                   | - |
-| reset             | 清空校验结果                                                       | -                   | -       |
-| validate | 用户主动触发校验,用于用户自定义场景时触发,例如 blur、change 事件 | 同 FormItem prop 值,不传值会校验全部 Rule | -       |
+| 方法名   | 说明                                                               | 参数                                      | 返回值 |
+|----------|--------------------------------------------------------------------|-------------------------------------------|--------|
+| submit   | 提交表单进行校验的方法                                             | -                                         | -      |
+| reset    | 清空校验结果                                                       | -                                         | -      |
+| validate | 用户主动触发校验,用于用户自定义场景时触发,例如 blur、change 事件 | 同 FormItem prop 值,不传值会校验全部 Rule | -      |
 
 ## 主题定制
 
@@ -423,18 +423,18 @@ setup(){
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-form-item-error-line-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-required-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-error-message-color| _var(--nut-required-color)_ | -  |
-| --nut-form-item-label-font-size| _14px_ | -  |
-| --nut-form-item-label-width| _90px_ | -  |
-| --nut-form-item-label-margin-right| _10px_ | -  |
-| --nut-form-item-label-text-align| _left_ | -  |
-| --nut-form-item-required-margin-right| _4px_ | -  |
-| --nut-form-item-body-font-size| _14px_ | -  |
-| --nut-form-item-body-slots-text-align| _left_ | -  |
-| --nut-form-item-body-input-text-align| _left_ | -  |
-| --nut-form-item-tip-font-size| _10px_ | -  |
-| --nut-form-item-tip-text-align| _left_ | -  |
+| 名称                                  | 默认值                      |
+|---------------------------------------|-----------------------------|
+| --nut-form-item-error-line-color      | _var(--nut-required-color)_ |
+| --nut-form-item-required-color        | _var(--nut-required-color)_ |
+| --nut-form-item-error-message-color   | _var(--nut-required-color)_ |
+| --nut-form-item-label-font-size       | _14px_                      |
+| --nut-form-item-label-width           | _90px_                      |
+| --nut-form-item-label-margin-right    | _10px_                      |
+| --nut-form-item-label-text-align      | _left_                      |
+| --nut-form-item-required-margin-right | _4px_                       |
+| --nut-form-item-body-font-size        | _14px_                      |
+| --nut-form-item-body-slots-text-align | _left_                      |
+| --nut-form-item-body-input-text-align | _left_                      |
+| --nut-form-item-tip-font-size         | _10px_                      |
+| --nut-form-item-tip-text-align        | _left_                      |

+ 35 - 37
src/packages/__VUE/uploader/doc.en-US.md

@@ -361,34 +361,32 @@ export default {
 ## API
 ### Props
 
-| Attribute                 | Description                                                                                                                                      | Type                                       | Default          |
-|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|------------------|
-| auto-upload               | Whether to upload the file immediately after selecting it, if false, you need to manually execute the ref submit method to upload                | Boolean                                    | true             |
-| name                      | The name of the `input` tag `name`, the file parameter name sent to the background                                                               | String                                     | "file"           |
-| url                       | The interface address of the upload server                                                                                                       | String                                     | -                |
-| v-model:file-list         | List of uploaded files by default                                                                                                                | FileItem[]                                 | []               |
-| is-preview                | Whether to display the preview image after the upload is successful                                                                              | Boolean                                    | true             |
-| is-deletable              | Whether to display the delete button                                                                                                             | Boolean                                    | true             |
-| method                    | The http method of upload request                                                                                                                | String                                     | "post"           |
-| list-type                 | Built-in stylesheets, support for three types: `picture`、`list`                                                                                 | String                                     | "picture"        |
-| capture                   | Capture, can be set to [camera](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input#htmlattrdefcapture),turn on the camera directly | String                                     | false            |
-| maximize                  | You can set the maximum upload file size (bytes)                                                                                                 | Number丨String                             | Number.MAX_VALUE |
-| maximum                   | File upload limit                                                                                                                                | Number丨String                             | 1                |
-| clear-input               | Whether to clear the `input` content, set to `true` to support repeated selection and upload of the same file                                    | Boolean                                    | true             |
-| accept                    | File types that can be accepted. See [input accept Attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept)       | String                                     | *                |
-| headers                   | Set request headers                                                                                                                              | Object                                     | {}               |
-| data                      | Uploading extra params or function which can return uploading extra params                                                                       | Object                                     | {}               |
-| upload-icon               | Upload area [icon name](#/en-US/component/icon) or image link                                                                                    | String                                     | "photograph"     |
-| upload-icon-size          | Upload area [icon size] (#/en-US/component/icon) size, such as `20px` `2em` `2rem`                                                               | string \| object                           | -                |
-| xhr-state                 | The success status (status) value of the interface response                                                                                      | Number                                     | 200              |
-| with-credentials          | The ajax upload with cookie sent                                                                                                                 | Boolean                                    | false            |
-| multiple                  | Whether to support multiple file selection                                                                                                       | Boolean                                    | false            |
-| disabled                  | Whether to disable file upload                                                                                                                   | Boolean                                    | false            |
-| timeout                   | timeout, in milliseconds                                                                                                                         | Number丨String                             | 1000 * 30        |
-| before-upload             | Hook before reading the file, return false to stop reading the file, can return Promise                                                          | Function                                   | null             |
+| Attribute         | Description                                                                                                                                      | Type                                       | Default          |
+|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|------------------|
+| auto-upload       | Whether to upload the file immediately after selecting it, if false, you need to manually execute the ref submit method to upload                | boolean                                    | true             |
+| name              | The name of the `input` tag `name`, the file parameter name sent to the background                                                               | string                                     | "file"           |
+| url               | The interface address of the upload server                                                                                                       | string                                     | -                |
+| v-model:file-list | List of uploaded files by default                                                                                                                | FileItem[]                                 | []               |
+| is-preview        | Whether to display the preview image after the upload is successful                                                                              | boolean                                    | true             |
+| is-deletable      | Whether to display the delete button                                                                                                             | boolean                                    | true             |
+| method            | The http method of upload request                                                                                                                | string                                     | "post"           |
+| list-type         | Built-in stylesheets, support for three types: `picture`、`list`                                                                                 | string                                     | "picture"        |
+| capture           | Capture, can be set to [camera](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input#htmlattrdefcapture),turn on the camera directly | string                                     | false            |
+| maximize          | You can set the maximum upload file size (bytes)                                                                                                 | number \| string                           | Number.MAX_VALUE |
+| maximum           | File upload limit                                                                                                                                | number \| string                           | 1                |
+| clear-input       | Whether to clear the `input` content, set to `true` to support repeated selection and upload of the same file                                    | boolean                                    | true             |
+| accept            | File types that can be accepted. See [input accept Attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept)       | string                                     | *                |
+| headers           | Set request headers                                                                                                                              | object                                     | {}               |
+| data              | Uploading extra params or function which can return uploading extra params                                                                       | object                                     | {}               |
+| upload-icon-size  | Upload area [icon size] (#/en-US/component/icon) size, such as `20px` `2em` `2rem`                                                               | string \| object                           | -                |
+| xhr-state         | The success status (status) value of the interface response                                                                                      | number                                     | 200              |
+| with-credentials  | The ajax upload with cookie sent                                                                                                                 | boolean                                    | false            |
+| multiple          | Whether to support multiple file selection                                                                                                       | boolean                                    | false            |
+| disabled          | Whether to disable file upload                                                                                                                   | boolean                                    | false            |
+| timeout           | timeout, in milliseconds                                                                                                                         | number \| string                           | 1000 * 30        |
+| before-upload     | Hook before reading the file, return false to stop reading the file, can return Promise                                                          | Function                                   | null             |
 | before-xhr-upload | Customize the method when uploading XHR                                                                                                          | Function(xhr,option)                      | null             |
-| before-delete             | Hook before delete the file, return false to stop reading the file, can return Promise                                                           | Function(file,fileList): boolean 丨Promise | -                |
-| delete-icon               | Customize the delete button by passing in [icon name](/#/en-US/component/icon) or an image link                                                  | String                                     | "photograph"     |
+| before-delete     | Hook before delete the file, return false to stop reading the file, can return Promise                                                           | Function(file,fileList): boolean 丨Promise | -                |
 
 
 ### FileItem
@@ -417,11 +415,11 @@ export default {
 
 ### Uploader Slots
 
-| Name               | Description                          |
-|--------------------|--------------------------------------|
-| default            | Default slot                         |
-| upload-icon`4.0.0` | Custom Uploader Button Center `icon` |
-| delete-icon`4.0.0` | Custom Right Delete Button           |
+| Name        | Description                          |
+|-------------|--------------------------------------|
+| default     | Default slot                         |
+| upload-icon | Custom Uploader Button Center `icon` |
+| delete-icon | Custom Right Delete Button           |
 
 ### Methods
 
@@ -438,8 +436,8 @@ Use [ref](https://vuejs.org/guide/essentials/template-refs.html#template-refs) t
 
 The component provides the following CSS variables, which can be used to customize styles. Please refer to [ConfigProvider component](#/en-US/config-provider).
 
-| Name | Default Value | Description |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-uploader-picture-width| _100px_  | -  |
-| --nut-uploader-picture-height| _100px_  | -  |
-| --nut-uploader-background| _#f7f8fa_  | -  |
+| Name                          | Default Value |
+|-------------------------------|---------------|
+| --nut-uploader-picture-width  | _100px_       |
+| --nut-uploader-picture-height | _100px_       |
+| --nut-uploader-background     | _#f7f8fa_     |

+ 35 - 36
src/packages/__VUE/uploader/doc.md

@@ -361,32 +361,31 @@ export default {
 ## API
 ### Props
 
-| 字段                      | 说明                                                                                                                                                                                   | 类型                                       | 默认值           |
-|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|------------------|
-| auto-upload               | 是否在选取文件后立即进行上传,false 时需要手动执行 ref submit 方法进行上传                                                                                                             | Boolean                                    | true             |
-| name                      | `input` 标签 `name` 的名称,发到后台的文件参数名                                                                                                                                       | String                                     | "file"           |
-| url                       | 上传服务器的接口地址                                                                                                                                                                   | String                                     | -                |
-| v-model:file-list         | 默认已经上传的文件列表                                                                                                                                                                 | FileItem[]                                 | []               |
-| is-preview                | 是否上传成功后展示预览图                                                                                                                                                               | Boolean                                    | true             |
-| is-deletable              | 是否展示删除按钮                                                                                                                                                                       | Boolean                                    | true             |
-| method                    | 上传请求的 http method                                                                                                                                                                 | String                                     | "post"           |
-| list-type                 | 上传列表的内建样式,支持两种基本样式 picture、list                                                                                                                                     | String                                     | "picture"        |
-| capture                   | 图片[选取模式](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input#htmlattrdefcapture),直接调起摄像头                                                                     | String                                     | false            |
-| maximize                  | 可以设定最大上传文件的大小(字节)                                                                                                                                                     | Number丨String                             | Number.MAX_VALUE |
-| maximum                   | 文件上传数量限制                                                                                                                                                                       | Number丨String                             | 1                |
-| clear-input               | 是否需要清空`input`内容,设为`true`支持重复选择上传同一个文件                                                                                                                          | Boolean                                    | true             |
-| accept                    | 允许上传的文件类型,[详细说明](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/Input/file#%E9%99%90%E5%88%B6%E5%85%81%E8%AE%B8%E7%9A%84%E6%96%87%E4%BB%B6%E7%B1%BB%E5%9E%8B) | String                                     | *                |
-| headers                   | 设置上传的请求头部                                                                                                                                                                     | Object                                     | {}               |
-| data                      | 附加上传的信息 formData                                                                                                                                                                | Object                                     | {}               |
-| upload-icon               | 上传区域[图标名称](#/zh-CN/component/icon)或图片链接                                                                                                                                   | String                                     | "photograph"     |
-| xhr-state                 | 接口响应的成功状态(status)值                                                                                                                                                         | Number                                     | 200              |
-| with-credentials          | 支持发送 cookie 凭证信息                                                                                                                                                               | Boolean                                    | false            |
-| multiple                  | 是否支持文件多选                                                                                                                                                                       | Boolean                                    | false            |
-| disabled                  | 是否禁用文件上传                                                                                                                                                                       | Boolean                                    | false            |
-| timeout                   | 超时时间,单位为毫秒                                                                                                                                                                   | Number丨String                             | 1000 * 30        |
-| before-upload             | 上传前的函数需要返回一个`Promise`对象                                                                                                                                                  | Function                                   | null             |
-| before-xhr-upload | 执行 XHR 上传时,自定义方式                                                                                                                                                            | Function(xhr,option)                      | null             |
-| before-delete             | 除文件时的回调,返回值为 false 时不移除。支持返回一个 `Promise` 对象,`Promise` 对象 resolve(false) 或 reject 时不移除                                                                 | Function(file,fileList): boolean 丨Promise | -                |
+| 字段              | 说明                                                                                                                   | 类型                                       | 默认值           |
+|-------------------|------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|------------------|
+| auto-upload       | 是否在选取文件后立即进行上传,false 时需要手动执行 ref submit 方法进行上传                                             | boolean                                    | true             |
+| name              | `input` 标签 `name` 的名称,发到后台的文件参数名                                                                       | string                                     | "file"           |
+| url               | 上传服务器的接口地址                                                                                                   | string                                     | -                |
+| v-model:file-list | 默认已经上传的文件列表                                                                                                 | FileItem[]                                 | []               |
+| is-preview        | 是否上传成功后展示预览图                                                                                               | boolean                                    | true             |
+| is-deletable      | 是否展示删除按钮                                                                                                       | boolean                                    | true             |
+| method            | 上传请求的 http method                                                                                                 | string                                     | "post"           |
+| list-type         | 上传列表的内建样式,支持两种基本样式 picture、list                                                                     | string                                     | "picture"        |
+| capture           | 图片[选取模式](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input#htmlattrdefcapture),直接调起摄像头     | string                                     | false            |
+| maximize          | 可以设定最大上传文件的大小(字节)                                                                                     | number \| string                           | Number.MAX_VALUE |
+| maximum           | 文件上传数量限制                                                                                                       | number \| string                           | 1                |
+| clear-input       | 是否需要清空`input`内容,设为`true`支持重复选择上传同一个文件                                                          | boolean                                    | true             |
+| accept            | 允许上传的文件类型,[详细说明](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/Input/file)                   | string                                     | *                |
+| headers           | 设置上传的请求头部                                                                                                     | object                                     | {}               |
+| data              | 附加上传的信息 formData                                                                                                | object                                     | {}               |
+| xhr-state         | 接口响应的成功状态(status)值                                                                                         | number                                     | 200              |
+| with-credentials  | 支持发送 cookie 凭证信息                                                                                               | boolean                                    | false            |
+| multiple          | 是否支持文件多选                                                                                                       | boolean                                    | false            |
+| disabled          | 是否禁用文件上传                                                                                                       | boolean                                    | false            |
+| timeout           | 超时时间,单位为毫秒                                                                                                   | number \| string                           | 1000 * 30        |
+| before-upload     | 上传前的函数需要返回一个`Promise`对象                                                                                  | Function                                   | null             |
+| before-xhr-upload | 执行 XHR 上传时,自定义方式                                                                                            | Function(xhr,option)                      | null             |
+| before-delete     | 除文件时的回调,返回值为 false 时不移除。支持返回一个 `Promise` 对象,`Promise` 对象 resolve(false) 或 reject 时不移除 | Function(file,fileList): boolean 丨Promise | -                |
 
 > 注意:accept、capture 和 multiple 为浏览器 input 标签的原生属性,移动端各种机型对这些属性的支持程度有所差异,因此在不同机型和 WebView 下可能出现一些兼容性问题。
 
@@ -416,11 +415,11 @@ export default {
 
 ### Uploader Slots
 
-| 名称               | 说明                         |
-|--------------------|------------------------------|
-| default            | 默认插槽自定义内容           |
-| upload-icon`4.0.0` | 自定义上传按钮中间`icon`区域 |
-| delete-icon`4.0.0` | 自定义右上角删除按钮区域     |
+| 名称        | 说明                         |
+|-------------|------------------------------|
+| default     | 默认插槽自定义内容           |
+| upload-icon | 自定义上传按钮中间`icon`区域 |
+| delete-icon | 自定义右上角删除按钮区域     |
 
 
 ### Methods
@@ -439,8 +438,8 @@ export default {
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-uploader-picture-width| _100px_  | -  |
-| --nut-uploader-picture-height| _100px_  | -  |
-| --nut-uploader-background| _#f7f8fa_  | -  |
+| 名称                          | 默认值    |
+|-------------------------------|-----------|
+| --nut-uploader-picture-width  | _100px_   |
+| --nut-uploader-picture-height | _100px_   |
+| --nut-uploader-background     | _#f7f8fa_ |

+ 32 - 33
src/packages/__VUE/uploader/doc.taro.md

@@ -228,29 +228,28 @@ setup() {
 ## API
 ### Props
 
-| 字段                      | 说明                                                                                                                   | 类型                                       | 默认值                    |
-|---------------------------|------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|---------------------------|
-| auto-upload               | 是否在选取文件后立即进行上传,false 时需要手动执行 ref submit 方法进行上传                                             | Boolean                                    | true                      |
-| name                      | 发到后台的文件参数名                                                                                                   | String                                     | "file"                    |
-| url                       | 上传服务器的接口地址                                                                                                   | String                                     | -                         |
-| v-model:file-list         | 默认已经上传的文件列表                                                                                                 | FileItem[]                                 | []                        |
-| is-preview                | 是否上传成功后展示预览图                                                                                               | Boolean                                    | true                      |
-| is-deletable              | 是否展示删除按钮                                                                                                       | Boolean                                    | true                      |
-| method                    | 上传请求的 http method                                                                                                 | String                                     | "post"                    |
-| list-type                 | 上传列表的内建样式,支持两种基本样式 picture、list                                                                     | String                                     | "picture"                 |
-| source-type               | [选择图片的来源](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html)                 | String                                     | ['album','camera']        |
-| maximize                  | 可以设定最大上传文件的大小(字节)                                                                                     | Number丨String                             | 9                         |
-| maximum                   | 文件上传数量限制                                                                                                       | Number丨String                             | 1                         |
-| size-type                 | 是否压缩所选文件[详细说明](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html)       | String                                     | ['original','compressed'] |
-| headers                   | 设置上传的请求头部                                                                                                     | Object                                     | {}                        |
-| data                      | 附加上传的信息 formData                                                                                                | Object                                     | {}                        |
-| xhr-state                 | 接口响应的成功状态(status)值                                                                                         | Number                                     | 200                       |
-| disabled                  | 是否禁用文件上传                                                                                                       | Boolean                                    | false                     |
-| multiple`v2.3.4`          | 是否支持文件多选                                                                                                       | Boolean                                    | true                      |
-| timeout                   | 超时时间,单位为毫秒                                                                                                   | Number丨String                             | 1000 * 30                 |
-| before-upload             | 上传前的函数需要返回一个`Promise`对象                                                                                  | Function                                   | null                      |
-| before-xhr-upload | 执行 Taro.uploadFile 上传时,自定义方式                                                                                | Function(Taro.uploadFile,option)          | null                      |
-| before-delete             | 除文件时的回调,返回值为 false 时不移除。支持返回一个 `Promise` 对象,`Promise` 对象 resolve(false) 或 reject 时不移除 | Function(file,fileList): boolean 丨Promise | -                         |
+| 字段              | 说明                                                                                                             | 类型                              | 默认值                    |
+|-------------------|------------------------------------------------------------------------------------------------------------------|-----------------------------------|---------------------------|
+| auto-upload       | 是否在选取文件后立即进行上传,false 时需要手动执行 ref submit 方法进行上传                                       | boolean                           | true                      |
+| name              | 发到后台的文件参数名                                                                                             | string                            | "file"                    |
+| url               | 上传服务器的接口地址                                                                                             | string                            | -                         |
+| v-model:file-list | 默认已经上传的文件列表                                                                                           | FileItem[]                        | []                        |
+| is-preview        | 是否上传成功后展示预览图                                                                                         | boolean                           | true                      |
+| is-deletable      | 是否展示删除按钮                                                                                                 | boolean                           | true                      |
+| method            | 上传请求的 http method                                                                                           | string                            | "post"                    |
+| list-type         | 上传列表的内建样式,支持两种基本样式 picture、list                                                               | string                            | "picture"                 |
+| source-type       | [选择图片的来源](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html)           | string                            | ['album','camera']        |
+| maximize          | 可以设定最大上传文件的大小(字节)                                                                               | number \| string                  | 9                         |
+| maximum           | 文件上传数量限制                                                                                                 | number \| string                  | 1                         |
+| size-type         | 是否压缩所选文件[详细说明](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html) | string                            | ['original','compressed'] |
+| headers           | 设置上传的请求头部                                                                                               | object                            | {}                        |
+| data              | 附加上传的信息 formData                                                                                          | object                            | {}                        |
+| xhr-state         | 接口响应的成功状态(status)值                                                                                   | number                            | 200                       |
+| disabled          | 是否禁用文件上传                                                                                                 | boolean                           | false                     |
+| multiple          | 是否支持文件多选                                                                                                 | boolean                           | true                      |
+| timeout           | 超时时间,单位为毫秒                                                                                             | number \| string                  | 1000 * 30                 |
+| before-upload     | 上传前的函数需要返回一个`Promise`对象                                                                            | Function                          | null                      |
+| before-xhr-upload | 执行 Taro.uploadFile 上传时,自定义方式                                                                          | Function(Taro.uploadFile,option) | null                      |
 
 
 ### FileItem
@@ -278,11 +277,11 @@ setup() {
 
 ### Uploader Slots
 
-| 名称               | 说明                         |
-|--------------------|------------------------------|
-| default            | 默认插槽自定义内容           |
-| upload-icon`4.0.0` | 自定义上传按钮中间`icon`区域 |
-| delete-icon`4.0.0` | 自定义右上角删除按钮区域     |
+| 名称        | 说明                         |
+|-------------|------------------------------|
+| default     | 默认插槽自定义内容           |
+| upload-icon | 自定义上传按钮中间`icon`区域 |
+| delete-icon | 自定义右上角删除按钮区域     |
 
 
 
@@ -301,8 +300,8 @@ setup() {
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-uploader-picture-width| _100px_  | -  |
-| --nut-uploader-picture-height| _100px_  | -  |
-| --nut-uploader-background| _#f7f8fa_  | -  |
+| 名称                          | 默认值    |
+|-------------------------------|-----------|
+| --nut-uploader-picture-width  | _100px_   |
+| --nut-uploader-picture-height | _100px_   |
+| --nut-uploader-background     | _#f7f8fa_ |