Text 文本

文本用于展示文字内容，是页面中最基础的展示组件。mu-text 在原生文本能力之上提供类型、尺寸、截断、装饰与按压反馈等配置。

小程序	APP	Web
✓	✓	✓

实例

以下按属性分别说明 mu-text 的用法，可按需组合。

最简用法只需传入文本内容。

<template>
  <mu-text>这是一段普通文本</mu-text>
</template>

类型与尺寸

通过 type 与 size 控制文字的视觉层级。

<mu-text type="primary" :size="32">强调文本</mu-text>

截断

超出指定行数时截断，配合 truncated 生效。

<mu-text :max-lines="2" truncated>超过两行的内容将被截断显示</mu-text>

装饰线

通过 decoration 添加装饰线，并可用 decoration-color 指定颜色。

<mu-text decoration="underline" decoration-color="var(--mu-color-primary)">带下划线的文本</mu-text>

富文本

需要渲染富文本时，将 rich 置为 true 并通过 nodes 传入内容。

<mu-text :rich="true" nodes="<b>加粗</b>与<i>斜体</i>" />

属性

全部属性均可选，未传入时使用默认值；默认值列为 - 表示空字符串。

参考

平台属性与行为可参考 uni-app x Text 组件。

属性名称	说明	类型	默认值
type	文本类型	string	default
size	文字大小，数字按像素处理，也可传入带单位的字符串	string | number	default
underline	是否显示下划线	boolean	false
rich	是否将 nodes 解析为富文本	boolean	false
nodes	富文本节点内容，rich 为 true 时生效	string	-
mode	文本渲染模式	string	web
selectable	是否允许长按选择文本	boolean	false
space	连续空格的处理方式	string	-
decode	是否解码文本中的实体字符	boolean	false
userSelect	是否允许用户选择文本	boolean	false
maxLines	最大显示行数，0 表示不限制	number	0
hoverClass	按压时附加的类名	string	none
hoverStopPropagation	按压时是否阻止事件冒泡	boolean	false
hoverStartTime	按压触发 hover 的延迟时间，单位为毫秒	number	50
hoverStayTime	按压结束后保持 hover 的时间，单位为毫秒	number	400
truncated	是否截断超出内容	boolean	false
lineClamp	限制显示的行数，0 表示不限制	number	0
decoration	文本装饰类型	string	none
decorationColor	装饰线颜色	string	-
customClass	自定义类名，附加在文本根节点上以覆盖默认样式	string	-
customStyle	自定义行内样式，直接作用于文本根节点	any	-

事件

组件支持以下事件。

事件名	说明	回调参数
click	点击文本时触发	event: UniEvent