TextMeasurer：什么是TextMeasurer以及Compose中的文本测量如何工作

什么是Jetpack Compose中的TextMeasurer？

TextMeasurer — 是来自androidx.compose.ui.text包的一个功能接口，允许在不直接在屏幕上渲染的情况下测量Compose中的文本。它是Compose文本引擎的一部分，在Paragraph API级别工作，该API使用Skia进行渲染。

TextMeasurer的主要目的是预先测量。在Compose中，文本大小通常在Composable已经放置在Layout中后才确定。但有些场景需要在组合前知道文本宽度：例如，决定一行是否适合容器，或根据文本长度计算按钮大小。

TextMeasurer通过提供measure()方法来解决这个问题，该方法接收TextMeasureRequest（文本、样式、约束）并返回TextLayoutResult（度量、行、字符）。这使开发人员能够同步获取有关文本的所有数据，没有一帧延迟。

当文本大小影响父组件大小时、创建动画文本过渡时或实现文本与其他元素相邻的自定义Layout时，请使用TextMeasurer。

TextMeasurer如何工作

TextMeasurer API由两个关键实体组成：rememberTextMeasurer()（创建实例）和measure()（开始测量）。实例在整个组件的生命周期内创建一次，并重复用于所有测量。

val textMeasurer = rememberTextMeasurer()

val result = textMeasurer.measure(
    text = "Hello, Compose!",
    style = MaterialTheme.typography.bodyLarge,
    constraints = Constraints(maxWidth = 200, maxHeight = 50)
)

// 结果宽度、结果高度、行数

constraints参数定义了文本必须适应的最大宽度和高度。如果文本在宽度上放不下，它将被移到下一行。测量结果包含TextLayoutResult，在其中您可以获取行数、每个字符的位置、每行的宽度和文本总大小。

TextMeasurer在UI线程中同步工作，不会引起重组。然而，频繁测量不同样式的文本可能会产生负载——因此实例通过remember创建并重复使用。

测量单行文本

最简单的场景——测量单行文本的宽度以确定父容器的大小。例如，宽度取决于标签长度的按钮。

val textMeasurer = rememberTextMeasurer()
var label by remember { mutableStateOf("Submit") }

val textResult = remember(label) {
    textMeasurer.measure(
        text = label,
        style = MaterialTheme.typography.labelLarge,
        constraints = Constraints(maxWidth = 1000, maxHeight = 100)
    )
}

Box(
    modifier = Modifier
        .width(textResult.size.width.dp)
        .height(40.dp)
        .background(Color.Blue)
        .clickable { onClick() }
) {
    Text(text = label, style = MaterialTheme.typography.labelLarge)
}

在这个例子中，remember(label)确保测量只在文本更改时重新启动。Constraints设置了一个较大的maxWidth（1000）以防止换行——实际约束将等于文本宽度。Box的宽度设置为测量到的文本宽度，产生"文本大小适配按钮"的效果。

注意：结果中的宽度需要通过.dp转换为dp，因为TextMeasurer以像素为单位返回大小，而Modifier.width期望Dp。为了精确，请使用density和LocalDensity.current。

测量多行文本

对于多行文本，TextMeasurer不仅允许确定总高度，还可以确定行数和段落中每个字符的位置。这在创建自定义文本字段、聊天或编辑器时是必需的。

用于多行文本的TextLayoutResult的主要属性：lineCount（行数）、getLineTop(index)（行开始的Y坐标）、getLineBottom(index)（行结束的Y坐标）、getLineWidth(index)（行宽度）。通过组合它们，您可以相对于文本行精确定位界面元素。

val textMeasurer = rememberTextMeasurer()
val result = textMeasurer.measure(
    text = "Long multiline text that needs to be measured before layout",
    style = MaterialTheme.typography.bodyMedium,
    constraints = Constraints(maxWidth = 150, maxHeight = 300)
)

val linesCount = result.lineCount
val firstLineWidth = result.getLineWidth(0)
val totalHeight = result.size.height

getLineWidth(lineIndex)方法返回指定行的像素宽度。如果行未达到容器边界，则可能小于maxWidth。知道每行的宽度后，您可以手动实现两端对齐效果或将内联元素放在短行旁边。

要获取特定字符的位置，请使用getBoundingBox(offset)，它返回带有left、top、right、bottom坐标的Rect。这对于在自定义文本字段中定位光标或通过动画突出显示文本范围很有用。

自定义组件中的TextMeasurer

TextMeasurer最强大的使用场景——自定义Layout组件，其中文本与其他元素相邻，并且它们的尺寸相互依赖。例如，"图标+文本"小部件，其中图标应相对于文本的第一行居中，而不是整个块。

在标准Row中，图标根据整个Row的高度居中，当文本占据3行而图标只有一行时看起来很不自然。使用TextMeasurer，您可以测量第一行并相对于它精确对齐图标。

val textMeasurer = rememberTextMeasurer()

Layout(
    content = {
        Icon(imageVector = Icons.Default.Star, contentDescription = null)
        Text(text = "多行文本在这里")
    },
    measurePolicy = { measurables, constraints ->
        val textMeasurable = measurables[1]
        val textPlaceable = textMeasurable.measure(constraints)
        val iconPlaceable = measurables[0].measure(constraints)

        val firstLineHeight = textMeasurer.measure(
            text = "Sample",
            style = MaterialTheme.typography.bodyMedium,
            constraints = Constraints(maxWidth = 2000, maxHeight = 100)
        ).size.height

        layout(width = textPlaceable.width + iconPlaceable.width,
               height = maxOf(textPlaceable.height, iconPlaceable.height)) {
            iconPlaceable.placeRelative(0, (firstLineHeight - iconPlaceable.height) / 2)
            textPlaceable.placeRelative(iconPlaceable.width, 0)
        }
    }
)

在这个例子中，通过TextMeasurer对第一行的测量确定了图标的位置。如果没有TextMeasurer，图标将在多行文本的整个高度上居中，这在视觉上是不正确的。这种模式广泛应用于聊天、联系人列表和信息卡片中。

性能提示

TextMeasurer——是在UI线程中工作的同步API。过度使用时，可能会导致帧率下降，特别是在弱设备上测量大量文本时。

第一条规则——缓存结果。始终将measure()调用包装在具有文本和样式依赖关系的remember中。切勿在CompositionLocal内部或重组热路径中调用measure()。

第二条规则——限制maxWidth和maxHeight。如果设置maxWidth = Constraints.Infinity，TextMeasurer将无法换行，文本将超出屏幕。始终传递现实的约束，特别是对于多行文本。

第三——避免使用相同参数重复测量。如果文本和样式没有改变，measure()的结果将是相同的。将测量与Deferred或LaunchedEffect结合用于异步场景。