Jetpack Compose中LinkAnnotation的语义支持问题求助

针对你遇到的LinkAnnotation无法被测试框架和屏幕阅读器正确识别的问题，你可以通过为每个链接区域单独添加语义注解，并结合Text组件的手势处理来解决，完全不需要依赖已弃用的ClickableText。

实现步骤 #

1. 为每个链接区域添加语义标记
   在构建AnnotatedString时，使用addSemantics方法为每个链接片段单独配置语义属性，包括角色（Role.Link）、点击回调和内容描述，确保屏幕阅读器能识别为可交互链接，同时测试框架能捕获这些语义节点。

2. 处理文本的点击事件
   通过Modifier.pointerInput监听点击手势，将点击坐标转换为文本位置，找到对应位置的语义注解并触发点击逻辑。

完整代码示例 #

@Composable
fun MultiLinkText() {
    val annotatedText = buildAnnotatedString {
        append("请访问")
        
        // 第一个链接：Google
        val googleLinkStart = length
        append("Google")
        val googleLinkEnd = length
        addSemantics(
            start = googleLinkStart,
            end = googleLinkEnd
        ) {
            role = Role.Link
            onClick(label = "打开Google链接") {
                // 替换为实际的链接跳转逻辑
                println("跳转至Google")
                true
            }
            contentDescription = "链接到Google"
        }

        append("和")
        
        // 第二个链接：GitHub
        val githubLinkStart = length
        append("GitHub")
        val githubLinkEnd = length
        addSemantics(
            start = githubLinkStart,
            end = githubLinkEnd
        ) {
            role = Role.Link
            onClick(label = "打开GitHub链接") {
                // 替换为实际的链接跳转逻辑
                println("跳转至GitHub")
                true
            }
            contentDescription = "链接到GitHub"
        }
    }

    Text(
        text = annotatedText,
        modifier = Modifier
            .pointerInput(Unit) {
                detectTapGestures { tapOffset ->
                    // 将点击坐标转换为文本偏移量
                    val textOffset = OffsetPositionMapping.identity().toOffset(tapOffset)
                    // 触发对应位置的链接点击逻辑
                    annotatedText.getSemanticsAnnotationsAt(textOffset).forEach { annotation ->
                        annotation.properties.onClick?.invoke()
                    }
                }
            }
            .padding(16.dp),
        style = TextStyle(
            color = Color.Black,
            // 可选：为链接添加下划线区分
            spanStyle = SpanStyle(textDecoration = TextDecoration.Underline)
        )
    )
}

关键说明 #

• 语义适配：每个链接的语义注解会被屏幕阅读器识别为可点击的链接元素，用户可以通过屏幕阅读器的链接导航功能单独触发每个链接。
• 测试支持：在UI测试中，你可以通过语义属性定位并点击特定链接，示例代码如下：

  // 测试点击Google链接
  composeTestRule.onNode(
      hasRole(Role.Link) and hasContentDescription("链接到Google")
  ).performClick()
  

• 样式自定义：你可以通过SpanStyle为链接添加下划线、修改颜色等样式，提升视觉区分度。

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