实现关键词高亮搜索与结果预览
【摘要】 前言笔记类应用里,搜索是高频刚需功能。很多场景下不只是简单匹配返回整条笔记,还需要关键词标红高亮、片段预览、按匹配度排序。本篇基于 ArkTS + RDB 数据库,实现笔记全文检索、关键词高亮组件,同时解决富文本原始内容截取、特殊标签干扰、多次搜索防抖等常见问题。 方案选型数据库层:RDB 原生 LIKE 模糊匹配(适合轻量笔记,数据量不大;海量场景可后续切换全文索引)视图层:自定义高亮文...
前言
笔记类应用里,搜索是高频刚需功能。很多场景下不只是简单匹配返回整条笔记,还需要关键词标红高亮、片段预览、按匹配度排序。本篇基于 ArkTS + RDB 数据库,实现笔记全文检索、关键词高亮组件,同时解决富文本原始内容截取、特殊标签干扰、多次搜索防抖等常见问题。
方案选型
- 数据库层:RDB 原生
LIKE模糊匹配(适合轻量笔记,数据量不大;海量场景可后续切换全文索引) - 视图层:自定义高亮文本组件,对匹配关键词分段切割渲染
- 交互层:输入防抖,避免每次输入都触发数据库查询;结果预览截取匹配附近文本片段,不展示完整长内容
- 边界处理:富文本标签过滤、大小写统一匹配、关键词为空时清空列表
说明: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%')
}
}
四、踩坑点与优化方案
- 富文本内容带标签干扰预览
RichEditor 存储的 content 自带标签,直接展示会看到<p> <img>等标记。可以增加一个工具方法,正则过滤 html 标签后再传入高亮组件。
function stripHtmlTag(str: string): string {
return str.replace(/<[^>]+>/g, '');
}
- 关键词大小写问题
正则带上gi,全局+忽略大小写,搜索“Harmony”和“harmony”都能命中。 - 短时间连续输入频繁查库
防抖 300ms,减少 RDB 查询次数,降低数据库压力。 - 长笔记预览截断丢失关键词
当前方案简单截取头部,进阶方案:查找关键词位置,截取关键词前后一段文字作为预览片段,保证高亮内容一定出现在预览里。
五、后续扩展方向
- 支持多关键词同时检索
- 增加搜索历史记录,用 Preferences 持久化
- 结果排序优化:标题命中权重高于正文命中
- 接入系统全文检索能力,替代 LIKE,提升大数据量检索性能
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)