mirror of
https://github.com/tusen-ai/naive-ui.git
synced 2025-01-24 12:45:18 +08:00
65 lines
1.8 KiB
Markdown
65 lines
1.8 KiB
Markdown
# Input
|
|
Many years ago, people used punched card to input.
|
|
|
|
<n-alert title="Caveat" type="warning">`n-input` is a controlled component. If you don't update its `value` its value will never change. (`v-model:value` doesn't matter.)</n-alert>
|
|
|
|
## Demos
|
|
```demo
|
|
basic
|
|
size
|
|
round
|
|
icon
|
|
password
|
|
disabled
|
|
clearable
|
|
autosize
|
|
pair
|
|
input-group
|
|
passively-activated
|
|
```
|
|
|
|
## Props
|
|
### Input Props
|
|
|Name|Type|Default|Description|
|
|
|-|-|-|-|
|
|
|autofocus|`boolean`|`false`||
|
|
|autosize|`boolean \| { minRows?: number, maxRows?: number }`|`false`||
|
|
|clearable|`boolean`|`false`||
|
|
|disabled|`boolean`|`false`||
|
|
|maxlength|`number`|`undefined`||
|
|
|minlength|`number`|`undefined`||
|
|
|pair|`boolean`|`false`|Whether to input pairwise value.|
|
|
|passively-activated|`boolean`|`false`||
|
|
|placeholder|`string \| [string, string]`|`undefined`|Placeholder of input. When `pair` is `true`, placeholder is an array.|
|
|
|readonly|`boolean`|`false`||
|
|
|round|`boolean`|`false`||
|
|
|rows|`number`|`3`||
|
|
|separator|`string`|`undefined`|The separator bewteen pairwise inputs.|
|
|
|size|`'small' \| 'medium' \| 'large'`|`'medium'`||
|
|
|theme|`'light' \| 'dark' \| string`|`undefined`||
|
|
|type|`'text' \| 'password' \| 'textarea'`|`'text'`||
|
|
|value|`string \| [string, string]`|`null`|Value of input. When `pair` is `true`, `value` is an array.|
|
|
|on-blur|`() => any`|`undefined`||
|
|
|on-change|`(value: string \| [string, string]) => any`|`undefined`||
|
|
|on-clear|`() => any`|`undefined`||
|
|
|on-focus|`() => any`|`undefined`||
|
|
|on-update:value|`(value: string \| [string, string]) => any`|`undefined`||
|
|
|
|
|
|
## Slots
|
|
### Input Slots
|
|
|Name|Parameters|Description|
|
|
|-|-|-|
|
|
|prefix|`()`||
|
|
|suffix|`()`||
|
|
|
|
### Input Group Slots
|
|
|Name|Parameters|Description|
|
|
|-|-|-|
|
|
|default|`()`||
|
|
|
|
### Input Group Label Slots
|
|
|Name|Parameters|Description|
|
|
|-|-|-|
|
|
|default|`()`||
|