啟用使用者互動

Jetpack Compose 可在 Text 中進行精細的互動。文字選取功能現在更具彈性，並且可以在可組合項的版面配置中完成。文字中的使用者互動與其他可組合項的版面配置不同，因為您無法在一部分 Text 可組合項中新增修飾詞。本頁重點介紹可啟用使用者互動的 API。

選取文字

根據預設，可組合函式無法選取，這表示使用者無法 選取並複製應用程式中的文字如要啟用文字選取功能，請換行 SelectionContainer 可組合函式中的文字元素：

@Composable
fun SelectableText() {
    SelectionContainer {
        Text("This text is selectable")
    }
}
TextSnippets.kt

由使用者選取的簡短文字段落。

您可能需要針對可選取區域的特定部分停用選取功能。待辦 因此，您需要使用 DisableSelection 納入無法選取的部分 可組合函式：

@Composable
fun PartiallySelectableText() {
    SelectionContainer {
        Column {
            Text("This text is selectable")
            Text("This one too")
            Text("This one as well")
            DisableSelection {
                Text("But not this one")
                Text("Neither this one")
            }
            Text("But again, you can select this one")
            Text("And this one too")
        }
    }
}
TextSnippets.kt

較長的文字段落。使用者嘗試選取整個段落，但兩行都套用了 DisableSelection，因此無法選取。

使用 LinkAnnotation 建立可點選的文字段落

如要監聽 Text 上的點擊，您可以新增 clickable 輔助鍵。然而，您可能會想要在網站的某個部分 Text 值，例如附加至特定字詞，以開啟 。在此情況下，您必須使用 LinkAnnotation，也就是 代表文字中可點擊部分的註解。

使用 LinkAnnotation 時，您可以將網址附加至 Text 可組合項的部分，這樣一來只要點選即可自動開啟，如以下程式碼片段所示：

@Composable
fun AnnotatedStringWithLinkSample() {
    // Display multiple links in the text
    Text(
        buildAnnotatedString {
            append("Go to the ")
            withLink(
                LinkAnnotation.Url(
                    "https://developer.android.com/",
                    TextLinkStyles(style = SpanStyle(color = Color.Blue))
                )
            ) {
                append("Android Developers ")
            }
            append("website, and check out the")
            withLink(
                LinkAnnotation.Url(
                    "https://developer.android.com/jetpack/compose",
                    TextLinkStyles(style = SpanStyle(color = Color.Green))
                )
            ) {
                append("Compose guidance")
            }
            append(".")
        }
    )
}
TextSnippets.kt

您也可以設定自訂動作，回應使用者 Text 可組合函式。在下列程式碼片段中，當使用者點選 系統會顯示「Jetpack Compose」連結，並記錄使用者的指標 點按連結：

@Composable
fun AnnotatedStringWithListenerSample() {
    // Display a link in the text and log metrics whenever user clicks on it. In that case we handle
    // the link using openUri method of the LocalUriHandler
    val uriHandler = LocalUriHandler.current
    Text(
        buildAnnotatedString {
            append("Build better apps faster with ")
            val link =
                LinkAnnotation.Url(
                    "https://developer.android.com/jetpack/compose",
                    TextLinkStyles(SpanStyle(color = Color.Blue))
                ) {
                    val url = (it as LinkAnnotation.Url).url
                    // log some metrics
                    uriHandler.openUri(url)
                }
            withLink(link) { append("Jetpack Compose") }
        }
    )
}
TextSnippets.kt