2.4 KiB
2.4 KiB
Textarea
Demos
Size variants
Available size variants for the ui prop: s/m.
Read-only state
Use the readonly prop to set a textarea to read-only state.
Disabled state
Use the disabled prop to set a textarea to disabled state.
API
Props
| Name | Type | Default | Description |
|---|---|---|---|
ui |
string= |
- | [^ui] |
value |
string |
'' | [^value] |
disabled |
boolean= |
false |
Whether the textarea is disabled. |
readonly |
boolean= |
false |
Whether the textarea is read-only. |
line-number |
boolean |
false |
Whether to show line numbers. |
rows |
`number | string` | - |
placeholder |
string |
- | The placeholder text of the textarea. |
composition |
boolean |
false |
Whether the input process should be aware of composition. |
select-on-focus |
boolean |
false |
Whether to select text content when focused. |
autoresize |
boolean |
false |
Whether the textarea should automatically expand when the content exceeds default height. |
get-length |
function(string): number= |
Used to customize length calculation of the input. |
^^^ui 预设样式。
+++枚举值
| 值 | 描述 |
|---|---|
s |
Small. |
m |
Medium. |
| +++ | |
| ^^^ |
^^^value
:::badges
v-model
:::
文本域的值。 ^^^
事件
| 名称 | 描述 |
|---|---|
change |
[^event-change] |
input |
[^event-input] |
^^^event-change
输入框内容变化时触发,即原生 change 事件触发时。回调参数为 (value, event)。
+++参数详情
| 名称 | 类型 | 描述 |
|---|---|---|
value |
string |
文本域的值。 |
event |
Event |
原生 change 事件对象。 |
| +++ | ||
| ^^^ |
^^^event-input
:::badges
v-model
:::
有效输入时触发,受 composition 属性影响。回调参数为 (value: string),value 为输入框的 value 值。
^^^
此外,Textarea 支持如下的原生事件:
auxclick、click、contextmenu、dblclick、mousedown、mouseenter、mouseleave、mousemove、mouseover、mouseout、mouseup、select、wheel、keydown、keypress、keyup、focus、blur、focusin、focusout。
回调函数的参数都为原生事件对象。