浏览代码

fix: searchbar、textarea 文档修改

Ymm0008 3 年之前
父节点
当前提交
c8b4fea1d6

+ 42 - 40
src/packages/__VUE/searchbar/doc.en-US.md

@@ -215,39 +215,41 @@ export default {
 ```
 ```
 :::
 :::
 ## API
 ## API
+
 ### Props
 ### Props
 
 
-| Attribute | Description | Type   | Default |
-|--------------|----------------------------------|--------|------------------|
-| v-model | Currently entered value | number / string | ''|
-|label| left text of search box | string | ''|
-|shape | search box shape. The optional value is round | string | square|
-|max-length | maximum input length | [number, string] | '9999'|
-|input-type | input box type | string | 'text'|
-|placeholder | input box default dark grain | string | 'please enter'|
-|clear | whether to display the clear button | Boolean | true|
-|background | input box external background | string | '#fff'|
-|input-background | internal background of input box | string | '#f7f7f7'|
-|autofocus | Auto focus | boolean | false |
-|disabled| disable input box | Boolean | false|
-|readonly| input box read only | Boolean | false|
-|input-align| alignment, optional ` center ` ` right ` | string | left |
+| Parameter | Description | Type | Default |
+|--------------|---------------------------------- |-------|------------------|
+| v-model | current input value | number /| string | `''` |
+| label| left text of search box | string | `''` |
+| shape | search box shape, optional value is `square` `round` | string | `square` |
+| max-length | maximum input length | number \| string | `9999` |
+| input-type | input box type | string | `text` |
+| placeholder | The default dark pattern of the input box | string | `Please enter` |
+| clearable | whether to show clear button | boolean | `true` |
+| clear-icon | custom clear button icon (default use `@nutui/nutui-icons`) | Object | `CircleClose` |
+| background | external background of the input box | string | `#fff` |
+| input-background | background of input box | string | `#f7f7f7` |
+| autofocus | Whether to automatically focus | boolean | `false` |
+| focus-style | search box style when focused | Object | `-` |
+| disabled | Whether to disable the input box | boolean | `false` |
+| readonly| input field is read only | boolean | `false` |
+| input-align| alignment, optional `left` `center` `right` | string | `left` |
 
 
 
 
-### Events
 
 
+### Events
 
 
-| Event | Description                  | Arguments   |
+| Event Name | Description | Callback Parameters |
 |--------|----------------|--------------|
 |--------|----------------|--------------|
-|change | Triggered when content is entered | val, event |
-|focus | Triggered when focusing | val, event|
-|blur | Triggered when out of focus | val, event|
-|clear | Triggered when clicking empty | val|
-|search | Triggered when the Enter key is pressed | val, event|
-| click-input| Triggered when the input field is clicked| event |
-| click-left-icon| Triggered when the icon on the left is clicked| val, event |
-| click-right-icon| Triggered when the icon on the right is clicked| val, event |
-
+| change | fires when something is entered | `val, event` |
+| focus | fires on focus | `val, event` |
+| blur | Triggered when out of focus | `val, event` |
+| clear | Triggered when click clear | `val` |
+| search | fires when the ENTER key is pressed | `val, event` |
+| click-input| Fired when the input field is clicked | `event` |
+| click-left-icon| Fires when the left icon is clicked | `val, event` |
+| click-right-icon| Fires when the right icon is clicked | `val, event` |
 
 
 ### Slots
 ### Slots
 
 
@@ -264,17 +266,17 @@ 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).
 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-searchbar-background| _var(--nut-white)_  | -  |
-| --nut-searchbar-right-out-color| _var(--nut-black)_  | -  |
-| --nut-searchbar-padding| _9px 16px_  | -  |
-| --nut-searchbar-width| _100%_  | -  |
-| --nut-searchbar-input-background| _#f7f7f7_  | -  |
-| --nut-searchbar-input-padding| _0 0 0 13px_  | -  |
-| --nut-searchbar-input-height| _32px_  | -  |
-| --nut-searchbar-input-width| _100%_  | -  |
-| --nut-searchbar-input-border-radius| _16px_  | -  |
-| --nut-searchbar-input-box-shadow| _0 0 8px 0 rgba(0, 0, 0, 0.04)_  | -  |
-| --nut-searchbar-input-bar-color| _inherit_  | -  |
-| --nut-searchbar-input-bar-placeholder-color| _inherit_  | -  |
+| Name | Default Value |
+| --------------------------------------- | -------------------------- |
+| --nut-searchbar-background| _var(--nut-white)_  |
+| --nut-searchbar-right-out-color| _var(--nut-black)_  |
+| --nut-searchbar-padding| _9px 16px_  |
+| --nut-searchbar-width| _100%_  |
+| --nut-searchbar-input-background| _#f7f7f7_  |
+| --nut-searchbar-input-padding| _0 0 0 13px_  |
+| --nut-searchbar-input-height| _32px_  |
+| --nut-searchbar-input-width| _100%_  |
+| --nut-searchbar-input-border-radius| _16px_  |
+| --nut-searchbar-input-box-shadow| _0 0 8px 0 rgba(0, 0, 0, 0.04)_  |
+| --nut-searchbar-input-bar-color| _inherit_  |
+| --nut-searchbar-input-bar-placeholder-color| _inherit_  |

