Skip to content
On this page

ChatListView

A conversation list with history items and navigation actions.

ChatListView in FluttyUIChatListView in FluttyUI dark theme

Import

import 'package:flutter/widgets.dart';
import 'package:fluttyui/fluttyui.dart' as ui;

API Reference

The declarations below match the current FluttyUI source. Types are shown without the optional ui. import prefix.

ChatListView

const ChatListView({
  super.key,
  required this.items,
  this.selectedId,
  this.onSelected,
  this.onNewChat,
  this.onRename,
  this.onDelete,
  this.onTogglePin,
  this.onArchive,
  this.showSearch = true,
  this.showPreviews = false,
  this.previewBuilder,
  this.showArchived = false,
  this.groupByDate = true,
  this.searchController,
  this.scrollController,
  this.scrollShadowColor,
  this.now,
  this.isLoading = false,
  this.error,
  this.onRetry,
});
ParameterTypeRequiredDefault
keyKey?Nonull
itemsList<ChatHistoryItem>Yes—
selectedIdObject?Nonull
onSelectedValueChanged<ChatHistoryItem>?Nonull
onNewChatVoidCallback?Nonull
onRenameValueChanged<ChatHistoryItem>?Nonull
onDeleteValueChanged<ChatHistoryItem>?Nonull
onTogglePinValueChanged<ChatHistoryItem>?Nonull
onArchiveValueChanged<ChatHistoryItem>?Nonull
showSearchboolNotrue
showPreviewsboolNofalse
previewBuilderWidget Function(BuildContext, ChatHistoryItem)?Nonull
showArchivedboolNofalse
groupByDateboolNotrue
searchControllerTextEditingController?Nonull
scrollControllerScrollController?Nonull
scrollShadowColorColor?Nonull
nowDateTime?Nonull
isLoadingboolNofalse
errorString?Nonull
onRetryVoidCallback?Nonull

Application Setup

Place components under FluttyApp to provide theme, navigation, localization, and overlay defaults. Use theme tokens for shared appearance settings.

Source

lib/src/widgets/messaging/chat_list_view/chat_list_view.dart

This reference is generated from the ChatListView declaration in the FluttyUI core checkout. The component catalog lists the other available building blocks.

DartFlutter

Get started with FluttyUI