2.4 KiB
2.4 KiB
Textarea 文本域
示例
尺寸
可选的 ui 属性值：s / m。
只读状态
设置 readonly 来使文本域处于只读状态。
禁用状态
设置 disabled 来使文本域处于禁用状态。
API
属性
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
ui |
string= |
- | [^ui] |
value |
string |
'' | [^value] |
disabled |
boolean= |
false |
文本域是否为禁用状态。 |
readonly |
boolean= |
false |
文本域是否为只读状态。 |
line-number |
boolean |
false |
是否显示行号。 |
rows |
`number | string` | - |
placeholder |
string |
- | 输入占位符。 |
composition |
boolean |
false |
是否感知输入法输入过程的值。 |
select-on-focus |
boolean |
false |
聚焦时是否自动选中文本域文本。 |
autoresize |
boolean |
false |
高度是否会被内容撑开。 |
get-length |
function(string): number= |
自定义的字符长度计算函数。 |
^^^ui 预设样式。
+++枚举值
| 值 | 描述 |
|---|---|
s |
小尺寸样式。 |
m |
中尺寸样式。 |
| +++ | |
| ^^^ |
^^^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。
回调函数的参数都为原生事件对象。