searchList
Paquete: @tiendana/ngx-core/pipes
Filtra arrays de objetos buscando un término en todas sus propiedades de tipo string, number o boolean.
Características
✅ Búsqueda en todas las propiedades del objeto
✅ Soporta string, number y boolean
✅ Case-insensitive
✅ Retorna array vacío si no hay coincidencias
✅ Manejo seguro de valores null/undefined
API
Sintaxis
{{ items | searchList:filter }}
Parámetros
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
items | any[] | null | undefined | Array de objetos a filtrar | ✅ |
filter | string | null | undefined | Término de búsqueda | ✅ |
Retorno
Array filtrado con los elementos que contienen el término en cualquiera de sus propiedades.
Ejemplos y Demos
Filtrado Básico
Ver código
Búsqueda en Múltiples Campos
Busca en nombre, categoría, precio y stock automáticamente.
Ver código
Filtrado en Tabla
Ver código
Casos de Uso
- Buscadores en tablas de datos
- Filtros de listas de productos
- Búsqueda en catálogos
- Autocompletado de selects
- Filtros de empleados/usuarios
Notas
Este pipe es pure, solo se re-ejecuta cuando el array o el término de búsqueda cambian. Para búsquedas en arrays muy grandes (>1000 items), considera implementar búsqueda server-side.
El pipe itera sobre todas las propiedades del objeto. Solo busca en propiedades propias (no heredadas) de tipo string, number o boolean; los objetos y arrays anidados se ignoran.
Si items o filter son nulos o vacíos, el pipe devuelve items tal cual, sin filtrar.