+ 37 - 37
src/packages/__VUE/searchbar/doc.md

@@ -219,21 +219,21 @@ export default {
     
     
 | 参数         | 说明                             | 类型   | 默认值           |
 | 参数         | 说明                             | 类型   | 默认值           |
 |--------------|----------------------------------|--------|------------------|
 |--------------|----------------------------------|--------|------------------|
-| v-model	         | 当前输入的值   | Number / String | ''      |
-| label| 搜索框左侧文本 | String | '' |
-| shape | 搜索框形状,可选值为 round | String | square |
-| max-length         | 最大输入长度   | [Number,String] | '9999'      |
-| input-type    | 输入框类型   | String | 'text'      |
-| placeholder        | 输入框默认暗纹  | String | '请输入'   |
-| clearable          | 是否展示清除按钮 | Boolean | true     |
-| clear-icon         | 自定义清除按钮图标 | String | "circle-close"     |
-| background      | 输入框外部背景 | String |   '#fff'   |
-| input-background   | 输入框内部背景 | String |   '#f7f7f7'   |
-| autofocus | 是否自动聚焦 | boolean | false |
-| focus-style | 聚焦时搜索框样式 | Object | - |
-| disabled | 是否禁用输入框 | boolean | false |
-| readonly| 输入框只读 | boolean | false |
-| input-align| 对齐方式,可选`center` `right` | string | `left` |
+| v-model	         | 当前输入的值   | number /| string | `''`     |
+| label| 搜索框左侧文本 | string | `''` |
+| shape | 搜索框形状,可选值为 `square` `round` | string | `square` |
+| max-length         | 最大输入长度   | number \| string | `9999`      |
+| input-type    | 输入框类型   | string | `text`      |
+| placeholder        | 输入框默认暗纹  | string | `请输入`   |
+| clearable          | 是否展示清除按钮 | boolean | `true`     |
+| clear-icon         | 自定义清除按钮图标(默认使用 `@nutui/nutui-icons`) | Object | `CircleClose`     |
+| background      | 输入框外部背景 | string |   `#fff`   |
+| input-background   | 输入框内部背景 | string |   `#f7f7f7`   |
+| autofocus | 是否自动聚焦 | boolean | `false` |
+| focus-style | 聚焦时搜索框样式 | Object | `-` |
+| disabled | 是否禁用输入框 | boolean | `false` |
+| readonly| 输入框只读 | boolean | `false` |
+| input-align| 对齐方式,可选`left` `center` `right` | string | `left` |
 
 
 
 
 
 
@@ -241,14 +241,14 @@ export default {
 
 
 | 事件名 | 说明           | 回调参数     |
 | 事件名 | 说明           | 回调参数     |
 |--------|----------------|--------------|
 |--------|----------------|--------------|
-| change  | 输入内容时触发 | val, event |
-| focus  | 聚焦时触发 | val, event |
-| blur  | 失焦时触发 | val, event |
-| clear  | 点击清空时触发 | val |
-| search  | 按下 ENTER 键时触发 | val, event |
-| click-input|	点击输入区域时触发	 |	event |
-| click-left-icon|	点击左侧图标时触发 |	val, event |
-| click-right-icon|	点击右侧图标时触发 |	val, event |
+| change  | 输入内容时触发 | `val, event` |
+| focus  | 聚焦时触发 | `val, event` |
+| blur  | 失焦时触发 | `val, event` |
+| clear  | 点击清空时触发 | `val` |
+| search  | 按下 ENTER 键时触发 | `val, event` |
+| click-input|	点击输入区域时触发	 |	`event` |
+| click-left-icon|	点击左侧图标时触发 |	`val, event` |
+| click-right-icon|	点击右侧图标时触发 |	`val, event` |
 
 
 ### Slots
 ### Slots
 
 
@@ -266,17 +266,17 @@ export default {
 
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-searchbar-background| _var(--nut-white)_  | -  |
-| --nut-searchbar-right-out-color| _var(--nut-black)_  | -  |
-| --nut-searchbar-padding| _9px 16px_  | -  |
-| --nut-searchbar-width| _100%_  | -  |
-| --nut-searchbar-input-background| _#f7f7f7_  | -  |
-| --nut-searchbar-input-padding| _0 0 0 13px_  | -  |
-| --nut-searchbar-input-height| _32px_  | -  |
-| --nut-searchbar-input-width| _100%_  | -  |
-| --nut-searchbar-input-border-radius| _16px_  | -  |
-| --nut-searchbar-input-box-shadow| _0 0 8px 0 rgba(0, 0, 0, 0.04)_  | -  |
-| --nut-searchbar-input-bar-color| _inherit_  | -  |
-| --nut-searchbar-input-bar-placeholder-color| _inherit_  | -  |
+| 名称                                    | 默认值                     |
+| --------------------------------------- | -------------------------- |
+| --nut-searchbar-background| _var(--nut-white)_  |
+| --nut-searchbar-right-out-color| _var(--nut-black)_  |
+| --nut-searchbar-padding| _9px 16px_  |
+| --nut-searchbar-width| _100%_  |
+| --nut-searchbar-input-background| _#f7f7f7_  |
+| --nut-searchbar-input-padding| _0 0 0 13px_  |
+| --nut-searchbar-input-height| _32px_  |
+| --nut-searchbar-input-width| _100%_  |
+| --nut-searchbar-input-border-radius| _16px_  |
+| --nut-searchbar-input-box-shadow| _0 0 8px 0 rgba(0, 0, 0, 0.04)_  |
+| --nut-searchbar-input-bar-color| _inherit_  |
+| --nut-searchbar-input-bar-placeholder-color| _inherit_  |

+ 38 - 38
src/packages/__VUE/searchbar/doc.taro.md

@@ -213,22 +213,22 @@ app.use(Searchbar);
     
     
 | 参数         | 说明                             | 类型   | 默认值           |
 | 参数         | 说明                             | 类型   | 默认值           |
 |--------------|----------------------------------|--------|------------------|
 |--------------|----------------------------------|--------|------------------|
-| v-model	         | 当前输入的值   | Number / String | ''      |
-| label| 搜索框左侧文本 | String | '' |
-| shape | 搜索框形状,可选值为 round | String | square |
-| max-length         | 最大输入长度   | [Number,String] | '9999'      |
-| input-type    | 输入框类型   | String | 'text'      |
-| placeholder        | 输入框默认暗纹  | String | '请输入'   |
-| clearable          | 是否展示清除按钮 | Boolean | true     |
-| clear-icon         | 自定义清除按钮图标 | String | "circle-close"     |
-| background      | 输入框外部背景 | String |   '#fff'   |
-| input-background   | 输入框内部背景 | String |   '#f7f7f7'   |
-| confirm-type   | 键盘右下角按钮的文字,仅在`type='text'`时生效,可选值 `send`:发送、`search`:搜索、`next`:下一个、`go`:前往、`done`:完成 | String |   `done`   |
-| autofocus | 是否自动聚焦 | boolean | false |
-| focus-style | 聚焦时搜索框样式 | Object | - |
-| disabled | 是否禁用输入框 | boolean | false |
-| readonly | 输入框只读 | boolean | false |
-| input-align | 对齐方式,可选`center` `right` | string | `left` |
+| v-model	         | 当前输入的值   | number /| string | `''`      |
+| label| 搜索框左侧文本 | string | `''` |
+| shape | 搜索框形状,可选值为 `square` `round` | string | `square` |
+| max-length         | 最大输入长度   | number /| string | `9999`      |
+| input-type    | 输入框类型   | string | `text`      |
+| placeholder        | 输入框默认暗纹  | string | `请输入`   |
+| clearable          | 是否展示清除按钮 | boolean | `true`     |
+| clear-icon         | 自定义清除按钮图标(默认使用 `@nutui/nutui-icons`)| Object | `CircleClose`    |
+| background      | 输入框外部背景 | string |   `#fff`   |
+| input-background   | 输入框内部背景 | string |   `#f7f7f7`   |
+| confirm-type   | 键盘右下角按钮的文字,仅在`type='text'`时生效可选值 `send`:发送、`search`:搜索、`next`:下一个、`go`:前往、`done`:完成 | string |   `done`   |
+| autofocus | 是否自动聚焦 | boolean | `false` |
+| focus-style | 聚焦时搜索框样式 | Object | `-` |
+| disabled | 是否禁用输入框 | boolean | `false` |
+| readonly | 输入框只读 | boolean | `false` |
+| input-align | 对齐方式,可选 `left` `center` `right` | string | `left` |
 
 
 
 
 
 
@@ -236,14 +236,14 @@ app.use(Searchbar);
 
 
 | 事件名 | 说明           | 回调参数     |
 | 事件名 | 说明           | 回调参数     |
 |--------|----------------|--------------|
 |--------|----------------|--------------|
-| change  | 输入内容时触发 | val, event |
-| focus  | 聚焦时触发 | val, event |
-| blur  | 失焦时触发 | val, event |
-| clear  | 点击清空时触发 | val |
-| search  | 按下 ENTER 键时触发 | val, event |
-| click-input |	点击输入区域时触发	 |	event |
-| click-left-icon |	点击左侧图标时触发 |	val, event |
-| click-right-icon |	点击右侧图标时触发 |	val, event |
+| change  | 输入内容时触发 | `val, event` |
+| focus  | 聚焦时触发 | `val, event` |
+| blur  | 失焦时触发 | `val, event` |
+| clear  | 点击清空时触发 | `val` |
+| search  | 按下 ENTER 键时触发 | `val, event` |
+| click-input |	点击输入区域时触发	 |	`event` |
+| click-left-icon |	点击左侧图标时触发 |	`val, event` |
+| click-right-icon |	点击右侧图标时触发 |	`val, event` |
 
 
 ### Slots
 ### Slots
 
 
@@ -261,17 +261,17 @@ app.use(Searchbar);
 
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-searchbar-background| _var(--nut-white)_  | -  |
-| --nut-searchbar-right-out-color| _var(--nut-black)_  | -  |
-| --nut-searchbar-padding| _9px 16px_  | -  |
-| --nut-searchbar-width| _100%_  | -  |
-| --nut-searchbar-input-background| _#f7f7f7_  | -  |
-| --nut-searchbar-input-padding| _0 0 0 13px_  | -  |
-| --nut-searchbar-input-height| _32px_  | -  |
-| --nut-searchbar-input-width| _100%_  | -  |
-| --nut-searchbar-input-border-radius| _16px_  | -  |
-| --nut-searchbar-input-box-shadow| _0 0 8px 0 rgba(0, 0, 0, 0.04)_  | -  |
-| --nut-searchbar-input-bar-color| _inherit_  | -  |
-| --nut-searchbar-input-bar-placeholder-color| _inherit_  | -  |
+| 名称                                    | 默认值                     | 
+| --------------------------------------- | -------------------------- |
+| --nut-searchbar-background| _var(--nut-white)_  |
+| --nut-searchbar-right-out-color| _var(--nut-black)_  |
+| --nut-searchbar-padding| _9px 16px_  |
+| --nut-searchbar-width| _100%_  |
+| --nut-searchbar-input-background| _#f7f7f7_  |
+| --nut-searchbar-input-padding| _0 0 0 13px_  |
+| --nut-searchbar-input-height| _32px_  |
+| --nut-searchbar-input-width| _100%_  |
+| --nut-searchbar-input-border-radius| _16px_  |
+| --nut-searchbar-input-box-shadow| _0 0 8px 0 rgba(0, 0, 0, 0.04)_  |
+| --nut-searchbar-input-bar-color| _inherit_  |
+| --nut-searchbar-input-bar-placeholder-color| _inherit_  |

+ 10 - 10
src/packages/__VUE/textarea/doc.en-US.md

@@ -87,9 +87,9 @@ export default {
 
 
 | Event | Description                  | Arguments   |
 | Event | Description                  | Arguments   |
 |--------|----------------|-------------|
 |--------|----------------|-------------|
-| change | Triggered when the value of the input box changes | value       |
-| focus  | Triggered when focusing     | event       |
-| blur   | Triggered when out of focus     | {value,event} |
+| change | Triggered when the value of the input box changes | `value`       |
+| focus  | Triggered when focusing     | `event`       |
+| blur   | Triggered when out of focus     | `value,event` |
 
 
 ## Theming
 ## Theming
 
 
@@ -97,13 +97,13 @@ 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).
 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-textarea-font| _var(--nut-font-size-2)_  | -  |
-| --nut-textarea-height| _100px_  | -  |
-| --nut-textarea-limit-color| _var(--nut-text-color)_  | -  |
-| --nut-textarea-text-color| _var(--nut-title-color)_  | -  |
-| --nut-textarea-disabled-color| _var(--nut-disable-color)_  | -  |
+| Name | Default Value |
+| --------------------------------------- | -------------------------- |
+| --nut-textarea-font| _var(--nut-font-size-2)_  |
+| --nut-textarea-height| _100px_  |
+| --nut-textarea-limit-color| _var(--nut-text-color)_  |
+| --nut-textarea-text-color| _var(--nut-title-color)_  |
+| --nut-textarea-disabled-color| _var(--nut-disable-color)_  |
 
 
 
 
 
 

+ 20 - 20
src/packages/__VUE/textarea/doc.md

@@ -71,25 +71,25 @@ export default {
 
 
 | 参数        | 说明                                             | 类型           | 默认值         |
 | 参数        | 说明                                             | 类型           | 默认值         |
 |-------------|--------------------------------------------------|----------------|----------------|
 |-------------|--------------------------------------------------|----------------|----------------|
-| v-model     | 输入值,支持双向绑定                             | String         | -              |
-| placeholder | 设置占位提示文字                                 | String         | `'请输入内容'` |
-| max-length  | 限制最长输入字符                                 | String、Number | -              |
-| rows | textarea的高度,优先级高于autosize属性  `仅支持 H5`                                 | String、Number | `2`            |
-| limit-show  | textarea是否展示输入字符。须配合`max-length`使用 | Boolean        | `false`        |
-| autosize | 是否自适应内容高度,也可传入对象, 如 { maxHeight: 200, minHeight: 100 },单位为px | Boolean 、{maxHeight?: number; minHeight?: number}       | `false`        |
-| text-align  | 文本位置,可选值`left`,`center`,`right`           | String         | `left`         |
-| readonly    | 只读属性                                         | Boolean        | `false`        |
-| disabled    | 禁用属性                                         | Boolean        | `false`        |
-| autofocus   | 自动获取焦点                                     | Boolean        | `false`        |
+| v-model | input value, supports two-way binding | string | `-`|
+| placeholder | Set placeholder prompt text | string | `Please enter content` |
+| max-length | limit the longest input characters | string \| number | `-` |
+| rows | height of textarea, priority is higher than autosize attribute `only supports H5` | string \| number | `2` |
+| limit-show | Whether textarea displays input characters. Must be used with `max-length` | boolean | `false` |
+| autosize | whether to adapt to the height of the content, or to pass in an object, such as `{ maxHeight: 200, minHeight: 100 }`, the unit is `px` | boolean \| {maxHeight?: number; minHeight?: number} | `false` |
+| text-align | text position, optional values `left`, `center`, `right` | string | `left` |
+| readonly | read-only property | boolean | `false` |
+| disabled | disabled attribute | boolean | `false` |
+| autofocus | get focus automatically | boolean | `false` |
 
 
 
 
 ### Events
 ### Events
 
 
 | 名称   | 说明           | 回调参数    |
 | 名称   | 说明           | 回调参数    |
 |--------|----------------|-------------|
 |--------|----------------|-------------|
-| change | 输入框值改变时触发 | value       |
-| focus  | 聚焦时触发     | event       |
-| blur   | 失焦时触发     | {value,event} |
+| change | 输入框值改变时触发 | `value`       |
+| focus  | 聚焦时触发     | `event`       |
+| blur   | 失焦时触发     | `value, event` |
 
 
 ## 主题定制
 ## 主题定制
 
 
@@ -97,13 +97,13 @@ export default {
 
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-textarea-font| _var(--nut-font-size-2)_  | -  |
-| --nut-textarea-height| _100px_  | -  |
-| --nut-textarea-limit-color| _var(--nut-text-color)_  | -  |
-| --nut-textarea-text-color| _var(--nut-title-color)_  | -  |
-| --nut-textarea-disabled-color| _var(--nut-disable-color)_  | -  |
+| 名称                                    | 默认值                     |
+| --------------------------------------- | -------------------------- | 
+| --nut-textarea-font| _var(--nut-font-size-2)_  |
+| --nut-textarea-height| _100px_  |
+| --nut-textarea-limit-color| _var(--nut-text-color)_  |
+| --nut-textarea-text-color| _var(--nut-title-color)_  |
+| --nut-textarea-disabled-color| _var(--nut-disable-color)_  |
 
 
 
 
 
 

+ 20 - 20
src/packages/__VUE/textarea/doc.taro.md

@@ -71,25 +71,25 @@ export default {
 
 
 | 参数        | 说明                                             | 类型           | 默认值         |
 | 参数        | 说明                                             | 类型           | 默认值         |
 |-------------|--------------------------------------------------|----------------|----------------|
 |-------------|--------------------------------------------------|----------------|----------------|
-| v-model     | 输入值,支持双向绑定                             | String         | -              |
-| placeholder | 设置占位提示文字                                 | String         | `'请输入内容'` |
-| max-length  | 限制最长输入字符                                 | String、Number | -              |
-| rows | textarea的高度,优先级高于autosize属性  `仅支持 H5`                                 | String、Number | `2`            |
-| limit-show  | textarea是否展示输入字符。须配合`max-length`使用 | Boolean        | `false`        |
-| autosize | 是否自适应内容高度,也可传入对象, 如 { maxHeight: 200, minHeight: 100 },单位为px | Boolean 、{maxHeight?: number; minHeight?: number}       | `false`        |
-| text-align  | 文本位置,可选值`left`,`center`,`right`           | String         | `left`         |
-| readonly    | 只读属性                                         | Boolean        | `false`        |
-| disabled    | 禁用属性                                         | Boolean        | `false`        |
-| autofocus   | 自动获取焦点                                     | Boolean        | `false`        |
+| v-model     | 输入值,支持双向绑定                             | string         | `-`|
+| placeholder | 设置占位提示文字                                 | string         | `请输入内容` |
+| max-length  | 限制最长输入字符                                 | string \| number | `-`              |
+| rows | textarea的高度,优先级高于autosize属性 `仅支持 H5`         | string \| number | `2`            |
+| limit-show  | textarea是否展示输入字符。须配合`max-length`使用 | boolean        | `false`        |
+| autosize | 是否自适应内容高度,也可传入对象, <br/> 如 `{ maxHeight: 200, minHeight: 100 }`,单位为`px` | boolean \| {maxHeight?: number; minHeight?: number}       | `false`        |
+| text-align  | 文本位置,可选值`left`,`center`,`right`           | string         | `left`         |
+| readonly    | 只读属性                                         | boolean        | `false`        |
+| disabled    | 禁用属性                                         | boolean        | `false`        |
+| autofocus   | 自动获取焦点                                     | boolean        | `false`        |
 
 
 
 
 ### Events
 ### Events
 
 
 | 名称   | 说明           | 回调参数    |
 | 名称   | 说明           | 回调参数    |
 |--------|----------------|-------------|
 |--------|----------------|-------------|
-| change | 输入框值改变时触发 | value       |
-| focus  | 聚焦时触发     | event       |
-| blur   | 失焦时触发     | {value,event} |
+| change | 输入框值改变时触发 | `value`       |
+| focus  | 聚焦时触发     | `event`       |
+| blur   | 失焦时触发     | `value,event` |
 
 
 ## 主题定制
 ## 主题定制
 
 
@@ -97,13 +97,13 @@ export default {
 
 
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。
 
 
-| 名称                                    | 默认值                     | 描述 |
-| --------------------------------------- | -------------------------- | ---- |
-| --nut-textarea-font| _var(--nut-font-size-2)_  | -  |
-| --nut-textarea-height| _100px_  | -  |
-| --nut-textarea-limit-color| _var(--nut-text-color)_  | -  |
-| --nut-textarea-text-color| _var(--nut-title-color)_  | -  |
-| --nut-textarea-disabled-color| _var(--nut-disable-color)_  | -  |
+| 名称                                    | 默认值                     | 
+| --------------------------------------- | -------------------------- | 
+| --nut-textarea-font| _var(--nut-font-size-2)_  |
+| --nut-textarea-height| _100px_  |
+| --nut-textarea-limit-color| _var(--nut-text-color)_  |
+| --nut-textarea-text-color| _var(--nut-title-color)_  |
+| --nut-textarea-disabled-color| _var(--nut-disable-color)_  |