组件功能

用于显示正文文本的组件,支持文本尺寸、粗细、颜色、对齐方式,以及截断、斜体、删除线和可编辑等多种选项。

基础用法

通过设置 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

  • 注意:流式动画目前未在基本文本组件中实现,但计划在未来版本中作为可选功能添加。