Android 14 新功能之 TextView 搜索结果高亮和焦点移动～

yan_chenglong

于 2024-04-14 12:07:01 发布

阅读量42

点赞数

文章标签： android

原文链接：https://juejin.cn/post/7236680350558076983

版权

前言

之前写的文章《Android 14 新功能之 HighLights》里，讲到 Android 14 里推出的 HighLights 新功能可以快速实现 TextView 文字的高亮效果，并支持动态更新。

本文将继续介绍 TextView 的另 2 处新功能：

使用 searchResultHighlight 等针对 TextView 的搜索结果进行高亮展示
使用 focusedSearchResultIndex 针对 TextView 搜索焦点高亮和移动

搜索结果高亮

Android 14 推出了针对搜索结果展示高亮和当前焦点高亮的新 API：

setSearchResultHighlightColor(int color)：设置所有匹配到搜索关键字的文本颜色，对应的还有 android:searchResultHighlightColor attribute 可以在 xml 中配置，当然也可以使用 getSearchResultHighlightColor() 在代码中获取当前颜色值
setSearchResultHighlights(int… ranges)：设置所有匹配到搜索关键字的文字范围，同样提供了 getSearchResultHighlights() 支持在代码中获取匹配范围

下面我们利用这些 API 进行效果实战。

首先，我们先在代码里设置颜色，将搜索到的文字为水蓝色：

kotlin
复制代码
 class TextViewActivity : AppCompatActivity() {
     companion object {
         const val TEXT_LONG = "val builder = Highlights.Builder()val val val val val val val val "
     }
 
     override fun onCreate(savedInstanceState: Bundle?) {
         ...
         with(binding.textview2) {
             text = TEXT_LONG
 
             // set highlight color for searching
             searchResultHighlightColor = Color.CYAN
         }
 }

接着，添加 button 模拟搜索：

kotlin
复制代码
 class TextViewActivity : AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         ...
         // 模拟搜索按钮
         binding.startSearch.setOnClickListener {
             binding.textview2.run {
                 Log.d("HighLights", "startSearch tapped" +
                         " and current search Color:${searchResultHighlightColor.toColorString()}"
                 )
 
                 // set searching ranges
                 setSearchResultHighlights(4, 11, 25, 32)
             }
         }
 }

运行下代码看下效果：点击 “Search” button 之后，builder 字样呈现出水蓝色高亮。

如下的 log 也显示当前设置的高亮色为水蓝色。

sql
复制代码
 2023-05-21 14:01:47.632 5513-5513/com.ellison.demo D/HighLights: startSearch tapped and current search Color:CYAN

搜索焦点高亮和移动

搜索焦点移动新 API 如下：

setFocusedSearchResultHighlightColor(int color)：设置当前聚焦到的匹配关键字的文本颜色，xml 中使用的 android:focusedSearchResultHighlightColor attribute 以及代码中获取该颜色值的 getFocusedSearchResultHighlightColor()
setFocusedSearchResultIndex(int index)：设置当前聚焦到的匹配关键字的索引以及 getFocusedSearchResultIndex() 获取索引的方法

注意默认的搜索焦点为 FOCUSED_SEARCH_RESULT_INDEX_NONE 即 -1，意味着搜索结果并未开始聚焦。

然后给 TextView 添加聚焦后颜色为灰色，并添加 button 模拟焦点移动：

kotlin
复制代码
 class TextViewActivity : AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         ...
         with(binding.textview2) {
             ...
             // set matched searching highlight color
             focusedSearchResultHighlightColor = Color.GRAY
         }
 
         // 模拟焦点移动按钮
         binding.changeSearchIndex.setOnClickListener {
             binding.textview2.run {
                 Log.d("HighLights", "changeSearchIndex tapped" +
                         " and current Focused Color:${focusedSearchResultHighlightColor.toColorString()}" +
                         " and currentFocusedResultIndex:${focusedSearchResultIndex}"
                 )
 
                 // Set index to first or second
                 val newSearchIndex = when (focusedSearchResultIndex) {
                     TextView.FOCUSED_SEARCH_RESULT_INDEX_NONE, 1 -> 0
                     0 -> 1
                     else -> TextView.FOCUSED_SEARCH_RESULT_INDEX_NONE
                 }
 
                 Log.d("HighLights", "changeSearchIndex to :$newSearchIndex")
                 binding.textview2.focusedSearchResultIndex = newSearchIndex
             }
         }
 }

看下效果：点击 “Forward” button 之后灰色高亮在两个水蓝色高亮之间切换。

log 也显示当前设置的焦点高亮为灰色，焦点 index 随着点击在第一个和第二个之间切换。

bash
复制代码
 2023-05-21 14:01:51.167 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex tapped and current Focused Color:GREY and currentFocusedResultIndex:-1
 2023-05-21 14:01:51.167 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex to :0
 2023-05-21 14:01:52.995 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex tapped and current Focused Color:GREY and currentFocusedResultIndex:0
 2023-05-21 14:01:52.995 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex to :1
 2023-05-21 14:01:54.363 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex tapped and current Focused Color:GREY and currentFocusedResultIndex:1
 2023-05-21 14:01:54.363 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex to :0
 2023-05-21 14:01:55.528 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex tapped and current Focused Color:GREY and currentFocusedResultIndex:0
 2023-05-21 14:01:55.528 5513-5513/com.ellison.demo D/HighLights: changeSearchIndex to :1

总结

上个版本 13 时 Android 针对 TextView 提供了 LineBreakConfig 换行策略的新功能，到这次 14 一次性推出了文本高亮 HighLights、搜索高亮 searchResultHighlight 以及搜索焦点移动 focusedSearchResultIndex 3 个新功能。

虽然已经 Android 平台早已成熟、稳定，但 AOSP 团队仍不忘对 TextView 这个最基础的控件进行升级和优化。可以说 TextView 既是基础，同时也是使用最频繁、最重要的，所以官方的一点点改动都显得极为难得，开发者们需要知悉。

DEMO 源码

github.com/ellisonchan…

参考资料

作者：TechMerger
链接：https://juejin.cn/post/7236680350558076983
来源：稀土掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

yan_chenglong

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Android 14 新功能之 TextView 搜索结果高亮和焦点移动～

之前写的文章《Android 14 新功能之 HighLights》里，讲到 Android 14 里推出的HighLights新功能可以快速实现 TextView 文字的高亮效果，并支持动态更新。使用等针对 TextView 的搜索结果进行高亮展示使用针对 TextView搜索焦点高亮和移动上个版本 13 时 Android 针对 TextView 提供了换行策略的新功能，到这次 14 一次性推出了文本高亮HighLights、搜索高亮以及搜索焦点移动3个新功能。
复制链接

扫一扫