Skip to content
pubscout

searchable_listview

2.20.1, released 4 days ago by badrkouki.dev

Flutter widget providing a searchable, sortable, and paginated list UI.

WASM-readyUses material_uiRock solid
$ flutter pub add searchable_listview
Source repository

What it does

It renders a list view combined with a customizable search field, allowing users to filter items synchronously or asynchronously. It also supports expansion groups, slivers, pull-to-refresh, and pagination.

AI-written summary of version 2.19.5, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to display a list of items with an integrated search bar.
  • You require support for asynchronous data sources and filtering.
  • You need features like pagination, pull-to-refresh, or expansion groups out-of-the-box.

Skip it when

  • You need a standard non-searchable list view where custom search is unnecessary.
  • You are building your own highly custom search architecture with explicit controllers and custom animations.

Strengths

  • Supports synchronous and asynchronous data loading and filtering.
  • Provides multiple constructors including slivers and expansion groups.
  • Highly customizable search field and state widgets.

Weaknesses

  • Tied specifically to its own list implementation wrapper, which may limit deep customization of underlying scroll physics or layout.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
2
SearchableList<Actor>(
  initialList: actors,
  itemBuilder: (actor) => ActorItem(actor: actor),
  filter: (query) => actors
      .where((a) => a.name.toLowerCase().contains(query.toLowerCase()))
      .toList(),
  emptyWidget: const Center(child: Text('No results')),
  inputDecoration: InputDecoration(labelText: 'Search actor'),
)

Alternatives

Packages that do the same job and could replace searchable_listview.

Works with

Packages commonly used together with searchable_listview: ones it builds on, ones built on it, and its own family.