如何在Jetpack Compose中为外部跳转按钮设置Link无障碍角色？

方法1：通过语义修饰符手动设置链接角色 #

Compose的Role枚举虽未提供Link选项，但可通过semantics修饰符直接设置底层无障碍角色为AccessibilityRole.LINK，让TalkBack自动播报“链接”作为角色：

import androidx.compose.ui.semantics.accessibilityRole
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.accessibility.AccessibilityRole

Button(
    onClick = { /* 实现打开浏览器的逻辑 */ }
) {
    Text(text = "在浏览器中打开")
}
.semantics {
    // 将无障碍角色设置为链接
    accessibilityRole = AccessibilityRole.LINK
}

设置完成后，TalkBack会播报：“在浏览器中打开，链接”，完全匹配需求。

方法2：用ClickableText模拟按钮样式（可选） #

如果希望组件更贴近原生链接的无障碍行为，可使用ClickableText并添加按钮外观样式，同时指定链接角色：

import androidx.compose.foundation.text.ClickableText
import androidx.compose.ui.semantics.accessibilityRole
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.accessibility.AccessibilityRole
import androidx.compose.ui.text.AnnotatedString
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material3.MaterialTheme

ClickableText(
    text = AnnotatedString("在浏览器中打开"),
    onClick = { /* 打开浏览器逻辑 */ },
    modifier = Modifier
        .semantics {
            accessibilityRole = AccessibilityRole.LINK
        }
        // 添加按钮样式：内边距、背景、圆角
        .padding(12.dp)
        .background(MaterialTheme.colorScheme.primary)
        .clip(RoundedCornerShape(4.dp))
)

验证方式 #

可通过Android Studio的Accessibility Scanner工具检测，或直接开启TalkBack测试播报内容，确认角色被正确识别为“链接”。

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