Skip to main content

ConversationsConfiguration

This refers to the properties of the CometChatConversations component that are available for customisation via the parent component when the component exists in a deep nested hierarchy.

Configurable Properties

ParametersDescription
titleAlignmentAlignment of the heading text for the component
loadingIconURLAsset URL for the loading indicator icon
loadingStateViewUser-defined component to customise the loading indicator
emptyStateViewUser-defined component to customise the empty state of the component.
errorStateViewUser-defined component to customise the error state of the component.
sentIconAsset URL for the sent state indicating that a message is sent successfully.
deliveredIconAsset URL for the delivered state indicating that a sent message is delivered successfully.
readIconAsset URL for the read state indicating that a sent message is read by the receiver.
errorIconAsset URL for the error state indicating that an error has occurred when the message was in transit.
privateGroupIconAsset URL for the group icon to represent the private or closed group.
passwordGroupIconAsset URL for the group icon to represent the password protected group.
conversationsRequestBuilderClass that allows you to set various parameters to the UsersRequest class based on which the conversations are fetched
hideSeparatorWhen set to true, hides the separator between the individual elements in the list.
hideErrorWhen set to true, hides the error messages displayed within the component
disableUsersPresenceWhen set to true, Users will not be able to see whether a particular user is currently online or offline.
disableReceiptWhen set to true, switches off the visual indication when a message has been read or viewed by the recipient.
disableTypingWhen set to true, typing events are disabled and the typing indicators are not displayed.
disableSoundForMessagesWhen set to true, the component will not produce sound for all incoming messages.
customSoundForMessagesmp3 file asset of your choice.
selectionModeAllows user to select individual or multiple items for applying specific operations.
onSelectMethod invoked which returns the selected users.
subtitleViewUser-defined component to customise the secondary text shown in the default user profile.
menuUser-defined component to showcase options related to the users in the header section.
optionsUser-defined actions which appears for each user on mouseover.
onItemClickOverride the method that is invoked when user clicks on a individual item in the list
onErrorOverride the method that is invoked when an error is encountered within the component
avatarStyleStyling properties and values of the Avatar component
statusIndicatorStyleStyling properties and values of the StatusIndicator component
badgeStyleStyling properties and values of the Badge component
receiptStyleStyling properties and values of the Receipt component
listItemStyleStyling properties and values of the ListItem component
deleteConversationDialogStyleStyling properties and values of the ConfirmDialog component
backdropStyleStyling properties and values of the Backdrop component
conversationsStyleStyling properties and values of the CometChatConversations component
disableMentionsDisable mentions in conversation.. Default value is set to false
textFormattersAllows user to pass custom formatters