Jetpack Compose обеспечивает детальную интерактивность в Text
. Выбор текста теперь стал более гибким и его можно выполнять в компонуемых макетах. Взаимодействие с пользователем в тексте отличается от других составных макетов, поскольку вы не можете добавить модификатор к части составного Text
. На этой странице представлены API, обеспечивающие взаимодействие с пользователем.
Выбрать текст
По умолчанию составные элементы недоступны для выбора, а это означает, что пользователи не могут выбирать и копировать текст из вашего приложения. Чтобы включить выделение текста, оберните текстовые элементы составным SelectionContainer
:
@Composable fun SelectableText() { SelectionContainer { Text("This text is selectable") } }
Возможно, вы захотите отключить выделение определенных частей выбираемой области. Для этого вам нужно обернуть невыбираемую часть составным 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") } } }
Создавайте кликабельные разделы текста с помощью LinkAnnotation
Чтобы прослушивать клики по Text
, вы можете добавить модификатор clickable
. Однако вы можете захотеть прикрепить дополнительную информацию к определенной части значения Text
, например URL-адрес, прикрепленный к определенному слову, которое нужно открыть в браузере. В подобных случаях вам необходимо использовать LinkAnnotation
— аннотацию, представляющую интерактивную часть текста.
С помощью LinkAnnotation
вы можете прикрепить URL-адрес к части составного 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(".") } ) }
Вы также можете настроить настраиваемое действие в ответ на щелчок пользователя по части составного 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") } } ) }
Рекомендуется для вас
- Примечание. Текст ссылки отображается, когда JavaScript отключен.
- Семантика в Compose
- Доступность в Compose
- Material Design 2 в Compose