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仅测量文本布局,不处理实际渲染或交互;

相关推荐
alexhilton4 小时前
MVI 让屏幕一次只有一个状态
android·kotlin·android jetpack
小七在进步8 小时前
string的实现(1)
c++·笔记·visual studio
二流小码农10 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
保利威视频SaaS小张11 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
阿杰m12 小时前
Android源码第十七章:PowerManager 与后台任务——锁屏后怎么跑?
android
JMchen12312 小时前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup
2601_9679801112 小时前
python+appium自动化测试如何控制App的启动和退出
android·自动化测试·python·appium·设备调试
lcj251113 小时前
[C++] C++11
开发语言·c++·笔记
booboosui13 小时前
不写安装器:点一下就往对话里塞 152 个字符
android
一条破秋裤14 小时前
【1117】【内存资源管控】【笔记】
android·笔记