ConversationList
A list of conversations that the current user is a part of.
It makes available a callback, onSelectConversation
, that gets triggered when
the user clicks on one of the conversations.
In most cases, you will just want this handler to navigate to a screen that contains a ChatBox. showing the conversation that has just been selected.
Constructor | Creates a ConversationList UI. |
const ConversationList({Key? key,required Session session,bool? showFeedHeader,String? theme,ConversationPredicate feedFilter = const ConversationPredicate(),SelectConversationHandler? onSelectConversation,LoadingStateHandler? onLoadingStateChanged,});
Creates a ConversationList UI.
NOTE: All the parameters passed to the constructor are also available as read-only properties of the constructed object.
Parameters
key
(optional): Key?A Key is an identifier for Flutter Widgets.
session
: SessionThe TalkJS Session object to use for this ConversationList.
showFeedHeader
: bool?Controls if the feed header containing the toggle to enable desktop notifications is shown. Defaults to true.
theme
: String?Overrides the theme used for this chat UI.
This only works with themes created in the Theme Editor.
If you omit this field, the UI uses the theme that is selected in the current user's role.
feedFilter
(optional): ConversationPredicateControls which conversations are shown in the conversation feed
Lets you filter conversations in the conversation list, depending on access level, custom conversation attributes or message read status.
See ConversationPredicate for all available options.
onSelectConversation
: SelectConversationHandler?Triggers when a user clicks a conversation in the feed
onLoadingStateChanged
(optional): LoadingStateHandler?Triggers when the loading state of the ConversationList changes.
The Getting Started
guide has an example on how to use the onLoadingStateChanged
callback to show
a loading indicator while the ChatBox is loading.
typedef SelectConversationHandler = void Function(SelectConversationEvent event);
See SelectConversationEvent for the callback parameter.
typedef LoadingStateHandler = void Function(LoadingState state);
Notifies when the loading state of the ChatBox changes.
The LoadingState
can be either loading
or loaded
, and it can be useful for showing a
placeholder widget while the ChatBox is loading.
The Getting Started
guide has an example on how to use the onLoadingStateChanged
callback to show
a loading indicator while the ChatBox is loading.