Compose笔记(五十一)--rememberTextMeasurer

这一节主要了解一下Compose中的rememberTextMeasurer,在Jetpack Compose开发中,rememberTextMeasurer是用于测量文本尺寸的工具,它可以帮助我们在不实际绘制文本的情况下,获取文本的宽度、高度、行数等信息。

API

measure(text: AnnotatedString, style: TextStyle, constraints: Constraints):测量文本尺寸,返回TextLayoutResult;

TextLayoutResult:包含文本测量结果,如size(宽高)、lineCount(行数)、getLineEnd()(每行结束索引)等;
场景

文本尺寸预测量:在不渲染文本的情况下获取宽高、行数等信息,为布局决策提供依据

动态布局适配:根据容器大小自动调整文本属性(如字体大小、行数)

交互逻辑支持:实现文本截断、展开 / 收起等依赖文本尺寸的交互功能

栗子:

Kotlin 复制代码
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.platform.LocalDensity
import androidx.compose.ui.text.AnnotatedString
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.rememberTextMeasurer
import androidx.compose.ui.unit.Constraints
import androidx.compose.ui.unit.Dp
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp

@Composable
fun TestDemo() {
    val density = LocalDensity.current
    val textMeasurer = rememberTextMeasurer()
    val containerWidth: Dp = 250.dp 
    val targetText = "使用二分法快速找到适合容器的字体大小......"

   
    val suitableFontSize = remember(targetText, containerWidth, density) {
        val containerWidthPx = with(density) { containerWidth.roundToPx() }
        var minSize = 8.sp    
        var maxSize = 30.sp   
        var bestSize = minSize 

    
        repeat(10) {

            val midSize = ((minSize.value + maxSize.value) / 2).sp 
            val textLayoutResult = textMeasurer.measure(
                text = AnnotatedString(targetText),
                style = TextStyle(fontSize = midSize),
                constraints = Constraints(maxWidth = containerWidthPx)
            )

            if (textLayoutResult.size.width <= containerWidthPx) {            
                bestSize = midSize
                minSize = midSize
            } else {    
                maxSize = midSize
            }
        }
        bestSize
    }

    Box(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp)
    ) {
        Text(
            text = targetText,
            style = TextStyle(
                fontSize = suitableFontSize,
                color = Color.Black,
                letterSpacing = 0.5.sp
            ),
            modifier = Modifier.padding(8.dp)
        )
    }
}
Kotlin 复制代码
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.platform.LocalDensity
import androidx.compose.ui.text.AnnotatedString
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.Constraints
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.rememberTextMeasurer
import androidx.compose.ui.text.style.LineBreak
import androidx.compose.ui.unit.Dp

@Composable
fun TextExample() {
    val density = LocalDensity.current
    val textMeasurer = rememberTextMeasurer()
    val maxDisplayLines = 2
    val containerWidth: Dp = 300.dp
    val fullText = "这是一段较长的文本内容,用于演示文本展开和收起功能。" +
            "当文本内容超过指定的最大行数时,会显示「展开」按钮;" +
            "点击后查看全部内容,再次点击则「收起」回到指定行数。"

    val textLayoutResult = remember(fullText, containerWidth, density) {
        val containerWidthPx = with(density) { containerWidth.roundToPx() }

        textMeasurer.measure(
            text = AnnotatedString(fullText),
            style = TextStyle(
                fontSize = 16.sp,
                color = Color.Black,
                lineHeight = 24.sp,
                lineBreak = LineBreak.Paragraph,
            ),
            constraints = Constraints(maxWidth = containerWidthPx)
        )
    }

    val needExpandButton = textLayoutResult.lineCount > maxDisplayLines
    var isExpanded by remember { mutableStateOf(false) }

    Box(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp)
    ) {
        Text(
            text = fullText,
            style = TextStyle(
                fontSize = 16.sp,
                color = Color.Black,
                lineHeight = 24.sp
            ),
            maxLines = if (isExpanded) Int.MAX_VALUE else maxDisplayLines,
            overflow = if (needExpandButton && !isExpanded) TextOverflow.Ellipsis else TextOverflow.Visible,
            modifier = Modifier.fillMaxWidth()
        )

        if (needExpandButton) {
            Button(
                onClick = { isExpanded = !isExpanded },
                modifier = Modifier
                    .align(Alignment.BottomEnd)
                    .padding(top = 8.dp)
            ) {
                Text(if (isExpanded) "收起" else "展开")
            }
        }
    }
}

注意

1.避免重复创建TextMeasurer;

2.性能优化:在滚动列表或动画中频繁调用measure()可能导致卡顿,避免频繁测量;

3.TextMeasurer仅测量文本布局,不处理实际渲染或交互;

相关推荐
能不能别报错2 小时前
K8s学习笔记(十) Deployment 副本控制器
笔记·学习·kubernetes
阿蓝8583 小时前
Android代码架构
android
RaLi和夕4 小时前
嵌入式学习笔记4.STM32中断系统及外部中断EXTI
笔记·stm32·单片机·学习
yjx233324 小时前
《应用密码学》——基本协议(笔记)
笔记·密码学
蒙奇D索大5 小时前
【数据结构】数据结构秘籍:如何衡量“查找”的快慢?ASL是关键!
数据结构·笔记·学习·考研
蒙奇D索大5 小时前
【数据结构】考研重点掌握:顺序查找算法实现与ASL计算详解
数据结构·笔记·学习·考研·算法·改行学it
能不能别报错6 小时前
K8s学习笔记(十一) service
笔记·学习·kubernetes
悠哉悠哉愿意6 小时前
【ROS2学习笔记】服务
开发语言·笔记·学习·ros2
东方芷兰9 小时前
LLM 笔记 —— 01 大型语言模型修炼史(Self-supervised Learning、Supervised Learning、RLHF)
人工智能·笔记·神经网络·语言模型·自然语言处理·transformer