Jetpack Compose中硬件键盘焦点无法落在注解字符串超链接上

你当前的实现把整个Text组件设为可焦点元素，导致硬件键盘只能聚焦整个文本块，无法识别内部的超链接作为独立的交互目标。同时代码只处理了鼠标/触摸点击事件，没有为每个超链接绑定独立的焦点逻辑和键盘触发交互（比如Enter键打开链接），所以键盘导航时焦点无法落到单个超链接上。

我们可以通过TextLayoutResult获取每个超链接的文本边界，在Text上层叠加透明的可焦点Box，让每个链接成为独立的可交互、可聚焦元素，同时支持键盘事件触发跳转。

修改后的完整代码：

@Composable
fun HyperlinkText(
    fullText: String,
    linkTexts: List<String>,
    linkUris: List<String>,
    linkTextColor: Color,
    textColor: Color,
    typography: Typography = MaterialTheme.typography
) {
    // 预存每个链接的索引范围和对应URI，过滤无效链接
    val linkInfos = remember(fullText, linkTexts, linkUris) {
        linkTexts.mapIndexed { index, linkText ->
            val start = fullText.indexOf(linkText)
            if (start == -1) null else {
                val end = start + linkText.length
                if (end > fullText.length) null else {
                    LinkInfo(start, end, linkUris.getOrNull(index) ?: "")
                }
            }
        }.filterNotNull()
    }

    // 构建带样式和注解的字符串
    val annotatedString = remember(linkInfos, fullText, linkTextColor) {
        buildAnnotatedString {
            append(fullText)
            linkInfos.forEach { info ->
                addStyle(
                    SpanStyle(color = linkTextColor),
                    info.start,
                    info.end
                )
                addStringAnnotation(
                    tag = "ANNOTATION_URL",
                    annotation = info.uri,
                    start = info.start,
                    end = info.end
                )
            }
        }
    }

    val uriHandler = LocalUriHandler.current
    var textLayoutResult by remember { mutableStateOf<TextLayoutResult?>(null) }

    Box {
        Text(
            text = annotatedString,
            style = typography.bodyMedium.copy(color = textColor),
            onTextLayout = { textLayoutResult = it }
        )

        // 为每个链接生成透明可焦点Box
        textLayoutResult?.let { layoutResult ->
            linkInfos.forEach { linkInfo ->
                // 获取链接在文本内的边界坐标
                val boundingBox = layoutResult.getBoundingBox(linkInfo.start)
                val focusRequester = remember { FocusRequester() }

                Box(
                    modifier = Modifier
                        .offset(x = boundingBox.left.dp, y = boundingBox.top.dp)
                        .size(
                            width = (boundingBox.right - boundingBox.left).dp,
                            height = (boundingBox.bottom - boundingBox.top).dp
                        )
                        .focusRequester(focusRequester)
                        .focusable()
                        // 焦点状态变化时可添加样式反馈，比如下划线
                        .onFocusChanged { state ->
                            // 示例：可根据state.isFocused更新链接样式
                        }
                        .pointerInput(Unit) {
                            detectTapGestures {
                                uriHandler.openUri(linkInfo.uri)
                            }
                        }
                        // 处理键盘Enter键触发跳转
                        .onKeyEvent { event ->
                            if (event.type == KeyEventType.KeyDown && event.key == Key.Enter) {
                                uriHandler.openUri(linkInfo.uri)
                                true
                            } else false
                        }
                )
            }
        }
    }
}

// 存储链接的索引范围和URI数据类
data class LinkInfo(val start: Int, val end: Int, val uri: String)

• 独立焦点节点：每个超链接对应一个透明Box，通过focusable()和focusRequester让硬件键盘可以单独聚焦每个链接。
• 键盘交互支持：添加onKeyEvent监听Enter键，触发链接跳转，完善键盘导航的交互逻辑。
• 精准位置匹配：利用TextLayoutResult.getBoundingBox获取链接的文本边界，让透明Box精准覆盖链接区域，保证点击和聚焦的准确性。
• 状态缓存优化：用remember缓存链接信息和布局结果，减少不必要的组件重组。

• 可以为聚焦状态的链接添加视觉反馈（比如下划线、颜色加深），提升键盘导航的易用性。
• 如果存在重复的链接文本，可修改代码遍历所有匹配项（当前只取第一个匹配）。
• 测试文本换行、不同屏幕尺寸下的链接位置，确保边界计算准确。

内容的提问来源于stack exchange，提问作者Sarfaraz