Angular自定义管道实现多字段输入自动补全跨组件联动咨询
Angular 多组件联动实现任意字段匹配的搜索过滤
现有需求与代码现状
当前的开发目标是实现输入框匹配任意字段值的过滤效果,已完成的拆分和代码如下:
- 拆分了两个独立组件:
app-input承载搜索输入框,app-table渲染船信息的表格 - 已编写基础的自定义过滤管道,目前仅支持按船类型(boatType)单字段过滤
- 暂未打通两个组件的数据联动,对@Input/@Output的使用场景不清晰
示例JSON数据
{ "boatType": "Semi-rigide", "img": "/assets/img/boat-img/semi-rigide.jpg", "longeur": 10, "largeur": 20, "tirantEau": 50, "equipage": false, "annexe": true }
表格组件模板(table.component.html)
当前的实现是通过模板引用抓输入组件的内部值做过滤:
<div class="search"> <app-input #inputComponent></app-input> </div> <table> <caption>Statement Summary</caption> <thead> <tr> <th scope="col" class="toto">img</th> <th scope="col">Type de bateau</th> <th scope="col">longeur</th> <th scope="col">largeur</th> <th scope="col">tirant d'eau</th> <th scope="col">equipage</th> <th scope="col">annexe</th> </tr> </thead> <tbody> <tr *ngFor="let boat of user | filter : inputComponent?.searchText"> <td data-label="img"><img [src]="boat.img" alt="boat" class="img"></td> <td data-label="boat type">{{ boat.boatType }}</td> <td data-label="longeur">{{boat.longeur}} cm</td> <td data-label="largeur">{{boat.largeur}} cm</td> <td data-label="tirant d'eau">{{boat.tirantEau}} cm</td> <td data-label="equipage">{{boat.equipage ? "Oui" : "Non"}}</td> <td data-label="annexe">{{boat.annexe ? "Oui" : "Non"}}</td> </tr> </tbody> </table>
搜索输入组件模板(input.component.html)
<input type="text" placeholder="Chercher un bateau.." [(ngModel)]="searchText">
自定义过滤管道代码(filter.pipe.ts)
import { Pipe, PipeTransform } from '@angular/core'; @Pipe({ name: 'filter' }) export class FilterPipe implements PipeTransform { transform(items: any[], searchText: string): any[] { if (!items) return []; if (!searchText) return items; // 当前仅支持单字段(boatType)匹配 return items.filter(item => { return item.boatType.toLowerCase().includes(searchText.toLowerCase()); }); } }
完整实现步骤
当前用模板引用#inputComponent抓子组件内部变量的写法比较脆弱,一旦子组件的变量改名、或者结构调整,整个过滤逻辑就会失效。对于「搜索输入值从子组件传到父组件做数据过滤」的场景,本来就应该用@Output + EventEmitter的标准Angular数据流实现,完全适配现有的组件拆分结构,不需要强行把两个组件合并。
1. 改造独立输入组件,对外抛搜索值
在输入组件的TS文件里引入@Output装饰器和EventEmitter,把内部输入的实时值向外传递,不再把内部变量暴露给父组件抓取:
// input.component.ts import { Component, Output, EventEmitter } from '@angular/core'; @Component({ selector: 'app-input', templateUrl: './input.component.html' }) export class InputComponent { // 定义向外抛出搜索值的事件 @Output() searchChange = new EventEmitter<string>(); // 输入框值变化时触发,把最新值抛给父组件 onSearchInput(value: string) { this.searchChange.emit(value.trim()); } }
对应的输入组件模板去掉内部的双向绑定,换成输入事件触发:
<input type="text" placeholder="Chercher un bateau.." (input)="onSearchInput($event.target.value)" >
2. 改造表格父组件,接收搜索值完成过滤
在表格组件的TS文件里定义本地变量存储收到的搜索关键词,写好接收事件的回调方法:
// table.component.ts export class TableComponent { // 存储从输入组件收到的搜索关键词 searchText = ''; // 原有的船数据数组 user: any[] = []; // 接收搜索值的回调方法 updateSearchText(val: string) { this.searchText = val; } }
对应的表格组件模板把原来的模板引用抓值的写法,换成绑定子组件抛出来的自定义事件,循环过滤时直接用父组件自己存储的searchText作为管道入参:
<div class="search"> <!-- 绑定子组件的searchChange事件,把值存到父组件本地变量 --> <app-input (searchChange)="updateSearchText($event)"></app-input> </div> <table> <!-- 原来的表格结构保持不变,只修改管道的入参来源 --> <tr *ngFor="let boat of user | filter : searchText"> <!-- 原有表格内容无需改动 --> </tr> </table>
3. 升级过滤管道,支持任意字段匹配
修改管道的匹配逻辑,不再硬编码只匹配boatType字段,遍历每个对象的所有属性值,统一转成字符串做匹配,兼容数字、布尔类型的字段:
// filter.pipe.ts import { Pipe, PipeTransform } from '@angular/core'; @Pipe({ name: 'filter' }) export class FilterPipe implements PipeTransform { transform(items: any[], searchText: string): any[] { // 边界判断:无有效数据直接返回空数组 if (!items?.length) return []; // 无输入搜索词,直接返回原数据 if (!searchText) return items; // 统一转成小写,避免大小写匹配失败 const lowerSearch = searchText.toLowerCase(); return items.filter(item => { // 遍历当前船对象的所有字段值,只要任意字段包含搜索词就保留 return Object.values(item).some(fieldVal => { return String(fieldVal).toLowerCase().includes(lowerSearch); }); }); } }
注意:这种纯管道的实现方式在数据量较小的场景下完全够用。Angular本身不推荐用管道做复杂过滤是因为变更检测时会重复执行过滤逻辑,等对RxJS熟悉之后,可以把过滤逻辑挪到组件里配合异步流做优化,对刚入门的开发者来说,上面这套实现已经是最易理解、最符合规范的写法。
内容的提问来源于stack exchange,提问作者Vinodea Richard
相关产品推荐
相关产品推荐

