Nutzerinteraktionen aktivieren

Jetpack Compose ermöglicht detaillierte Interaktivität in Text. Textauswahl ist jetzt flexibler und kann für zusammensetzbare Layouts verwendet werden. Nutzerinteraktionen sich von anderen zusammensetzbaren Layouts unterscheiden, da Sie keinen Modifizierer Teil einer zusammensetzbaren Text-Funktion. Auf dieser Seite werden die APIs vorgestellt. die Interaktionen der Nutzer ermöglichen.

Text auswählen

Standardmäßig sind zusammensetzbare Funktionen nicht auswählbar, d. h. Nutzer können Text aus Ihrer App auswählen und kopieren. Um die Textauswahl zu aktivieren, fügen Sie den Zeilenumbruch ein mit einer zusammensetzbaren Funktion SelectionContainer auf:

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

Sie können die Auswahl für bestimmte Bereiche eines auswählbaren Bereichs deaktivieren. Aufgabe Daher müssen Sie den nicht auswählbaren Teil mit einem DisableSelection-Zeichen zusammensetzbar:

@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

Mit LinkAnnotation anklickbare Textabschnitte erstellen

Um Klicks auf Text zu erfassen, können Sie clickable hinzufügen. Modifikator. Es kann jedoch sinnvoll sein, einem bestimmten Teil des den Wert Text, z. B. eine URL, die an ein bestimmtes Wort angehängt ist und in einem Browser. In solchen Fällen müssen Sie ein LinkAnnotation verwenden. Eine Anmerkung, die einen anklickbaren Teil des Textes darstellt.

Mit LinkAnnotation können Sie eine URL an einen Teil einer zusammensetzbaren Text-Funktion anhängen die nach einem Klick automatisch geöffnet wird, wie im folgenden Snippet gezeigt:

@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

Sie können auch eine benutzerdefinierte Aktion konfigurieren, die als Reaktion auf den Klick eines Nutzers auf einen Teil der die zusammensetzbare Funktion Text. Wenn der Nutzer im folgenden Snippet auf „Jetpack Compose“. Ein Link wird angezeigt und die Messwerte werden protokolliert, wenn der Nutzer klickt auf den Link:

@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