本页介绍了如何设置段落文本样式。若要设置段落级样式，您可以配置 textAlign 和 lineHeight 等参数，也可以定义自己的 ParagraphStyle。
设置文本对齐方式
借助 textAlign 参数，您可以在 Text 可组合项的 Surface 区域内设置文本的水平对齐方式。
默认情况下，Text 会根据其内容值选择自然的文字对齐方式：
- 对于从左到右书写的文字，如拉丁语、西里尔文或朝鲜文，向
Text容器的左边缘对齐 - 对于从右到左书写的文字，如阿拉伯语或希伯来语，向
Text容器的右边缘对齐
@Composable
fun CenterText() {
Text(
"Hello World", textAlign = TextAlign.Center, modifier = Modifier.width(150.dp)
)
}
如果您想手动设置 Text 可组合项的文本对齐方式，请分别使用 TextAlign.Start 和 TextAlign.End（而非 TextAlign.Left 和 TextAlign.Right），因为它们会根据首选语言的文本方向解析到 Text 可组合项的右边缘。例如，TextAlign.End 对于法语文字将向右侧对齐，而对于阿拉伯语文字则将向左侧对齐，但无论对于哪种文字，TextAlign.Right 都将向右侧对齐。
在段落中添加多种样式
如需在段落中添加多种样式，可以在 AnnotatedString 中使用 ParagraphStyle，它可以使用任意注解的样式进行注解。一旦使用 ParagraphStyle 标记了一部分文本，该部分就会与其余文本分隔开来，就好像它在开头和末尾添加了换行符一样。
如需详细了解如何在文本中添加多种样式，请参阅在文本中添加多种样式。
AnnotatedString 有一个类型安全的构建器，方便您更轻松地创建：buildAnnotatedString。以下代码段使用 buildAnnotatedString 来设置 ParagraphStyle：
@Composable
fun ParagraphStyle() {
Text(
buildAnnotatedString {
withStyle(style = ParagraphStyle(lineHeight = 30.sp)) {
withStyle(style = SpanStyle(color = Color.Blue)) {
append("Hello\n")
}
withStyle(
style = SpanStyle(
fontWeight = FontWeight.Bold, color = Color.Red
)
) {
append("World\n")
}
append("Compose")
}
}
)
}
调整行高和内边距
includeFontPadding 是一个旧版属性，它根据第一行文字顶部和最后一行文字底部的字体指标添加额外的内边距。
从 Compose BoM 版本 2024.01.01 开始，includeFontPadding 默认设置为 false，这使得默认文本布局与常见设计工具更加一致。
配置 lineHeight 的功能并不新鲜。从 Android Q 就开始提供此功能。您可以使用 lineHeight 参数为 Text 配置 lineHeight，该参数可在每行文本中分布行高。然后，您可以使用新的 LineHeightStyle API 来进一步配置此文本的对齐方式，并移除空格。
为了提高精确度，您可能需要使用文本单位“em”（相对字体大小）而不是“sp”（缩放后的像素）来调整 lineHeight。如需详细了解如何选择合适的文本单位，请参阅 TextUnit。
lineHeight 集合中的文本，并根据需要去除多余的空格。
Text(
text = text,
style = LocalTextStyle.current.merge(
TextStyle(
lineHeight = 2.5.em,
platformStyle = PlatformTextStyle(
includeFontPadding = false
),
lineHeightStyle = LineHeightStyle(
alignment = LineHeightStyle.Alignment.Center,
trim = LineHeightStyle.Trim.None
)
)
)
)
除了调整 lineHeight 之外，您现在还可以使用 LineHeightStyle 实验性 API LineHeightStyle.Alignment 和 LineHeightStyle.Trim（必须将 includeFontPadding 设置为 false 才能运行）进一步居中文本和设置文本样式。Alignment 和 Trim 会使用在文本行之间测量到的空间，以便更合理地将其分配给所有行，包括单行文本和文本块的第一行。
LineHeightStyle.Alignment 定义了如何在行高提供的空间内对齐行。在每行中，您可以将文本与顶部、底部、中心或按比例对齐。然后，LineHeightStyle.Trim 可允许您从文本首行顶部或末行底部移除多余空格，这将通过任何 lineHeight 和 Alignment 调整生成。以下示例展示了当对齐居中时 (LineHeightStyle.Alignment.Center)，多行文本在各种 LineHeightStyle.Trim 配置下的外观。
 |
 |
LineHeightStyle.Trim.None |
LineHeightStyle.Trim.Both |
 |
 |
