本文讲解如何在 IgxGrid 中让单个列（如 IndustrySector）同时支持对多个字段（IndustrySector 和 IndustryGroup）进行全局搜索与关键词高亮，通过 igxTextHighlight 指令替代默认 field 绑定逻辑，实现语义聚合与搜索能力的统一。
本文讲解如何在 igxgrid 中让单个列（如 industrysector）同时支持对多个字段（industrysector 和 industrygroup）进行全局搜索与关键词高亮，通过 `igxtexthighlight` 指令替代默认 `field` 绑定逻辑，实现语义聚合与搜索能力的统一。
在使用 Ignite UI for Angular 的 IgxGrid 时，开发者常遇到一种典型场景：某列需视觉聚合多个业务维度（例如行业大类 IndustrySector + 行业子类 IndustryGroup），但用户期望输入关键词后，只要匹配其中任一字段即触发筛选与高亮。然而，
✅ 正确解法：解耦显示、搜索与高亮逻辑
核心思想是放弃依赖 [field] 的自动过滤机制，转而采用显式、可控的手动高亮策略：
-
[field]保持单一职责：仍设为'IndustrySector'，保障排序、导出、列头标识等基础功能； -
搜索范围扩展至多字段：在单元格模板中，为
IndustrySector和IndustryGroup分别注入igxTextHighlight指令，并独立指定其column属性（该属性仅用于高亮上下文，无需与列的[field]一致）； -
高亮与查找由代码统一驱动：通过
grid.findNext()/findPrev()触发全局匹配，并调用每个igxTextHighlight实例的.highlight()方法同步渲染。
? 实现步骤与关键代码
1. HTML 模板：在单列内并行高亮两个字段
<igx-column datatype="string"><ng-template igxcell let-cell="cell"><div class="row">
<!-- 高亮 IndustrySector 字段 -->
<div>
<div igxtexthighlight class="igx-grid__td-text">
{{ cell.row.data.IndustrySector }}
</div>
</div>
<!-- 高亮 IndustryGroup 字段（同一列内独立控制） -->
<div>
<div igxtexthighlight class="igx-grid__td-text">
{{ cell.row.data.IndustryGroup }}
</div>
</div>
</div>
</ng-template></igx-column>
⚠️ 注意事项：
groupName必须全局唯一且与IgxGrid的id一致（如grid1），否则高亮状态不同步；column属性在此处仅为逻辑标识符，不参与列定义，可自由设为任意字符串（如'IndustryGroup'）；- 不要设置
[filterable]="true"在该列上——因我们已接管搜索逻辑，避免默认过滤器干扰。
2. TypeScript 控制器：联动查找与高亮
@ViewChildren(IgxTextHighlightDirective)
highlightDirectives: QueryList<igxtexthighlightdirective>;
public searchKeyDown(ev: KeyboardEvent) {
if (['Enter', 'ArrowDown', 'ArrowRight', 'ArrowUp', 'ArrowLeft'].includes(ev.key)) {
ev.preventDefault();
// 先驱动 Grid 查找（影响滚动与焦点）
const method = ev.key === 'ArrowUp' || ev.key === 'ArrowLeft'
? this.grid.findPrev : this.grid.findNext;
method.call(this.grid, this.searchText, this.caseSensitive, this.exactMatch);
// 再批量触发所有高亮指令更新
this.highlightDirectives.forEach(dir =>
dir.highlight(this.searchText, this.caseSensitive, this.exactMatch)
);
}
}</igxtexthighlightdirective>
3. 样式增强（可选）
为提升可读性，可自定义高亮样式：
.igx-highlight--active {
background-color: #ffeb3b !important;
color: #212121;
}
.igx-grid__td-text {
line-height: 1.4;
}
✅ 优势总结
| 维度 | 说明 |
|---|---|
| 语义清晰 | 列仍代表一个业务概念（如“行业”），而非技术字段；多字段展示与搜索均服务于该概念 |
| 完全可控 | 高亮粒度精确到 DOM 节点，支持差异化样式、动态开关、模糊/大小写敏感等配置 |
| 零侵入结构 | 无需修改数据模型或新增列，兼容现有分页、导出、排序等全部 Grid 功能 |
| 可扩展性强 | 后续如需加入 IndustryCode 或 IndustryDescription，只需在模板中追加一个 igxTextHighlight 块 |
? 提示：若需实现「搜索时隐藏不匹配行」，应配合自定义
filterStrategy实现服务端或客户端联合过滤（例如：row => includesAny(row, ['IndustrySector', 'IndustryGroup'], searchText)），而非依赖默认列过滤器。
该方案已在 Ignite UI for Angular v14+ 稳定运行，是企业级表格中处理“多维聚合列搜索”问题的推荐实践。
