啟用使用者互動

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

選取文字

根據預設，可組合項是無法選取的，也就是說，使用者無法選取及複製應用程式中的文字。如要啟用文字選取功能，請使用 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 a link in the text
    Text(
        buildAnnotatedString {
            append("Build better apps faster with ")
            withLink(
                LinkAnnotation.Url(
                    "https://developer.android.com/jetpack/compose",
                    TextLinkStyles(style = SpanStyle(color = Color.Blue))
                )
            ) {
                append("Jetpack Compose")
            }
        }
    )
}
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