LineHeightStyle.Trim.FirstLineTop |
LineHeightStyle.Trim.LastLineBottom |
请参阅修复 Compose Text 中的字体内边距问题博文，详细了解此变更的背景信息、includeFontPadding 在 View 系统中的工作原理，以及对 Compose 和新的 LineHeightStyle API 所做的更改。
插入换行符
LineBreak API 定义了将文本拆分为多行时所依据的条件。您可以在 Text 可组合项的 TextStyle 代码块中指定所需的换行类型。预设的换行符类型包括：
Simple- 快速且基本的换行符。建议用于文本输入字段。Heading- 换行，换行规则更宽松。建议用于短文本，例如标题。Paragraph- 更慢、更高质量的换行符以提高可读性。 建议用于大量文本，例如段落。
以下代码段使用 Simple 和 Paragraph 为一长串文本指定换行行为：
TextSample(
samples = mapOf(
"Simple" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Simple
)
)
},
"Paragraph" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Paragraph
)
)
}
)
)
在上面的输出中，请注意，与 Simple 换行行为相比，Paragraph 换行行为生成的结果在视觉上更加均衡。
自定义换行符
您还可以使用 Strategy 参数构建自己的 LineBreak 配置。Strategy 可以是以下任意一项：
Balanced- 尝试平衡文本的线长度，如果启用，还会应用自动断字。建议用于小屏幕（例如手表），以尽可能增加显示的文字量。HighQuality- 优化段落以使文本更易于阅读，包括断字（如果启用）。（应该是除Balanced和Simple以外的所有内容的默认设置。）Simple- 基本快速策略。启用后，系统仅会为本身不适合填满整行的字词使用断字。可用于编辑文本，以避免在输入时更改位置。
以下代码段展示了采用默认设置的段落与采用 Balanced 换行策略、针对小屏幕优化的段落之间的区别：
TextSample(
samples = mapOf(
"Balanced" to {
val smallScreenAdaptedParagraph =
LineBreak.Paragraph.copy(strategy = LineBreak.Strategy.Balanced)
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(200.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = smallScreenAdaptedParagraph
)
)
},
"Default" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(200.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default
)
}
)
)
Balanced 换行策略的段落（顶部）与不使用换行策略的段落。CJK 注意事项
您还可以使用专为 CJK 语言设计的 Strictness 和 WordBreak API 来自定义 LineBreak。有时，这些 API 可能无法以非 CJK 语言显示。总体而言，换行符规则是根据语言区域定义的。
Strictness 使用以下属性描述换行符的严格程度：
Default- 语言区域的默认违反规则。可能对应于Normal或Strict。Loose- 最宽松的规则。适用于短时间排队。Normal- 换行的最常用规则。Strict- 最严格的换行规则。
WordBreak 具有以下属性，用于定义在字词中插入换行符的方式：
Default- 语言区域的默认违反规则。Phrase- 基于短语换行。
以下代码段对日语文本使用了 Strict 严格性和 Phrase 断字设置：
val customTitleLineBreak = LineBreak(
strategy = LineBreak.Strategy.HighQuality,
strictness = LineBreak.Strictness.Strict,
wordBreak = LineBreak.WordBreak.Phrase
)
Text(
text = "あなたに寄り添う最先端のテクノロジー。",
modifier = Modifier.width(250.dp),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = customTitleLineBreak
)
)
Strictness 和 WordBreak 设置格式的文本（顶部）与仅采用 LineBreak.Heading 格式的文本（底部）。将文字分为多行（带连字符）
借助 Hyphens API，您可以为应用添加断字支持。断字是指插入类似短划线的标点符号，以指示某个字词被分为多行文本。启用后，系统会在单词的音节之间添加断字号。
默认情况下，未启用断字功能。如需启用断字功能，请将 Hyphens.Auto 作为参数添加到 TextStyle 块中：
TextSample(
samples = mapOf(
"Hyphens - None" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Paragraph,
hyphens = Hyphens.None
)
)
},
"Hyphens - Auto" to {
Text(
text = SAMPLE_LONG_TEXT,
modifier = Modifier
.width(130.dp)
.border(BorderStroke(1.dp, Color.Gray)),
fontSize = 14.sp,
style = TextStyle.Default.copy(
lineBreak = LineBreak.Paragraph,
hyphens = Hyphens.Auto
)
)
}
)
)
启用后，仅在以下条件下才会进行断字：
- 字词不适合放在一行中。如果您使用
Simple换行策略，则只有在一行短于单个字词时才会出现断字现象。 - 您的设备设置了适当的语言区域，系统会根据系统上存在的字典确定适当的连字符。
为您推荐
- 注意：当 JavaScript 处于关闭状态时，系统会显示链接文字
- 设置文本样式
- Compose 布局基础知识
- Compose 布局中的固有特性测量