实现关键词高亮搜索与结果预览

举报
yd_284811271 发表于 2026/11/16 22:07:36 2026/11/16
【摘要】 前言笔记类应用里,搜索是高频刚需功能。很多场景下不只是简单匹配返回整条笔记,还需要关键词标红高亮、片段预览、按匹配度排序。本篇基于 ArkTS + RDB 数据库,实现笔记全文检索、关键词高亮组件,同时解决富文本原始内容截取、特殊标签干扰、多次搜索防抖等常见问题。 方案选型数据库层:RDB 原生 LIKE 模糊匹配(适合轻量笔记,数据量不大;海量场景可后续切换全文索引)视图层:自定义高亮文...

前言

笔记类应用里,搜索是高频刚需功能。很多场景下不只是简单匹配返回整条笔记,还需要关键词标红高亮、片段预览、按匹配度排序。本篇基于 ArkTS + RDB 数据库,实现笔记全文检索、关键词高亮组件,同时解决富文本原始内容截取、特殊标签干扰、多次搜索防抖等常见问题。

方案选型

  1. 数据库层:RDB 原生 LIKE 模糊匹配(适合轻量笔记,数据量不大;海量场景可后续切换全文索引)
  2. 视图层:自定义高亮文本组件,对匹配关键词分段切割渲染
  3. 交互层:输入防抖,避免每次输入都触发数据库查询;结果预览截取匹配附近文本片段,不展示完整长内容
  4. 边界处理:富文本标签过滤、大小写统一匹配、关键词为空时清空列表

说明:RDB 的 LIKE 适合个人笔记小体量;如果后续笔记上万条,建议使用系统全文检索能力。

一、数据查询封装

// NoteRdbHelper.ets
import { relationalStore } from '@kit.ArkData';

export class NoteRdbHelper {
  static rdbStore: relationalStore.RdbStore;

  // 模糊搜索笔记,传入关键词
  static async searchNote(keyword: string): Promise<NoteItem[]> {
    if (!keyword.trim()) return [];
    const sql = `SELECT id,title,content,update_time FROM note WHERE title LIKE ? OR content LIKE ? ORDER BY update_time DESC`;
    const params = [`%${keyword}%`, `%${keyword}%`];
    const result = await this.rdbStore.querySql(sql, params);
    const list: NoteItem[] = [];
    for (let i = 0; i < result.rowCount; i++) {
      result.goToRow(i);
      list.push({
        id: result.getLong(0),
        title: result.getString(1),
        content: result.getString(2),
        updateTime: result.getLong(3)
      })
    }
    return list;
  }
}

export interface NoteItem {
  id: number;
  title: string;
  content: string;
  updateTime: number;
}

二、自定义高亮文本组件 HighLightText.ets

核心逻辑:把文本按关键词切割成数组,匹配到的片段用红色字体,其余正常字体。

@Component
export struct HighLightText {
  @Prop sourceText: string;
  @Prop keyword: string;

  build() {
    if (!this.keyword.trim()) {
      Text(this.sourceText)
        .fontSize(14)
      return;
    }
    // 忽略大小写匹配
    const reg = new RegExp(`(${this.keyword})`, 'gi');
    const parts = this.sourceText.split(reg);
    Flex({ wrap: FlexWrap.Wrap }) {
      ForEach(parts, (item: string) => {
        if (item.toLowerCase() === this.keyword.toLowerCase()) {
          Text(item)
            .fontColor('#ff4444')
            .fontSize(14)
        } else {
          Text(item)
            .fontColor('#333333')
            .fontSize(14)
        }
      }, item => item + Math.random())
    }
  }
}

三、搜索页面 + 防抖控制

import { HighLightText } from './HighLightText';
import { NoteRdbHelper, NoteItem } from './NoteRdbHelper';
import { setTimeout } from '@kit.BasicServicesKit';

@Entry
@Component
struct NoteSearchPage {
  @State searchKey: string = '';
  @State searchResult: NoteItem[] = [];
  private timerId: number | null = null;

  // 防抖搜索,300ms延迟
  doSearch() {
    if (this.timerId) {
      clearTimeout(this.timerId);
    }
    this.timerId = setTimeout(async () => {
      this.searchResult = await NoteRdbHelper.searchNote(this.searchKey);
    }, 300)
  }

  build() {
    Column() {
      TextInput({ text: this.searchKey, placeholder: '输入关键词搜索笔记' })
        .onChange((val: string) => {
          this.searchKey = val;
          this.doSearch();
        })
        .margin(12)

      if (this.searchResult.length === 0 && this.searchKey.trim()) {
        Text("未找到匹配笔记")
          .fontColor('#999')
          .margin({ top: 40 })
      }

      List() {
        ForEach(this.searchResult, (item: NoteItem) => {
          ListItem() {
            Column() {
              HighLightText({ sourceText: item.title, keyword: this.searchKey })
                .fontSize(16)
                .fontWeight(FontWeight.Medium)
                .margin({ bottom: 4 })
              // 内容预览,截取前80字符
              HighLightText({ sourceText: item.content.slice(0, 80), keyword: this.searchKey })
                .fontColor('#666')
            }
            .padding(12)
            .width('100%')
          }
        }, item => item.id.toString())
      }
      .layoutWeight(1)
    }
    .width('100%')
    .height('100%')
  }
}

四、踩坑点与优化方案

  1. 富文本内容带标签干扰预览
    RichEditor 存储的 content 自带标签,直接展示会看到 <p> <img> 等标记。可以增加一个工具方法,正则过滤 html 标签后再传入高亮组件。
function stripHtmlTag(str: string): string {
  return str.replace(/<[^>]+>/g, '');
}
  1. 关键词大小写问题
    正则带上 gi,全局+忽略大小写,搜索“Harmony”和“harmony”都能命中。
  2. 短时间连续输入频繁查库
    防抖 300ms,减少 RDB 查询次数,降低数据库压力。
  3. 长笔记预览截断丢失关键词
    当前方案简单截取头部,进阶方案:查找关键词位置,截取关键词前后一段文字作为预览片段,保证高亮内容一定出现在预览里。

五、后续扩展方向

  • 支持多关键词同时检索
  • 增加搜索历史记录,用 Preferences 持久化
  • 结果排序优化:标题命中权重高于正文命中
  • 接入系统全文检索能力,替代 LIKE,提升大数据量检索性能
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。