Text 文本
uni-appH5微信小程序App
跨端文本展示组件,支持语义变体、尺寸、字重和单行省略。
何时使用
界面中的普通文本:正文、辅助说明、状态提示文案。
何时不使用
页面/区块标题用 Title;可点击的跳转文本用链接组件。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
variant | string:'body' | 'secondary' | 'caption' | 'danger' | 'success' | "body" | 文本变体:body 正文、secondary 次要、caption 说明、danger 危险、success 成功 |
size | string:'sm' | 'md' | 'lg' | "md" | 字号,对应 13/14/16px token |
weight | string:'regular' | 'medium' | 'semibold' | 'bold' | "regular" | 字重 |
truncate | boolean | false | 单行省略,超出部分显示省略号 |
tag | string | "span" | 渲染的 HTML 标签,如 span/p/div |
Slots
| 名称 | 说明 |
|---|---|
default | 文本内容 |
示例
语义变体
vue
<Text>正文文本</Text>
<Text variant="secondary" style="margin-left:8px">次要文本</Text>
<Text variant="caption" style="margin-left:8px">说明文本</Text>
<Text variant="success" style="margin-left:8px">成功</Text>
<Text variant="danger" style="margin-left:8px">危险</Text>字号与字重
vue
<Text size="sm">小号 SM</Text>
<Text size="md" weight="medium" style="margin-left:8px">中号加粗</Text>
<Text size="lg" weight="bold" style="margin-left:8px">大号特粗</Text>单行省略
vue
<Text truncate style="width:180px">这段文字超出了容器宽度,会被截断并显示省略号</Text>渲染标签
vue
<Text tag="div" variant="secondary">以 div 渲染,独占一行</Text>
<Text tag="span" variant="primary">以 span 渲染,行内排列</Text>