Filter Builder

Uso Básico

Para utilizar el widget FilterBuilder, siga los siguientes pasos:

1. Importe el widget en su archivo Dart:

   import 'package:your_package_name/filter_builder.dart';

2. Cree una instancia del widget FilterBuilder en su aplicación, proporcionando los parámetros necesarios. Los parámetros más comunes incluyen child, filterButton, offerFilterType, campusFilterType, onPressedOffer, onPressedCampus, showSelected, y alwaysVisible.

   FilterBuilder(
     child: YourContentWidget(),
     filterButton: Icon(Icons.filter),
     offerFilterType: FilterType.row,
     campusFilterType: FilterType.list,
     onPressedOffer: (selectedOffer) {
       // Acción al seleccionar una oferta.
     },
     onPressedCampus: (selectedCampus) {
       // Acción al seleccionar un campus.
     },
     showSelected: true,
     alwaysVisible: true,
   )

3. El widget FilterBuilder se encargará de mostrar su contenido junto con un botón de filtro. Cuando el usuario toca el botón de filtro, se abrirá un modal que permitirá realizar la selección de filtros.

Constructores Específicos

El widget FilterBuilder incluye dos constructores específicos para simplificar la creación de filtros:

Filtrar Ofertas

Puede generar un FilterBuilder específicamente para filtrar ofertas utilizando el constructor FilterBuilder.offer. Esto simplifica la configuración relacionada con las ofertas.

FilterBuilder.offer(
  child: YourContentWidget(),
  onPressed: (selectedOffer) {
    // Acción al seleccionar una oferta.
  },
)

Filtrar Campus

Del mismo modo, puede generar un FilterBuilder específicamente para filtrar campus empleando el constructor FilterBuilder.campus.

FilterBuilder.campus(
  child: YourContentWidget(),
  onPressed: (selectedCampus) {
    // Acción al seleccionar un campus.
  },
)

Personalización

El widget FilterBuilder le permite personalizar la apariencia del botón de filtro, el comportamiento de selección y la visibilidad del botón. Puede adaptar el aspecto del botón, como su ícono y color, y configurar si se debe mostrar siempre o solo cuando haya elementos para filtrar.

Funcionalidad

Cuando se selecciona un filtro, el widget FilterBuilder llama a la función proporcionada (onPressedOffer o onPressedCampus) y permite realizar acciones específicas de la aplicación según el filtro seleccionado. Los elementos filtrados se muestran en el botón de filtro para referencia rápida.

En resumen, el widget FilterBuilder es una herramienta versátil para implementar filtros en una aplicación Flutter de manera eficiente y personalizada. Puede simplificar la experiencia del usuario al permitirles filtrar elementos de manera efectiva según sus necesidades.