首页
/ Antares SQL 查询历史记录高亮显示问题分析与解决方案

Antares SQL 查询历史记录高亮显示问题分析与解决方案

2025-07-03 00:49:38作者:江焘钦

问题背景

在Antares SQL数据库管理工具中,用户发现历史查询记录模块存在一个显示异常问题。当用户在历史记录中搜索特定查询时,搜索结果中出现了未渲染的HTML标签,而不是预期的视觉高亮效果。这个问题影响了用户体验,使得搜索结果的视觉反馈不够直观。

问题现象

用户在历史记录面板进行搜索时,预期看到的是搜索关键词以特殊样式(主色加粗)高亮显示。然而实际呈现的是未经处理的HTML标签字符串,如<span class="text-primary text-bold">SELECT</span>直接显示在界面上,而非渲染后的视觉效果。

更复杂的是,当SQL语法高亮功能与搜索高亮功能同时作用于同一文本时,两种高亮效果会产生冲突,导致最终的显示效果不符合预期。

技术分析

这个问题源于ModalHistory.vue组件中的双重高亮处理逻辑:

  1. 搜索关键词高亮:通过highlightWord函数将匹配的搜索词用HTML span标签包裹,添加特定CSS类
  2. SQL语法高亮:通过highlight函数对整个SQL语句进行语法着色

当这两个功能串联使用时(highlight(highlightWord(query.sql))),HTML标签会被当作普通文本处理,而非DOM元素,从而导致标签直接显示。

解决方案

开发团队提供了两种解决思路:

方案一:完全移除搜索高亮功能

直接使用SQL语法高亮,放弃搜索关键词的特殊标记。这种方法简单直接,但牺牲了搜索结果的视觉反馈。

// 修改前
v-html="highlight(highlightWord(query.sql), {html: true})"

// 修改后
v-html="highlight(query.sql, {html: true})"

方案二:调整高亮标记方式

保留搜索高亮功能,但修改标记方式,使用不会与SQL语法高亮冲突的符号:

// 原实现
return string.replace(regexp, '<span class="text-primary text-bold">$1</span>');

// 修改后实现
return string.replace(regexp, '%$1%');

这种方案使用百分号包裹搜索词,既保持了视觉区分度,又避免了HTML标签与语法高亮的冲突。修改后,搜索词会显示为绿色百分号包裹的文本,如%SELECT%

实现选择与考量

在实际修复中,开发团队需要权衡以下因素:

  1. 用户体验:搜索高亮功能对于快速定位结果非常重要,完全移除可能影响使用效率
  2. 技术实现复杂度:双重高亮处理需要确保两种高亮机制不会相互干扰
  3. 视觉一致性:修改后的高亮样式需要与整体UI风格协调

最终,Antares SQL选择了方案二作为修复方案,因为它:

  • 保留了搜索高亮的实用功能
  • 解决了HTML标签直接显示的问题
  • 通过简单的符号标记实现了足够的视觉区分度
  • 避免了与SQL语法高亮的深层冲突

总结

这个案例展示了前端开发中常见的富文本处理挑战,特别是当多个文本处理功能需要叠加时。Antares SQL通过调整高亮标记策略而非完全移除功能,既解决了问题又保持了良好的用户体验,体现了对细节的关注和务实的技术决策。

登录后查看全文
热门项目推荐
相关项目推荐