组件功能
用于显示正文文本的组件,支持文本尺寸、粗细、颜色、对齐方式,以及截断、斜体、删除线和可编辑等多种选项。
基础用法
通过设置 value 定义文本内容,size 控制文本大小。
Template 示例:
<Text value="Hello world" size="md" />
效果展示如下:

属性说明
| 属性名 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| value ★ | string |
文本内容 | - |
| size | "xs" | "sm" | "md" | "lg" | "xl" |
文本尺寸 | "md" |
| color | string |
文本颜色 (支持 CSS 颜色值) | - |
| weight | "normal" | "medium" | "semibold" | "bold" |
字体粗细 | "normal" |
| textAlign | "start" | "center" | "end" |
文本对齐方式 | "start" |
| truncate | boolean |
是否截断超出长度的文本 | false |
| maxLines | number |
最大显示行数 | - |
| streaming | boolean |
启用流式传输友好的过渡效果 | false |
| italic | boolean |
是否斜体 | false |
| lineThrough | boolean |
是否显示删除线 | false |
| width | number | string |
文本容器宽度 | - |
| minLines | number |
最小行数 | - |
| editable | false | EditableConfig |
是否可编辑及编辑配置 | false |
注意:
★ 标记为必填属性。
EditableConfig 对象
当 editable 不为 false 时,可配置以下属性:
| 属性名 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| name ★ | string |
表单字段名称 | - |
| autoFocus | boolean |
自动聚焦 | false |
| autoSelect | boolean |
自动选中 | false |
| autoComplete | string |
自动完成属性 | - |
| allowAutofillExtensions | boolean |
允许自动填充扩展 | false |
| pattern | string |
验证正则 | - |
| placeholder | string |
占位符 | - |
| required | boolean |
是否必填 | false |
| disabled | boolean |
是否禁用 | false |
重要说明
-
streaming: 一旦增量更新完成,应将此属性设置为
false。 -
注意:流式动画目前未在基本文本组件中实现,但计划在未来版本中作为可选功能添加。