2.3 KiB
2.3 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. |
^^^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
。
回调函数的参数都为原生事件对象。