Skip to main content

UsersConfiguration

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

Configurable Properties

NameDescription
titleAlignmentAlignment of the heading text for the component
searchIconURLAsset URL for the search icon.
hideSearchWhen set to true, hides the search input.
showSectionHeaderWhen set to true, displays the header between the individual sections in the list.
sectionHeaderKeyMethod of the user class to display the section header
hideSectionSeparatorWhen set to true, hides the separator between the individual sections in the list.
hideErrorWhen set to true, hides the error messages displayed within 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.
usersRequestBuilderClass that allows you to set various parameters to the UsersRequest class based on which the users are fetched
searchRequestBuilderClass that allows you to set various parameters to the UsersRequest class based on which the users are searched
hideSeparatorWhen set to true, hides the separator between the individual elements in the list.
disableUsersPresenceWhen set to true, Users will not be able to see whether a particular user is currently online or offline.
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
listItemStyleStyling properties and values of the ListItem component
usersStyleStyling properties and values of the CometChatUsers component