Textarea 多行文本框
显示一个多行文本框。高度随内容增长(min-h-16),可用 maxHeight 限制。
基础用法
网页近似预览,真机效果以 HarmonyOS 渲染为准。
字数统计
showCount 在角落显示 长度/最大长度。
网页近似预览,真机效果以 HarmonyOS 渲染为准。
API
从组件库源码中的 @Param / @Event / @BuilderParam 声明自动提取。
STextarea
shadcn-vue 的 Textarea:在原生 TextArea 上应用 min-h-16 w-full rounded-md border px-3 py-2 text-sm field-sizing-content——它会随内容增高(可用 maxHeight 限制)。
modifier 用于设置内部 TextArea 的样式。
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
value!! | string | undefined | undefined | 受控值(配合 !! 使用)。留空则为非受控。 |
defaultValue | string | '' | |
placeholder | ResourceStr | '' | |
invalid | boolean | false | |
disabled | boolean | false | |
maxLength | number | undefined | undefined | |
maxHeight | number | undefined | undefined | 自动增高的高度上限,单位 vp;超出后滚动。 |
showCount | boolean | false | 右下角的字数统计(length/maxLength)。 |
label | string | undefined | undefined | 没有可见标签时使用的无障碍名称。 |
modifier | AttributeModifier<TextAreaAttribute> | new SparkNoopModifier<TextAreaAttribute>() | |
tokens | InputTokens | {} | 实例级令牌覆盖(与主题的 --input-* 令牌共享),参见 {@link InputTokens}。 |
| 事件 | 类型 | 默认值 | 说明 |
|---|---|---|---|
onValueChange | (v: string) => void | () => { } |