跳到主要内容

Text 文本 ​

uni-appH5微信小程序App

跨端文本展示组件,支持语义变体、尺寸、字重和单行省略。

何时使用 ​

界面中的普通文本:正文、辅助说明、状态提示文案。

何时不使用 ​

页面/区块标题用 Title;可点击的跳转文本用链接组件。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Text 文本 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
variantstring:'body' | 'secondary' | 'caption' | 'danger' | 'success'"body"文本变体:body 正文、secondary 次要、caption 说明、danger 危险、success 成功
sizestring:'sm' | 'md' | 'lg'"md"字号,对应 13/14/16px token
weightstring:'regular' | 'medium' | 'semibold' | 'bold'"regular"字重
truncatebooleanfalse单行省略,超出部分显示省略号
tagstring"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>