IsselSearchDropdown

​

Constructor

const IsselSearchDropdown({
    super.key,
    required this.items,
    required this.hintText,
    required this.onChanged,
    this.height = 50,
    this.value,
    this.color,
    this.onSearchChanged,
    this.onSearchSubmitted,
    this.maxItemsToShow,
    this.overlay = false,
  })

​

Propiedades

​

Ejemplo

import 'package:flutter/material.dart';
import 'package:issel_code_widgets/issel_code_widgets.dart';

Widget searchDropdownExample(
  String? value,
  List<String> filteredNames,
  ValueChanged<String> onSearch,
  ValueChanged<String?> onChanged,
) =>
    IsselSearchDropdown<String>(
      value: value,
      hintText: 'Buscar cliente',
      overlay: true,
      items: [
        for (final name in filteredNames)
          DropdownMenuItem(value: name, child: Text(name)),
      ],
      onSearchChanged: onSearch,
      onChanged: onChanged,
    );

​

Comportamiento y límites

• La app filtra o consulta datos desde onSearchChanged/onSearchSubmitted. El widget no realiza búsquedas automáticamente.
• maxItemsToShow limita el itemCount construido, no sólo la altura visible. Las opciones posteriores quedan fuera del menú.
• La altura de la lista se calcula con filas de referencia de 45 px y se limita entre 80 y 250 px.
• overlay: true inserta un OverlayEntry debajo del campo, conserva el alto del layout y permite cerrar pulsando fuera. No calcula todas las colisiones con el viewport.
• La etiqueta de una opción elegida internamente puede conservarse aunque desaparezca de items. Un value externo que nunca estuvo en items no dispone de etiqueta cacheada.
• No es FormField<T> y no expone validator para la selección. Su TextFormField interno de búsqueda no sustituye esa validación.
• onChanged: null no impide abrir o elegir visualmente. Las propiedades enabled de DropdownMenuItem no se comprueban al construir los InkWell de opciones.
• La consulta externa puede conservarse al cerrar aunque el campo de búsqueda se recree vacío al abrir. Define la política de reinicio en la app.