> ## Documentation Index > Fetch the complete documentation index at: https://cometchat-22654f5b-feature-react-native-sdk-quotedmessage-a.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Property Changes ## Conversations ### New Properties | Name | Type | Description | | ---------------------------- | ------- | --------------------------------------------------------------------------- | | hideNavigationBar | Bool | Hides or shows the navigation bar in the conversations screen. | | hideSearch | Bool | Hides the search bar in the conversations screen. | | hideLoadingState | Bool | Hides the loading state indicator. | | hideDeleteConversationOption | Bool | Hides the option to delete a conversation. | | hideGroupType | Bool | Hides the group type indicator (private/public). | | backgroundDrawable | UIImage | Used to set a background image for the conversation screen. | | separatorColor | UIColor | Used to set the color of separators in the conversation list. | | separatorWidth | CGFloat | Used to set the width of separators in the conversation list. | | errorTextColor | UIColor | Used to set the color of error messages in the conversation UI. | | lastMessageTextColor | UIColor | Used to set the color of the last message text in the conversation list. | | typingIndicatorColor | UIColor | Used to set the color of the typing indicator in the conversation UI. | | lastMessageAppearance | UIFont | Used to customize the appearance of the last message text in the list. | | threadIndicatorAppearance | UIFont | Used to customize the appearance of thread indicators in the list. | | dateTimeFormatter.time | Closure | Called to format a timestamp as a standard time (e.g., "12:30 PM"). | | dateTimeFormatter.today | Closure | Called when rendering messages sent today. | | dateTimeFormatter.yesterday | Closure | Called for yesterday's messages. | | dateTimeFormatter.lastweek | Closure | Called for messages within the last week. | | dateTimeFormatter.otherDay | Closure | Called for dates older than last week. | | dateTimeFormatter.minute | Closure | Called when referring to "a minute ago". | | dateTimeFormatter.minutes | Closure | Called for "x minutes ago". | | dateTimeFormatter.hour | Closure | Called for "an hour ago". | | dateTimeFormatter.hours | Closure | Called for "x hours ago". | | set(OnItemLongClick:) | Method | Triggered when you long press on a ListItem of the Conversations component. | | set(onEmpty:) | Method | Triggered when the conversations list is empty. | ### Renamed Properties | v4 Name | v5 Name | Type | Description | | --------------------------- | ----------------- | ------ | -------------------------------------------------------- | | hide(error: Bool) | hideErrorView | Bool | Hides the error state view. | | show(backButton: Bool) | hideBackButton | Bool | Controls visibility of the back button (logic inverted). | | hide(receipt: Bool) | hideReceipts | Bool | Hides message read/delivery receipts. | | disable(userPresence: Bool) | hideUserStatus | Bool | Hides the online/offline status of users. | | setOnItemClick | set(OnItemClick:) | Method | Triggered when clicking on a ListItem. | | setOnBack | set(onBack:) | Method | Override action when back button is pressed. | | setOnSelection | set(onSelection:) | Method | Triggered upon completion of selection. | | setOnError | set(onError:) | Method | Override action when an error occurs. | ### Removed Properties | Name | Type | Description | | --------------------- | ------- | ----------------------------------------------------------------------------------------- | | hide(separator: Bool) | Bool | Used to control visibility of separators in the list view (replaced by style properties). | | disable(typing: Bool) | Bool | Used to toggle visibility of typing indicator. | | setDatePattern | Method | Method to set custom date pattern (replaced by dateTimeFormatter object). | | protectedGroupIcon | UIImage | Icon shown for password protected groups. | | sentIcon | UIImage | Receipt icon shown when message status is sent. | | deliveredIcon | UIImage | Receipt icon shown when message status is delivered. | | readIcon | UIImage | Receipt icon shown when message status is read. | ## Users ### New Properties | Name | Type | Description | | ----------------------------- | -------------------------------- | ---------------------------------------------------------------------- | | set(options:) | (User) -> \[CometChatUserOption] | Used to define custom options for each user. | | add(options:) | \[CometChatUserOption] | Used to dynamically add options to users. | | set(leadingView:) | (User) -> UIView | Custom leading view to be rendered for each user in the fetched list. | | set(titleView:) | (User) -> UIView | Custom title view to be rendered for each user in the fetched list. | | set(trailView:) | (User) -> UIView | Custom trailing view to be rendered for each user in the fetched list. | | set(onEmpty:) | () -> Void | Triggered when the users list is empty. | | hideErrorView | Bool | Hides the error state view. | | hideNavigationBar | Bool | Hides or shows the navigation bar. | | hideBackButton | Bool | Hides the back button. | | hideLoadingState | Bool | Hides the loading state indicator. | | hideUserStatus | Bool | Hides the online/offline status of users. | | hideSectionHeader | Bool | Hides the section header for table view indicating initials of users. | | hideSearch | Bool | Hides the search bar. | | set(searchKeyword:) | String | Sets a search keyword for filtering users. | | set(userRequestBuilder:) | UsersRequest.UsersRequestBuilder | Sets a custom request builder for fetching users. | | set(searchRequestBuilder:) | UsersRequest.UsersRequestBuilder | Sets a custom request builder for searching users. | | listItemSelectedImage | UIImage | Image shown when a list item is selected. | | listItemDeSelectedImage | UIImage | Image shown when a list item is deselected. | | searchIconTintColor | UIColor | Tint color for the search icon in the search bar. | | searchBarStyle | UISearchBar.Style | Style of the search bar (e.g., default, prominent). | | searchTintColor | UIColor? | Tint color for the search bar elements. | | searchBarTintColor | UIColor? | Background color for the search bar (excluding text input). | | searchBarPlaceholderTextColor | UIColor? | Color of the placeholder text in the search bar. | | searchBarPlaceholderTextFont | UIFont? | Font of the placeholder text in the search bar. | | searchBarTextColor | UIColor? | Color of the entered text in the search bar. | | searchBarTextFont | UIFont? | Font of the entered text in the search bar. | | searchBarBackgroundColor | UIColor? | Background color of the search bar's text input area. | | searchBarCancelIconTintColor | UIColor? | Tint color for the cancel button in the search bar. | | searchBarCrossIconTintColor | UIColor? | Tint color for the clear (cross) button in the search bar. | | backgroundColor | UIColor | Background color for the entire screen or view. | | borderWidth | CGFloat | Border width for the search bar or container. | | borderColor | UIColor | Color of the border. | | cornerRadius | CometChatCornerStyle | Corner radius for search bar or other elements. | | titleColor | UIColor | Text color for title elements within the list or navigation bar. | | titleFont | UIFont | Font for title text. | | largeTitleColor | UIColor | Text color for large titles. | | largeTitleFont | UIFont? | Font for large titles. | | navigationBarTintColor | UIColor | Tint color for the navigation bar background. | | navigationBarItemsTintColor | UIColor | Tint color for navigation bar items (buttons, icons). | | errorTitleTextFont | UIFont | Font for the error title displayed in UI. | | errorTitleTextColor | UIColor | Text color for the error title. | | errorSubTitleFont | UIFont | Font for the subtitle of error messages. | | errorSubTitleTextColor | UIColor | Text color for the subtitle of error messages. | | retryButtonTextColor | UIColor | Text color for the retry button in error states. | | retryButtonTextFont | UIFont | Font for the retry button text. | | retryButtonBackgroundColor | UIColor | Background color for the retry button. | | retryButtonBorderColor | UIColor | Border color for the retry button. | | retryButtonBorderWidth | CGFloat | Border width for the retry button. | | retryButtonCornerRadius | CometChatCornerStyle? | Corner radius for the retry button. | | emptyTitleTextFont | UIFont | Font for the empty state title (when no users/items are present). | | emptyTitleTextColor | UIColor | Text color for the empty state title. | | emptySubTitleFont | UIFont | Font for the subtitle in the empty state. | | emptySubTitleTextColor | UIColor | Text color for the subtitle in the empty state. | | tableViewSeparator | UIColor | Color for the table view separator. | | listItemTitleTextColor | UIColor | Text color for list item titles. | | listItemTitleFont | UIFont | Font for list item titles. | | listItemSubTitleTextColor | UIColor | Text color for list item subtitles. | | listItemSubTitleFont | UIFont | Font for list item subtitles. | | listItemBackground | UIColor | Background color for individual list items. | | listItemBorderWidth | CGFloat | Border width for individual list items. | | listItemBorderColor | UIColor | Border color for individual list items. | | listItemCornerRadius | CometChatCornerStyle | Corner radius for list items. | | listItemSelectionImageTint | UIColor | Tint color for selection indicator in list items. | | listItemSelectedBackground | UIColor | Background color for selected list items. | | listItemDeSelectedImageTint | UIColor | Tint color for the deselected state image. | | headerTitleColor | UIColor | Text color for section header titles in the list. | | headerTitleFont | UIFont | Font for section header titles. | ### Renamed Properties | Name | Type | Description | Old Name | | --------------------- | ---------------------------- | ---------------------------------------------------------------------------------- | ------------------ | | set(listItemView:) | (User) -> UIView | Custom list item view to be rendered for each user in the list. | setListItemView | | set(subtitleView:) | (User) -> UIView | Custom subtitle view to be rendered for each user in the fetched list. | setSubtitleView | | set(emptyView:) | UIView | Custom empty state view to be displayed when the user list is empty. | setEmptyStateView | | set(errorView:) | UIView | Custom error state view to be displayed when an error occurs while fetching users. | setErrorStateView | | set(onItemClick:) | (User) -> Void | Triggered when you click on a ListItem of the users component. | setOnItemClick | | set(onItemLongClick:) | (User) -> Void | Triggered when you long press on a ListItem of the users component. | setOnItemLongClick | | set(onBack:) | () -> Void | Triggered when the back button is pressed in the users component. | setOnBack | | set(onSelection:) | (\[User]) -> Void | Triggered on every selection when selection mode is set to multiple or single. | setOnSelection | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs in the users component. | setOnError | ### Removed Properties | Name | Type | Description | | ----------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------- | | set(loadingStateView:) | UIActivityIndicatorView\.Style | Used to set size of loading view icon while fetching the list of users. | | hide(errorText:) | Bool | Used to hide error text on fetching users. | | show(backButton:) | Bool | Used to toggle visibility for back button. | | set(searchIcon:) | UIImage? | Used to set search Icon in the search field. | | hide(search:) | Bool | Used to toggle visibility for search box. | | hide(separator:) | Bool | Used to hide the divider separating the user items. | | disable(userPresence:) | Bool | Used to control visibility of user indicator shown if user is online. | | set(emptyStateText:) | String | Used to set a custom text response when fetching the users has returned an empty list. | | set(errorStateText:) | String | Used to set a custom text response when some error occurs on fetching the list of users. | | set(searchPlaceholder:) | String | Used to set search placeholder text. | | set(title:mode:) | String, UINavigationItem.LargeTitleDisplayMode | Used to set title in the app with display mode. | | setOnLoad | (\[User]) -> Void | Gets triggered when a user list is fully fetched and displayed on the screen. | ## Groups ### New Properties | Name | Type | Description | | --------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | set(onSelection:) | Closure | Gets triggered when selection mode is set to multiple or single. Triggers on every selection and returns the list of selected groups. | | set(onEmpty:) | Closure | Gets triggered when the groups list is empty in CometChatGroups. | | setOnLoad | Closure | Gets triggered when a group list is fully fetched and going to be displayed on the screen. Returns the list of groups to be displayed. | | listItemSelectedImage | UIImage | Check box image when a list item is selected. | | listItemDeSelectedImage | UIImage | Check box image when a list item is deselected. | | searchIconTintColor | UIColor | Tint color for the search icon, defaults to the secondary icon color from CometChatTheme. | | searchBarStyle | UISearchBarStyle | Style of the search bar, defaulting to the standard style. | | searchTintColor | UIColor | Tint color for the search bar, defaults to the primary color from CometChatTheme. | | searchBarTintColor | UIColor | Background color of the search bar, defaulting to clear. | | searchBarPlaceholderTextColor | UIColor | Placeholder text color for the search bar, defaults to the tertiary text color from CometChatTheme. | | searchBarPlaceholderTextFont | UIFont | Font used for the placeholder text in the search bar, defaults to regular body font. | | searchBarTextColor | UIColor | Color of the text entered in the search bar, defaults to the primary text color from CometChatTheme. | | searchBarTextFont | UIFont | Font used for the text in the search bar, defaults to regular body font. | | searchBarBackgroundColor | UIColor | Background color of the search bar, defaults to a specific background color from CometChatTheme. | | searchBarCancelIconTintColor | UIColor | Tint color for the cancel icon in the search bar, defaults to the primary color from CometChatTheme. | | searchBarCrossIconTintColor | UIColor | Tint color for the cross icon in the search bar, defaults to the secondary icon color from CometChatTheme. | | backgroundColor | UIColor | Background color of the overall view, defaults to a specific background color from CometChatTheme. | | borderWidth | CGFloat | Width of the border around the view, defaults to 0 (no border). | | borderColor | UIColor | Color of the border around the view, defaults to clear. | | cornerRadius | CometChatCornerStyle | Corner radius settings for the view, defaults to no corner radius. | | titleColor | UIColor | Color for the title text, defaults to the primary text color from CometChatTheme. | | titleFont | UIFont | Font used for the title text, defaults to nil (not set). | | largeTitleColor | UIColor | Color for the large title text, defaults to the primary text color from CometChatTheme. | | largeTitleFont | UIFont | Font used for the large title text, defaults to nil (not set). | | navigationBarTintColor | UIColor | Background color of the navigation bar, defaults to a specific background color from CometChatTheme. | | navigationBarItemsTintColor | UIColor | Tint color for items in the navigation bar, defaults to the highlight color from CometChatTheme. | | errorTitleTextFont | UIFont | Font used for the error title text, defaults to a bold heading 3 font from CometChatTypography. | | errorTitleTextColor | UIColor | Color of the error title text, defaults to the primary text color from CometChatTheme. | | errorSubTitleFont | UIFont | Font used for the error subtitle text, defaults to regular body font. | | errorSubTitleTextColor | UIColor | Color of the error subtitle text, defaults to the secondary text color from CometChatTheme. | | retryButtonTextColor | UIColor | Color for the retry button text, defaults to button text color from CometChatTheme. | | retryButtonTextFont | UIFont | Font used for the retry button text, defaults to medium button font from CometChatTypography. | | retryButtonBackgroundColor | UIColor | Background color for the retry button, defaults to the primary color from CometChatTheme. | | retryButtonBorderColor | UIColor | Border color for the retry button, defaults to clear. | | retryButtonBorderWidth | CGFloat | Width of the border around the retry button, defaults to 0 (no border). | | retryButtonCornerRadius | CometChatCornerStyle | Corner radius settings for the retry button, defaults to a specific corner radius from CometChatSpacing. | | emptyTitleTextFont | UIFont | Font used for the empty state title text, defaults to a bold heading 3 font from CometChatTypography. | | emptyTitleTextColor | UIColor | Color of the empty state title text, defaults to the primary text color from CometChatTheme. | | emptySubTitleFont | UIFont | Font used for the empty state subtitle text, defaults to regular body font. | | emptySubTitleTextColor | UIColor | Color of the empty state subtitle text, defaults to the secondary text color from CometChatTheme. | | tableViewSeparator | UIColor | Color of the table view separator, defaults to clear. | | listItemTitleTextColor | UIColor | Color of the title text in list items, defaults to the primary text color from CometChatTheme. | | listItemTitleFont | UIFont | Font used for the title text in list items, defaults to medium heading 4 font from CometChatTypography. | | listItemSubTitleTextColor | UIColor | Color of the subtitle text in list items, defaults to the secondary text color from CometChatTheme. | | listItemSubTitleFont | UIFont | Font used for the subtitle text in list items, defaults to regular body font. | | listItemBackground | UIColor | Background color for list items, defaults to clear. | | listItemSelectedBackground | UIColor | Background color for list items if selected, defaults to clear. | | listItemBorderWidth | CGFloat | Width of the border around list items, defaults to 0 (no border). | | listItemBorderColor | UIColor | Color of the border around list items, defaults to the light border color from CometChatTheme. | | listItemCornerRadius | CometChatCornerStyle | Corner radius settings for list items, defaults to no corner radius. | | listItemSelectionImageTint | UIColor | Tint color for the selection image in list items, defaults to the highlight color from CometChatTheme. | | listItemDeSelectedImageTint | UIColor | Tint color for the deselected image in list items. | | passwordGroupImageTintColor | UIColor | Tint color for the password group image, defaults to the background color from CometChatTheme. | | passwordGroupImageBackgroundColor | UIColor | Background color for the password group image, defaults to the warning color from CometChatTheme. | | privateGroupImageTintColor | UIColor | Tint color for the private group image, defaults to the background color from CometChatTheme. | | privateGroupImageBackgroundColor | UIColor | Background color for the private group image, defaults to the success color from CometChatTheme. | | privateGroupIcon | UIImage | Image for a private group icon. | | protectedGroupIcon | UIImage | Image for a protected group icon. | | set(groupsRequestBuilder:) | GroupsRequest.GroupsRequestBuilder | Sets the request builder for fetching groups. | | set(searchRequestBuilder:) | GroupsRequest.GroupsRequestBuilder | Sets the request builder for searching groups. | | set(searchKeyword:) | String | Sets the search keyword to filter groups. | | hideErrorView | Bool | Hides the error state view. | | hideNavigationBar | Bool | Hides or shows the navigation bar. | | hideSearch | Bool | Hides the search bar. | | hideBackButton | Bool | Hides the back button. | | hideLoadingState | Bool | Hides the loading state indicator. | | hideReceipts | Bool | Hides message read/delivery receipts. | | hideDeleteConversationOption | Bool | Hides the option to delete a conversation. | | hideUserStatus | Bool | Hides the online/offline status of users. | | hideGroupType | Bool | Hides the group type (private/public). | | set(options:) | (Group?) -> \[CometChatGroupOption] | Allows you to define custom options for each group. Returns an array of CometChatGroupOption based on the group object. | | add(options:) | (Group?) -> \[CometChatGroupOption] | Dynamically adds options to groups. Returns additional CometChatGroupOption elements. | | set(leadingView:) | (Group?) -> UIView | Allows you to modify the leading view of a group cell. | | set(titleView:) | (Group?) -> UIView | Allows you to customize the title view of a group cell. | | set(trailView:) | (Group?) -> UIView | Allows you to modify the trailing view of a group cell. | ### Renamed Properties | Name | Type | Description | Old Name | | --------------------- | ------------------ | -------------------------------------------------------------------- | ------------------ | | set(onItemClick:) | Closure | Triggered when you click on a ListItem of the groups component. | SetOnItemClick | | set(OnItemLongClick:) | Closure | Triggered when you long press on a ListItem of the groups component. | SetOnItemLongClick | | set(onError:) | Closure | Triggered when an error occurs in CometChatGroups. | SetOnError | | set(onBack:) | Closure | Triggered when the back button is pressed in CometChatGroups. | SetOnBack | | SetListItemView | (Group?) -> UIView | Assigns a custom ListItem to the Groups Component. | setListItemView | | SetSubTitleView | (Group?) -> UIView | Allows you to customize the subtitle view for each group item. | setSubtitleView | ### Removed Properties No properties were removed in v5. All v4 properties have been retained (with some renamed) and additional functionality has been added. ## Group Members ### New Properties | Name | Type | Description | | --------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------- | | retryButtonTextColor | UIColor | Sets the text color for the retry button. | | retryButtonTextFont | UIFont | Sets the text font for the retry button. | | retryButtonBackgroundColor | UIColor | Sets the background color for the retry button. | | retryButtonBorderColor | UIColor | Sets the border color for the retry button. | | retryButtonBorderWidth | CGFloat | Sets the border width for the retry button. | | retryButtonCornerRadius | CometChatCornerStyle | Sets the corner radius for the retry button. | | listItemSelectedBackground | UIColor | Sets the background color for selected list items. | | listItemDeSelectedImageTint | UIColor | Sets the tint color for deselected list item images. | | listItemSelectionImageTint | UIColor | Sets the tint color for selected list item images. | | listItemSelectedImage | UIImage | Sets the image for selected list items. | | listItemDeSelectedImage | UIImage | Sets the image for deselected list items. | | largeTitleColor | UIColor? | Sets the color for the large title text. | | navigationBarTintColor | UIColor? | Sets the tint color for the navigation bar. | | navigationBarItemsTintColor | UIColor? | Sets the tint color for navigation bar items. | | errorTitleTextFont | UIFont | Sets the font for the error title text. | | errorTitleTextColor | UIColor | Sets the color for the error title text. | | errorSubTitleFont | UIFont | Sets the font for the error subtitle text. | | errorSubTitleTextColor | UIColor | Sets the color for the error subtitle text. | | emptyTitleTextFont | UIFont | Sets the font for the empty state title text. | | emptyTitleTextColor | UIColor | Sets the color for the empty state title text. | | emptySubTitleFont | UIFont | Sets the font for the empty state subtitle text. | | emptySubTitleTextColor | UIColor | Sets the color for the empty state subtitle text. | | tableViewSeparator | UIColor | Sets the color for the table view separator. | | listItemTitleTextColor | UIColor | Sets the text color for list item titles. | | listItemTitleFont | UIFont | Sets the font for list item titles. | | listItemSubTitleTextColor | UIColor | Sets the text color for list item subtitles. | | listItemSubTitleFont | UIFont | Sets the font for list item subtitles. | | listItemBackground | UIColor | Sets the background color for list items. | | listItemBorderWidth | CGFloat | Sets the border width for list items. | | listItemBorderColor | UIColor | Sets the border color for list items. | | listItemCornerRadius | CometChatCornerStyle | Sets the corner radius for list items. | | messageTypeImageTint | UIColor | Sets the tint color for message type icons. | | passwordGroupImageTintColor | UIColor | Sets the tint color for password group icons. | | passwordGroupImageBackgroundColor | UIColor | Sets the background color for password group icons. | | privateGroupImageTintColor | UIColor | Sets the tint color for private group icons. | | privateGroupImageBackgroundColor | UIColor | Sets the background color for private group icons. | | backgroundColor | UIColor | Sets the background color for the component. | | set(groupMembersRequestBuilder:) | GroupMembersRequest.GroupMembersRequestBuilder | Sets the request builder for fetching group members. | | set(searchRequestBuilder:) | GroupMembersRequest.GroupMembersRequestBuilder | Sets the request builder for searching group members. | | set(searchKeyword:) | String | Sets the search keyword to filter group members. | | hideError | Bool | Hides the error state view. | | hideUserStatus | Bool | Hides the online/offline status of users. | | hideNavigationBar | Bool | Hides or shows the navigation bar. | | hideLoadingState | Bool | Hides the loading state indicator. | | hideBackIcon | Bool | Hides the back button/icon. | | hideKickMemberOption | Bool | Hides the option to kick a member from the group. | | hideBanMemberOption | Bool | Hides the option to ban a member from the group. | | hideScopeChangeOption | Bool | Hides the option to change a member's scope (role). | | hideSearch | Bool | Hides the search bar. | | set(onSelection:) | (\[GroupMember]) -> Void | Triggers on every selection and returns the list of selected group members. | | set(onEmpty:) | () -> Void | Triggers when the groups list is empty. | | set(onLoad:) | (\[GroupMember]) -> Void | Triggers when group members list is fully fetched and displayed. | | set(onItemClick:) | (GroupMember, IndexPath) -> Void | Triggered when you click on a ListItem. | | set(onItemLongClick:) | (GroupMember, IndexPath) -> Void | Triggered when you long press on a ListItem. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(onBack:) | () -> Void | Triggered when back button is pressed. | | set(leadingView:) | (GroupMember?) -> UIView | Sets a custom leading view for group member cells. | | set(titleView:) | (GroupMember?) -> UIView | Sets a custom title view for group member cells. | | set(loadingView:) | UIView | Sets a custom loading view displayed while data is being fetched. | | set(errorView:) | UIView | Sets a custom error view that appears when an error occurs. | | set(emptyView:) | UIView | Sets a custom empty state view when no group members are available. | | setListItemView | (GroupMember?) -> UIView | Assigns a custom ListItem to the GroupMembers component. | | setSubtitleView | (GroupMember?) -> UIView | Sets a custom subtitle view for each GroupMembers item. | | setTailView | (GroupMember?) -> UIView | Sets a custom tail view for group member cells. | | setOptions | \[CometChatGroupMemberOption] | Sets custom options for swipe actions. | | set(menus:) | UIView | Sets custom menus to add more options. | ### Renamed Properties | Name | Type | Description | Old Name | | --------------------- | -------------------------------- | -------------------------------------------------------------------------- | ---------------------- | | backgroundColor | UIColor | Sets the background color for the component. | background | | hideUserStatus | Bool | Hides/disables the online/offline status of users. | disable(userPresence:) | | hideSearch | Bool | Hides the search bar. | hide(search:) | | hideUserStatus | Bool | Hide user presence. If set to true, the status indicator is not displayed. | disableUsersPresence | | set(onItemClick:) | (GroupMember, IndexPath) -> Void | Triggered when you click on a ListItem. | setOnItemClick | | set(onItemLongClick:) | (GroupMember, IndexPath) -> Void | Triggered when you long press on a ListItem. | setOnItemLongClick | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | setOnError | | set(onBack:) | () -> Void | Triggered when back button is pressed. | setOnBack | ### Removed Properties | Name | Type | Description | | ----------------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------- | | backIconTint | UIColor | Sets the back button tint color. | | searchIconTint | UIColor | Sets the search icon tint color. | | searchTextFont | UIFont | Sets the search text font. | | searchTextColor | UIColor | Sets the search text color. | | searchCancelButtonTint | UIColor | Sets the search cancel icon tint. | | searchPlaceholderFont | UIFont | Sets the search placeholder font. | | searchPlaceholderColor | UIColor | Sets the search placeholder color. | | addButtonTint | UIColor | Sets add button color. | | addButtonFont | UIFont | Sets add button font. | | avatarStyle | AvatarStyle | Styles to apply to the avatar component of the default list item view. | | statusIndicatorStyle | CSSProperties | Styles to apply to the status indicator component of the default list item view. | | listItemStyle | ListItemStyle | Styles to apply to the default list item view. | | groupScopeStyle | ChangeScopeStyle | Styles to apply to the change scope component. | | groupMembersStyle | GroupMembersStyle | Styles to apply to this component. | | set(title:mode:) | String, UINavigationItem.LargeTitleDisplayMode | Custom title for the component. | | set(backButtonTitle:) | String? | Custom text for the back button. | | set(searchPlaceholder:) | String | Custom placeholder text for search field. | | show(backButton:) | Bool | Whether to show the back button. | | set(errorStateText:) | String | Custom error state text. | | set(backButtonIcon:) | UIImage | Custom back button icon. | | set(passwordPlaceholderText:) | String | Custom placeholder text for password. | | hide(continueButton:) | Bool | Whether to hide the continue button. | | set(searchIcon:) | UIImage | Sets the icon for the search bar. | | set(searchClearIcon:) | UIImage | Sets the clear icon for the search bar. | | set(searchBarHeight:) | CGFloat | Set the height for the search bar. | | selectionMode(mode:) | SelectionMode | Enables selection mode (.single, .multiple). | | hide(separator:) | Bool | Hide/unhide the separator. | | clearList() | - | Clears the users locally. | | update(groupMember:) | GroupMember | Updates member object locally. | | remove(groupMember:) | GroupMember | Removes member object locally. | | size() | - | Returns the count of members displayed. | | title | String | Title of the component. | | searchPlaceholder | String | Text to be displayed when the search input has no value. | | fetchTimeOut | any | Timeout reference for fetching users. | | userPresencePlacement | UserPresencePlacement | Placement of user presence information within the user interface. | | backButtonIconURL | String | Image URL for the back button. | | showBackButton | Bool | Show back button. | | closeButtonIconURL | String | Image URL for the close button. | | dropDownIconURL | String | Image URL for the change scope component's arrowIconURL prop. | | emptyStateText | String | Text to display in the default empty view. | | errorStateText | String | Text to display in the default error view. | | loadingIconURL | String | Image URL for the default loading view. | | hideSeparator | Bool | Hide the separator at the bottom of the default list item view. | | titleAlignment | TitleAlignment | Alignment of the title text. | | searchIconURL | String | Image URL for the search icon to use in the search bar. | | fetchingUsers | Bool | Flag to indicate whether users are currently being fetched. | | onClose | () -> Void | Function to call when the close button is clicked. | | headerView | UIView | Custom header view which will replace the title as well. | ## Message Header ### New Properties | Name | Type | Description | | ----------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------- | | titleTextColor | UIColor | Used to set the text color of the header title. | | titleTextFont | UIFont | Used to set the font style of the header title. | | subtitleTextColor | UIColor | Used to set the text color of the subtitle in the header. | | subtitleTextFont | UIFont | Used to set the font style of the subtitle in the header. | | backButtonImageTintColor | UIColor | Used to set the tint color of the back button image in the header. | | privateGroupBadgeImageTintColor | UIColor | Used to set the tint color of the private group badge in the header. | | passwordProtectedGroupBadgeImageTintColor | UIColor | Used to set the tint color of the password-protected group badge in the header. | | privateGroupImageBackgroundColor | UIColor | Used to set the background color of the private group badge. | | passwordGroupImageBackgroundColor | UIColor | Used to set the background color of the password-protected group badge. | | groupImageBackgroundColor | UIColor | Used to set the background color for group icons in the header. | | avatarStyle | AvatarStyle | Used to customize the appearance of the avatar in the header. | | backgroundColor | UIColor | Used to set the background color of the header. | | cornerRadius | CometChatCornerStyle | Used to set the corner radius of the header. | | borderWidth | CGFloat | Used to set the border width of the header. | | borderColor | UIColor | Used to set the border color of the header. | | backButtonIcon | UIImage | Used to set a custom icon for the back button. | | privateGroupIcon | UIImage | Used to set a custom icon for private groups. | | protectedGroupIcon | UIImage | Used to set a custom icon for password-protected groups. | | backgroundImage | UIImage | Used to set a background image for the header. | | hideBackButton | Bool | Hides the back button of message header. | | hideUserStatus | Bool | Hides or shows the user status of user (online/offline/last active at). | | hideVideoCallButton | Bool | Hides the video call button. | | hideVoiceCallButton | Bool | Hides the voice call button. | | set(onBack:) | () -> Void | Triggered when back button is pressed. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(listItemView:) | (User?, Group?) -> UIView | Assigns a custom ListItem to the message header component. | | set(leadingView:) | (User?, Group?) -> UIView | Sets a custom leading view for message header. | | set(titleView:) | (User?, Group?) -> UIView | Sets a custom title view for message header. | | set(trailView:) | (User?, Group?) -> UIView | Sets a custom trailing view for message header. | | set(subtitleView:) | (User?, Group?) -> UIView | Sets a custom subtitle view for message header. | | dateTimeFormatter | CometChatDateTimeFormatter | Supports full customization of how date and time are displayed. | ### Renamed Properties | Name | Type | Description | Old Name | | ------------------------ | ------------------------- | ----------------------------------------------------------- | -------------------------- | | backgroundColor | UIColor | Sets the background color for the component. | background | | backButtonImageTintColor | UIColor | Sets the tint color of the back button image in the header. | backIconTint | | hideBackButton | Bool | Hides the back button of message header. | hide(backButton:) | | hideUserStatus | Bool | Hides or shows the user status of user. | set(disableUsersPresence:) | | set(menus:) | (User?, Group?) -> UIView | Sets custom menus to add more options. | setMenus | | set(subtitleView:) | (User?, Group?) -> UIView | Sets a custom subtitle view for message header. | setSubtitleView | ### Removed Properties | Name | Type | Description | | --------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------- | | typingIndicatorTextFont | UIFont | Sets the typing indicator text font. | | typingIndicatorTextColor | UIColor | Sets the typing indicator text color. | | detailIconTint | UIColor | Sets the tint color for detail icon for message header. | | onlineStatusColor | UIColor | Sets the online status color for message header. | | privateGroupIconBackgroundColor | UIColor | Sets the private group background color for message header (replaced by privateGroupImageBackgroundColor). | | protectedGroupIconBackgroundColor | UIColor | Sets the protected group background color for message header (replaced by passwordGroupImageBackgroundColor). | | set(protectedGroupIcon:) | UIImage | Used to set custom protected group icon. | | set(privateGroupIcon:) | UIImage | Used to set custom private group icon. | | disable(typing:) | Bool | Used to enable/disable typing indicators. | ## Message List ### New Properties | Name | Type | Description | | ------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------- | | hideAvatar | Bool | Hides the avatar of the sender. | | hideGroupActionMessages | Bool | Hides group action messages (like join/leave notifications). | | hideReplyInThreadOption | Bool | Hides the reply in thread option. | | hideTranslateMessageOption | Bool | Hides the message translation option. | | hideEditMessageOption | Bool | Hides the edit message option. | | hideDeleteMessageOption | Bool | Hides the delete message option. | | hideReactionOption | Bool | Hides the reaction option on messages. | | hideMessagePrivatelyOption | Bool | Hides the option to message privately. | | hideCopyMessageOption | Bool | Hides the option to copy a message. | | hideMessageInfoOption | Bool | Hides the message info option. | | hideHeaderView | Bool | Hides the header view of the message list. | | hideFooterView | Bool | Hides the footer view of the message list. | | hideDateSeparator | Bool | Hides the date separator between messages. | | scrollToBottomOnNewMessages | Bool | Scrolls to the bottom when new messages arrive. | | hideReceipts | Bool | Hides the message read receipts (ticks). | | disableSoundForMessages | Bool | Disables the sound when a new message arrives. | | hideEmptyView | Bool | Hides the empty state view when no messages are available. | | hideErrorView | Bool | Hides the error view when an error occurs. | | hideLoadingView | Bool | Hides the loading view when fetching messages. | | hideNewMessageIndicator | Bool | Hides the "new message" indicator. | | backgroundColor | UIColor | Background color with dynamic support for light and dark mode. | | borderWidth | CGFloat | Border width for the component. | | borderColor | UIColor | Border color for the component. | | cornerRadius | CometChatCornerStyle | Corner radius for the component. | | shimmerGradientColor1 | UIColor | First color of the shimmer gradient. | | shimmerGradientColor2 | UIColor | Second color of the shimmer gradient. | | emptyStateTitleColor | UIColor | Text color for the title in the empty state. | | emptyStateTitleFont | UIFont | Font for the title in the empty state. | | emptyStateSubtitleColor | UIColor | Text color for the subtitle in the empty state. | | emptyStateSubtitleFont | UIFont | Font for the subtitle in the empty state. | | errorStateTitleColor | UIColor | Text color for the title in the error state. | | errorStateTitleFont | UIFont | Font for the title in the error state. | | errorStateSubtitleColor | UIColor | Text color for the subtitle in the error state. | | errorStateSubtitleFont | UIFont | Font for the subtitle in the error state. | | threadedMessageImage | UIImage | Icon image for threaded messages. | | errorImage | UIImage | Icon image for error state. | | emptyImage | UIImage | Icon image for empty state. | | newMessageIndicatorImage | UIImage | Icon image for new message indicator. | | backgroundImage | UIImage | Background image for the component. | | scrollToBottom(isAnimated:) | Bool | Scrolls to the bottom of the message list. | | set(messageAlignment:) | MessageListAlignment | Sets the alignment of messages in the list. | | set(smartRepliesKeywords:) | \[String] | Sets keywords for smart replies. | | set(smartRepliesDelayDuration:) | Int | Sets the delay duration for smart replies. | | set(user:parentMessage:) | User, BaseMessage? | Sets the user and an optional parent message. | | set(group:parentMessage:) | Group, BaseMessage? | Sets the group and an optional parent message. | | set(messagesRequestBuilder:) | MessagesRequest.MessageRequestBuilder | Sets the message request builder. | | set(reactionsRequestBuilder:) | ReactionsRequest.ReactionsRequestBuilder | Sets the reactions request builder. | | set(parentMessageId:) | Int | Sets the parent message ID. | | set(onThreadRepliesClick:) | (BaseMessage, CometChatMessageTemplate) -> Void | Triggered when you click on the thread indicator of message bubble. | | set(onReactionClick:) | (CometChat.ReactionCount, BaseMessage) -> Void | Triggered when you click on a reaction on a message bubble. | | set(onReactionListItemClick:) | (CometChat.Reaction, BaseMessage) -> Void | Triggered when you click on the list item of CometChatReactionList. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(onEmpty:) | () -> Void | Triggers when the message list is empty. | | set(onLoad:) | (\[BaseMessage]) -> Void | Triggers when message list is fully fetched and displayed. | | set(headerView:) | UIView | Sets a custom header view for message list. | | set(footerView:) | UIView | Sets a custom footer view for message list. | | set(dateSeparatorPattern:) | (Int?) -> String | Sets the date separator pattern using a closure. | | set(datePattern:) | (Int?) -> String | Sets the date pattern using a closure. | | set(timePattern:) | (Int?) -> String | Sets the time pattern using a closure. | | set(textFormatter:) | \[CometChatTextFormatter] | Sets the list of text formatters. | | set(loadingView:) | UIView | Sets a custom loading view displayed while data is being fetched. | | set(errorView:) | UIView | Sets a custom error view that appears when an error occurs. | | set(emptyView:) | UIView | Sets a custom empty state view when no messages are available. | | set(templates:) | \[CometChatMessageTemplate] | Sets message templates to MessageList. | | dateTimeFormatter | CometChatDateTimeFormatter | Supports full customization of how date and time are displayed. | | set(controller:) | UIViewController | Sets the controller (mandatory for proper configuration). | ### Renamed Properties | Name | Type | Description | Old Name | | ---------------------- | -------------------- | -------------------------------------------- | -------------- | | hideReceipts | Bool | Hides the message read receipts. | hide(receipt:) | | hideAvatar | Bool | Shows/hides the avatar of the sender. | show(avatar:) | | backgroundColor | UIColor | Sets the background color for the component. | background | | set(messageAlignment:) | MessageListAlignment | Sets the alignment of messages in the list. | alignment | ### Removed Properties | Name | Type | Description | | ------------------------------- | ------------------------------- | --------------------------------------------------------------------- | | loadingIconTint | UIColor | Used to set loading icon tint. | | emptyTextFont | UIFont | Used to set empty state text font. | | errorTextFont | UIFont | Used to set error text font. | | emptyTextColor | UIColor | Used to set empty state text color. | | errorTextColor | UIColor | Used to set error state text color. | | nameTextColor | UIColor | Used to set sender/receiver name text color on a message bubble. | | nameTextFont | UIFont | Used to set sender/receiver name text appearance on a message bubble. | | timestampTextColor | UIColor | Used to set time stamp text color. | | threadReplySeperatorColor | UIColor | Used to set thread reply separator color. | | threadReplyTextColor | UIColor | Used to set thread reply text color. | | threadReplyTextFont | UIFont | Used to set thread reply text appearance. | | hide(error:) | Bool | Used to hide the error view. | | messageInformationConfiguration | MessageInformationConfiguration | Configuration for message information component. | | reactionsConfiguration | ReactionsConfiguration | Configuration for reactions component. | | setDateSeparatorPattern | (Int?) -> String | Used to modify the date pattern of the message list date separator. | | setDatePattern | (Int?) -> String | Used to modify the date pattern. | | setHeaderView | UIView | Used to set custom header view (now set(headerView:)). | | setFooterView | UIView | Used to set custom footer view (now set(footerView:)). | | setTextFormatters | \[CometChatTextFormatter] | Used to set text formatters (now set(textFormatter:)). | | setMentionsFormatters | \[CometChatTextFormatter] | Used to set mentions formatters (merged into set(textFormatter:)). | | setErrorStateView | UIView | Used to set custom error view (now set(errorView:)). | | setEmptyStateView | UIView | Used to set custom empty state view (now set(emptyView:)). | | setOnThreadRepliesClick | Closure | Callback for thread replies click (now set(onThreadRepliesClick:)). | ## Message Composer ### New Properties | Name | Type | Description | | -------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------- | | placeHolderTextFont | UIFont | Font for the placeholder text in the input field. | | placeHolderTextColor | UIColor | Color for the placeholder text in the input field. | | textFiledColor | UIColor | Text color for the input field. | | textFiledFont | UIFont | Font for the input field text. | | backgroundColor | UIColor | Background color with dynamic support for light and dark mode. | | cornerRadius | CometChatCornerStyle | Corner radius for the composer. | | borderWidth | CGFloat | Border width for the composer. | | borderColor | UIColor | Border color for the composer. | | sendButtonImage | UIImage | Icon for the send button. | | sendButtonImageTint | UIColor | Tint color for the send button image. | | activeSendButtonImageBackgroundColor | UIColor | Background color for the send button when active. | | inactiveSendButtonImageBackgroundColor | UIColor | Background color for the send button when inactive. | | composeBoxBackgroundColor | UIColor | Background color for the compose box. | | composeBoxBorderColor | UIColor | Border color for the compose box. | | composeBoxBorderWidth | CGFloat | Border width for the compose box. | | composerBoxCornerRadius | CometChatCornerStyle | Corner radius for the compose box. | | composerSeparatorColor | UIColor | Color for the separator in the compose box. | | attachmentImage | UIImage | Icon for the attachment button. | | attachmentImageTint | UIColor | Tint color for the attachment image. | | voiceRecordingImage | UIImage | Icon for the voice recording button. | | voiceRecordingImageTint | UIColor | Tint color for the voice recording image. | | aiImage | UIImage | Icon for the AI button. | | aiImageTint | UIColor | Tint color for the AI image. | | stickerImage | UIImage | Icon for the sticker button. | | stickerTint | UIColor | Tint color for the sticker image. | | editPreviewTitleTextFont | UIFont | Font for the title in the edit preview. | | editPreviewMessageTextFont | UIFont | Font for the message text in the edit preview. | | editPreviewTitleTextColor | UIColor | Text color for the title in the edit preview. | | editPreviewMessageTextColor | UIColor | Text color for the message in the edit preview. | | editPreviewBackgroundColor | UIColor | Background color for the edit preview. | | editPreviewCornerRadius | CometChatCornerStyle | Corner radius for the edit preview. | | editPreviewBorderColor | UIColor | Border color for the edit preview. | | editPreviewBorderWidth | CGFloat | Border width for the edit preview. | | editPreviewCloseIcon | UIImage | Icon for closing the edit preview. | | editPreviewCloseIconTint | UIColor | Tint color for the close icon in the edit preview. | | infoIcon | UIImage | Icon for the info button. | | infoIconTint | UIColor | Tint color for the info icon. | | infoTextColor | UIColor | Text color for the info text. | | infoTextFont | UIFont | Font for the info text. | | infoSeparatorColor | UIColor | Color for the separator in the info section. | | infoBackgroundColor | UIColor | Background color for the info section. | | infoCornerRadius | CometChatCornerStyle | Corner radius for the info section. | | infoBorderColor | UIColor | Border color for the info section. | | infoBorderWidth | CGFloat | Border width for the info section. | | setInitialComposerText | String | Sets the initial text in the composer when it loads. | | disableTypingEvents | Bool | Disables sending typing indicators when the user types. | | disableMentions | Bool | Disables the mention feature in the composer. | | hideImageAttachmentOption | Bool | Hides the option to attach images. | | hideVideoAttachmentOption | Bool | Hides the option to attach videos. | | hideAudioAttachmentOption | Bool | Hides the option to attach audio files. | | hideFileAttachmentOption | Bool | Hides the option to attach files. | | hidePollsOption | Bool | Hides the option to create polls. | | hideCollaborativeDocumentOption | Bool | Hides the option for collaborative documents. | | hideCollaborativeWhiteboardOption | Bool | Hides the option for collaborative whiteboards. | | hideAttachmentButton | Bool | Hides the attachment button in the composer. | | hideVoiceRecordingButton | Bool | Hides the voice recording button. | | hideStickersButton | Bool | Hides the stickers button. | | hideSendButton | Bool | Hides the send button. | | set(user:) | User | Sets the user for direct messaging. | | set(group:) | Group | Sets the group for group messaging. | | set(parentMessageId:) | Int | Sets the parent message ID for replying in a thread. | | set(maxLine:) | Int | Sets the maximum number of lines for the composer input. | | set(customSoundForMessages:) | URL? | Sets a custom sound for sending messages. | | disableSoundForMessages | Bool | Disables sound while sending messages. | | set(onSendButtonClick:) | (BaseMessage) -> Void | Override the action triggered upon pressing the send button. | | set(onTextChanged:) | (String) -> Void | Gets activated when the user starts typing in message composer. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(attachmentOptions:) | (User?, Group?, UIViewController?) -> \[CometChatMessageComposerAction] | Sets a list of custom MessageComposerActions. | | set(sendButtonView:) | (User?, Group?) -> UIView | Sets a custom send button for the MessageComposer Component. | | set(headerView:) | (User?, Group?) -> UIView | Sets a custom header view for the MessageComposer Component. | | set(footerView:) | (User?, Group?) -> UIView | Sets a custom footer view for the MessageComposer Component. | | set(textFormatter:) | \[CometChatTextFormatter] | Assigns the list of text formatters. | | set(controller:) | UIViewController | Sets the controller (mandatory for proper configuration). | | mediaRecorderStyle | MediaRecorderStyle | Customizes the media recording styling. | | aiOptionsStyle | AIOptionsStyle | Customizes the AI options styling. | ### Renamed Properties | Name | Type | Description | Old Name | | ------------------------ | ------------------------- | ------------------------------------------------------- | --------------------------------- | | backgroundColor | UIColor | Sets the background color for the component. | background | | hideVoiceRecordingButton | Bool | Hides the voice recording button. | hide(voiceRecording:) | | disableTypingEvents | Bool | Disables sending typing indicators when the user types. | disable(disableTypingEvents:) | | disableSoundForMessages | Bool | Disables sound while sending messages. | disable(disableSoundForMessages:) | | set(textFormatter:) | \[CometChatTextFormatter] | Assigns the list of text formatters. | setMentionsFormatters | ### Removed Properties | Name | Type | Description | | ------------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------- | | inputBackground | UIColor | Sets the input background color of message composer. | | textFont | UIFont | Sets the input text font of message composer. | | inputBoxPlaceholderFont | UIFont | Sets the placeholder text font for message composer input field. | | placeHolderTextColor | UIColor | Sets the placeholder text color for message composer input field (renamed with different casing). | | attachmentIconTint | UIColor | Sets the attachment icon tint color. | | sendIconTint | UIColor | Sets send button icon tint color. | | separatorTint | UIColor | Sets the separator color for message composer. | | inputBorderWidth | CGFloat | Sets the border width for message composer input view. | | inputBorderColor | UIColor | Sets the border color for message composer input view. | | actionSheetTitleColor | UIColor | Sets the title color for action sheet of message composer. | | actionSheetTitleFont | UIFont | Sets the title font for action sheet of message composer. | | actionSheetLayoutModelIconTint | UIColor | Sets action sheet layout mode icon tint color for message composer. | | actionSheetCancelButtonIconTint | UIColor | Sets action sheet cancel button icon tint color for message composer. | | actionSheetCancelButtonIconFont | UIFont | Sets the action sheet cancel button icon font color for message composer. | | actionSheetSeparatorTint | UIColor | Sets the separator color for action sheet items. | | actionSheetBackground | UIColor | Sets the background color of action sheet. | | voiceRecordingIconTint | UIColor | Sets the voice recorder icon tint color. | | aiIconTint | UIColor | Sets the ai icon tint color. | | infoTextColor | UIColor | Sets the text color for info message displayed (now part of style). | | infoIconTintColor | UIColor | Sets the tint color for info icon. | | infoBackgroundColor | UIColor | Sets the background color for info message view (now part of style). | | infoSeparatorColor | UIColor | Sets the separator color for info view (now part of style). | | set(background:) | UIColor | Sets background color for message composer. | | set(placeholderText:) | String | Sets message composer's placeholder text. | | set(maxLines:) | Int | Sets limit for lines of text to be displayed in input field. | | set(auxiliaryButtonAlignment:) | AuxiliaryButtonAlignment | Sets position for auxiliary buttons view. | | set(customSoundForMessage:) | URL | Sets custom sounds for outgoing messages. | | set(liveReactionIconURL:) | UIImage | Sets custom live reaction icon. | | set(disableMentions:) | Bool | Enables/Disables user mentions in message composer input field. | | set(infoIcon:) | UIImage | Sets image for info icon (now part of style). | | set(attachmentIcon:) | UIImage | Sets image for attachment button on message composer. | | set(aiAuxiliaryIcon:) | UIImage | Sets image for ai auxillary button. | | setOnSendButtonClick | Closure | Sets custom actions for send button click. | | hide(liveReaction:) | Bool | Toggles visibility for live reaction component. | | hide(footerView:) | Bool | Toggles visibility for footer view of message composer. | | hide(headerView:) | Bool | Toggles visibility for header view of message composer. | | hide(sendButton:) | Bool | Toggles visibility for send button. | | setAttachmentOptions | Closure | Sets a list of custom MessageComposerActions. | | setAuxilaryButtonView | Closure | Sets custom auxiliary button view. | | setSecondaryButtonView | Closure | Sets custom secondary button view. | | setSendButtonView | Closure | Sets custom send button view. | ## Call Logs ### New Properties | Name | Type | Description | | --------------------------- | ------------------------------- | ---------------------------------------------------- | | listItemTitleTextColor | UIColor | Text color for the list item title. | | listItemTitleFont | UIFont | Font for the list item title. | | listItemSubTitleTextColor | UIColor | Text color for the list item subtitle. | | listItemSubTitleFont | UIFont | Font for the list item subtitle. | | listItemBackground | UIColor | Background color for the list item. | | listItemSelectedBackground | UIColor | Background color for the selected list item. | | listItemBorderWidth | CGFloat | Border width for the list item. | | listItemBorderColor | UIColor | Border color for the list item. | | listItemCornerRadius | CometChatCornerStyle | Corner radius for the list item. | | listItemSelectionImageTint | UIColor | Tint color for the selection image. | | listItemDeSelectedImageTint | UIColor | Tint color for the deselected image. | | listItemSelectedImage | UIImage | Image for the selected list item. | | listItemDeSelectedImage | UIImage | Image for the deselected list item. | | backgroundColor | UIColor | Background color. | | borderWidth | CGFloat | Border width. | | borderColor | UIColor | Border color. | | cornerRadius | CometChatCornerStyle | Corner radius. | | titleColor | UIColor | Text color for the title. | | titleFont | UIFont | Font for the title. | | largeTitleColor | UIColor | Text color for large titles. | | largeTitleFont | UIFont | Font for large titles. | | navigationBarTintColor | UIColor | Background color for the navigation bar. | | navigationBarItemsTintColor | UIColor | Tint color for navigation bar items. | | errorTitleTextFont | UIFont | Font for the error title. | | errorTitleTextColor | UIColor | Text color for the error title. | | errorSubTitleFont | UIFont | Font for the error subtitle. | | errorSubTitleTextColor | UIColor | Text color for the error subtitle. | | retryButtonTextColor | UIColor | Text color for the retry button. | | retryButtonTextFont | UIFont | Font for the retry button text. | | retryButtonBackgroundColor | UIColor | Background color for the retry button. | | retryButtonBorderColor | UIColor | Border color for the retry button. | | retryButtonBorderWidth | CGFloat | Border width for the retry button. | | retryButtonCornerRadius | CometChatCornerStyle | Corner radius for the retry button. | | emptyTitleTextFont | UIFont | Font for the empty state title. | | emptyTitleTextColor | UIColor | Text color for the empty state title. | | emptySubTitleFont | UIFont | Font for the empty state subtitle. | | emptySubTitleTextColor | UIColor | Text color for the empty state subtitle. | | tableViewSeparator | UIColor | Color for the table view separator. | | backIcon | UIImage | Icon for the back button. | | backIconTint | UIColor | Tint color for the back icon. | | incomingCallIcon | UIImage | Icon for incoming calls. | | incomingCallIconTint | UIColor | Tint color for the incoming call icon. | | outgoingCallIcon | UIImage | Icon for outgoing calls. | | outgoingCallIconTint | UIColor | Tint color for the outgoing call icon. | | missedCallTitleColor | UIColor | Text color for missed call titles. | | missedCallIcon | UIImage | Icon for missed calls. | | missedCallIconTint | UIColor | Tint color for the missed call icon. | | audioCallIcon | UIImage | Icon for audio calls. | | audioCallIconTint | UIColor | Tint color for the audio call icon. | | videoCallIcon | UIImage | Icon for video calls. | | videoCallIconTint | UIColor | Tint color for the video call icon. | | separatorColor | UIColor | Color for separators. | | set(callRequestBuilder:) | CallLogsRequest.CallLogsBuilder | Sets the CallLogsBuilder instance for call logs. | | hideError | Bool | Hides the error state view. | | hideNavigationBar | Bool | Hides the navigation bar. | | hideLoadingState | Bool | Hides the loading state view. | | hideBackIcon | Bool | Hides the back icon in the navigation bar. | | set(onItemClick:) | (CallLog, IndexPath) -> Void | Triggered when you click on a ListItem. | | set(onItemLongClick:) | (CallLog, IndexPath) -> Void | Triggered when you long press on a ListItem. | | set(onBack:) | () -> Void | Triggered when back button is pressed. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(onEmpty:) | () -> Void | Triggers when the call logs list is empty. | | set(onLoad:) | (\[CallLog]) -> Void | Triggers when call logs are successfully loaded. | | set(listItemView:) | (CallLog) -> UIView | Assigns a custom ListItem to the CallLogs component. | | set(titleView:) | (CallLog) -> UIView | Sets a custom title view for call log cells. | | set(leadingView:) | (CallLog) -> UIView | Sets a custom leading view for call log cells. | | set(subtitleView:) | (CallLog) -> UIView | Sets a custom subtitle view for call log cells. | | set(trailView:) | (CallLog) -> UIView | Sets a custom trailing view for call log cells. | | set(emptyView:) | UIView | Sets a custom empty state view. | | set(errorView:) | UIView | Sets a custom error view. | | set(menus:) | \[UIBarButtonItem] | Sets custom menus to add more options. | | avatarStyle | AvatarStyle | Customizes the appearance of avatars. | ### Renamed Properties | Name | Type | Description | Old Name | | ----------------- | ---------------------------- | --------------------------------------- | -------------- | | set(onItemClick:) | (CallLog, IndexPath) -> Void | Triggered when you click on a ListItem. | setOnItemClick | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | set(onError:) | ### Removed Properties | Name | Type | Description | | ---------------------- | ---------------------------------------------- | --------------------------------------------------- | | backButtonFont | UIFont | Sets the font for the back button. | | backButtonIcon | UIImage | Sets the icon for the back button. | | backButtonTint | UIColor | Sets the tint for the back button. | | backButtonTitle | String? | Sets the title for the back button. | | backButtonTitleColor | UIColor | Sets the title color for the back button. | | background | \[CGColor]? | Sets the background. | | corner | CometChatCornerStyle | Sets the corner style. | | emptyStateText | String | Sets the text for empty state. | | emptyStateTextFont | UIFont | Sets the font for empty state text. | | errorStateText | String | Sets the text for error state. | | errorStateTextColor | UIColor | Sets the text color for error state. | | errorStateTextFont | UIFont | Sets the font for error state text. | | searchBackground | UIColor | Sets the background for the search bar. | | searchBarHeight | CGFloat | Sets the height for the search bar. | | searchBorderColor | UIColor | Sets the border color for the search bar. | | searchCancelButtonFont | UIFont | Sets the font for the search cancel button. | | searchCancelButtonTint | UIColor | Sets the tint for the search cancel button. | | searchClearIcon | UIImage | Sets the icon for the search clear button. | | searchCornerRadius | CometChatCornerStyle | Sets the corner radius for the search bar. | | searchIcon | UIImage? | Sets the icon for the search bar. | | searchPlaceholder | String | Sets the placeholder for the search bar. | | searchTextColor | UIColor | Sets the color for the search text. | | searchTextFont | UIFont | Sets the font for the search text. | | set(title:mode:) | String, UINavigationItem.LargeTitleDisplayMode | Sets the title for the title bar. | | titleColor | UIColor | Sets the color for the title (now part of style). | | titleFont | UIFont | Sets the font for the title (now part of style). | | hide(errorText:) | Bool | Hides the error text. | | hide(search:) | Bool | Hides the search bar. | | hide(separator:) | Bool | Hides the separator. | | callStatusTextFont | UIFont | Sets the call status font. | | missedCallTitleTint | UIColor | Sets the missed call color. | | callTimeTextFont | UIFont | Sets the call time font. | | dateSeparatorTextFont | UIFont | Sets the date separator font. | | emptyStateTextFont | UIFont | Sets the empty state font (now emptyTitleTextFont). | | errorStateTextFont | UIFont | Sets the error state font (now errorTitleTextFont). | | callStatusTextColor | UIColor | Sets the call status color. | | callStatusIconTint | UIColor | Sets the call status icon tint. | | callTimeTextColor | UIColor | Sets the call time color. | | dateSeparatorTextColor | UIColor | Sets the date separator color. | | infoIconTint | UIColor | Sets the info icon tint. | | listItemStyle | ListItemStyle | Styles to apply to each call log item. | ## Call Buttons ### New Properties | Name | Type | Description | | ------------------------------- | --------------------------------------- | -------------------------------------------------------------------- | | videoCallIconTint | UIColor | Tint color for the video call icon. | | videoCallTextFont | UIFont | Font for the video call button text. | | videoCallTextColor | UIColor | Color for the video call button text. | | videoCallButtonBackground | UIColor | Background color for the video call button. | | videoCallButtonCornerRadius | CometChatCornerStyle | Corner radius for the video call button. | | videoCallButtonBorder | CGFloat | Border width for the video call button. | | videoCallButtonBorderColor | UIColor | Border color for the video call button. | | videoCallIcon | UIImage | Icon for the video call button. | | audioCallIconTint | UIColor | Tint color for the audio call icon. | | audioCallTextFont | UIFont | Font for the audio call button text. | | audioCallTextColor | UIColor | Color for the audio call button text. | | audioCallButtonBackground | UIColor | Background color for the audio call button. | | audioCallButtonCornerRadius | CometChatCornerStyle | Corner radius for the audio call button. | | audioCallButtonBorder | CGFloat | Border width for the audio call button. | | audioCallButtonBorderColor | UIColor | Border color for the audio call button. | | audioCallIcon | UIImage | Icon for the audio call button. | | hideVideoCallButton | Bool | Hides the video call button. | | hideVoiceCallButton | Bool | Hides the voice call button. | | set(user:) | User | Sets the User object for CometChatCallButtons. | | set(group:) | Group | Sets the Group object for CometChatCallButtons. | | set(outgoingCallConfiguration:) | OutgoingCallConfiguration | Sets the configuration for outgoing calls. | | set(customSoundForCalls:) | URL | Sets a custom sound for incoming and outgoing calls. | | set(callSettingBuilder:) | (CallType, \[CallUser]) -> CallSettings | Function to build call settings based on call type and participants. | | set(onVoiceCallClick:) | (User?, Group?) -> Void | Override the action triggered upon pressing the voice call button. | | set(onVideoCallClick:) | (User?, Group?) -> Void | Override the action triggered upon pressing the video call button. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(controller:) | UIViewController | Sets the controller (mandatory for proper configuration). | | style | CallButtonStyle | Customizes the appearance of the CallButtons component. | ### Renamed Properties | Name | Type | Description | Old Name | | ---------------------- | ---------------------------- | ------------------------------------------------------------------ | ------------------- | | hideVideoCallButton | Bool | Hides the video call button. | hide(videoCall:) | | hideVoiceCallButton | Bool | Hides the voice call button. | hide(voiceCall:) | | set(onVoiceCallClick:) | (User?, Group?) -> Void | Override the action triggered upon pressing the voice call button. | setOnVoiceCallClick | | set(onVideoCallClick:) | (User?, Group?) -> Void | Override the action triggered upon pressing the video call button. | setOnVideoCallClick | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | setOnError | ### Removed Properties | Name | Type | Description | | ----------------------- | -------------------- | ------------------------------------------------------------ | | set(background:) | UIColor | Sets the background color. | | set(textFont:) | UIFont | Sets the font of the text. | | set(textColor:) | UIColor | Sets the color of the text. | | set(cornerRadius:) | CometChatCornerStyle | Sets the corner radius. | | set(borderColor:) | UIColor | Sets the color of the border. | | set(borderWidth:) | CGFloat | Sets the width of the border. | | set(iconBackground:) | UIColor | Sets the background of the icon. | | set(iconBorder:) | CGFloat | Sets the border of the icon. | | set(iconCornerRadius:) | CGFloat | Sets the corner radius of the icon. | | set(iconTint:) | UIColor | Sets the tint of the icon. | | set(callButtonsStyle:) | ButtonStyle | Sets the button style for call buttons. | | set(isCenterAligned:) | Bool | Sets the alignment of the buttons. | | set(videoCallIcon:) | UIImage | Sets the icon for the video call button (now part of style). | | set(videoCallIconText:) | String | Sets the text for the video call button. | | set(voiceCallIcon:) | UIImage | Sets the icon for the voice call button (now part of style). | | set(voiceCallIconText:) | String | Sets the text for the voice call button. | ## Incoming Call ### New Properties | Name | Type | Description | | --------------------------- | --------------------------------- | -------------------------------------------------------------- | | overlayBackgroundColor | UIColor | Background color for the overlay. | | acceptButtonBackgroundColor | UIColor | Background color for the accept button. | | rejectButtonBackgroundColor | UIColor | Background color for the reject button. | | acceptButtonTintColor | UIColor | Tint color for the accept button. | | rejectButtonTintColor | UIColor | Tint color for the reject button. | | acceptButtonImage | UIImage | Icon image for the accept button. | | rejectButtonImage | UIImage | Icon image for the reject button. | | acceptButtonCornerRadius | CometChatCornerStyle | Sets corner radius for accept button. | | rejectButtonCornerRadius | CometChatCornerStyle | Sets corner radius for reject button. | | acceptButtonBorderWidth | CGFloat | Sets border width for accept button. | | rejectButtonBorderWidth | CGFloat | Sets border width for reject button. | | acceptButtonBorderColor | UIColor | Sets border color for accept button. | | rejectButtonBorderColor | UIColor | Sets border color for reject button. | | backgroundColor | UIColor | Background color for the call view. | | cornerRadius | CometChatCornerStyle | Corner radius for the view. | | borderColor | UIColor | Border color for the view. | | borderWidth | CGFloat | Border width for the view. | | callLabelColor | UIColor | Text color for the call label. | | callLabelFont | UIFont | Font for the call label. | | nameLabelColor | UIColor | Text color for the name label. | | nameLabelFont | UIFont | Font for the name label. | | disableSoundForCalls | Bool | Disables sound for incoming calls. | | set(customSoundForCalls:) | URL | Sets a custom sound for incoming calls. | | set(call:) | Call | Sets the call object for the incoming call. | | set(onAcceptClick:) | (Call, UIViewController?) -> Void | Override the action triggered upon pressing the accept button. | | set(onCancelClick:) | (Call, UIViewController?) -> Void | Override the action triggered upon pressing the reject button. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(listItemView:) | (Call) -> UIView | Assigns a custom view to the incoming call item view. | | set(leadingView:) | (Call) -> UIView | Sets a custom leading view for incoming call. | | set(titleView:) | (Call) -> UIView | Sets a custom title view for incoming call. | | style | IncomingCallStyle | Customizes the appearance of the IncomingCall component. | | avatarStyle | AvatarStyle | Customizes the appearance of avatars. | ### Renamed Properties | Name | Type | Description | Old Name | | ------------------- | --------------------------------- | -------------------------------------------------------------- | ---------------- | | set(onAcceptClick:) | (Call, UIViewController?) -> Void | Override the action triggered upon pressing the accept button. | setOnAcceptClick | | set(onCancelClick:) | (Call, UIViewController?) -> Void | Override the action triggered upon pressing the reject button. | setOnCancelClick | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | setOnError | ### Removed Properties | Name | Type | Description | | ----------------------- | -------------------- | --------------------------------------------------------- | | set(background:) | UIColor | Sets the background color for IncomingCall. | | set(cornerRadius:) | CometChatCornerStyle | Sets the corner radius for IncomingCall. | | set(borderWidth:) | CGFloat | Sets the border width for IncomingCall. | | set(borderColor:) | UIColor | Sets the border color for IncomingCall. | | set(titleColor:) | UIColor | Sets the title color for IncomingCall. | | set(titleFont:) | UIFont | Sets the title font for IncomingCall. | | set(subtitleColor:) | UIColor | Sets the subtitle color for IncomingCall. | | set(subtitleFont:) | UIFont | Sets the subtitle font for IncomingCall. | | set(incomingCallStyle:) | IncomingCallStyle | Sets the incoming call style. | | set(avatarStyle:) | AvatarStyle | Sets the avatar style. | | set(user:) | User | Sets the user object for the incoming call. | | set(acceptButtonIcon:) | UIImage | Sets the icon for the accept button (now part of style). | | set(declineButtonIcon:) | UIImage | Sets the icon for the decline button (now part of style). | ## Outgoing Call ### New Properties | Name | Type | Description | | ---------------------------- | --------------------------------- | --------------------------------------------------------------------------- | | backgroundColor | UIColor | Sets the background color for the outgoing call view. | | borderColor | UIColor | Sets the border color for the outgoing call view. | | borderWidth | CGFloat | Sets the border width for the outgoing call view. | | cornerRadius | CometChatCornerStyle | Sets the corner radius for the outgoing call view. | | nameTextColor | UIColor | Sets the text color for the name label in the outgoing call view. | | nameTextFont | UIFont | Sets the font for the name label in the outgoing call view. | | callTextColor | UIColor | Sets the text color for the call label in the outgoing call view. | | callTextFont | UIFont | Sets the font for the call label in the outgoing call view. | | declineButtonBackgroundColor | UIColor | Sets the background color for the decline button in the outgoing call view. | | declineButtonIconTint | UIColor | Sets the tint color for the decline button icon. | | declineButtonIcon | UIImage | Sets the icon for the decline button. | | declineButtonCornerRadius | CometChatCornerStyle | Sets the corner radius for decline button. | | declineButtonBorderColor | UIColor | Sets the border color for decline button. | | declineButtonBorderWidth | CGFloat | Sets the border width for decline button. | | nameLabel | UIFont | Sets the font for the name label. | | callingLabel | UIFont | Sets the font for the call label. | | disableSoundForCalls | Bool | Disables sound for outgoing calls. | | set(customSoundForCalls:) | URL | Sets a custom sound for outgoing calls. | | set(call:) | Call | Sets the Call object for CometChatOutgoingCall. | | set(onCancelClick:) | (Call, UIViewController?) -> Void | Override the action triggered upon pressing the cancel button. | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | | set(avatarView:) | (Call) -> UIView | Sets a custom avatar view for outgoing call. | | set(cancelView:) | (Call) -> UIView | Sets a custom cancel button view for outgoing call. | | set(titleView:) | (Call) -> UIView | Sets a custom title view for outgoing call. | | set(subtitleView:) | (Call) -> UIView | Sets a custom subtitle view for outgoing call. | | style | OutgoingCallStyle | Customizes the appearance of the OutgoingCall component. | | avatarStyle | AvatarStyle | Customizes the appearance of avatars. | ### Renamed Properties | Name | Type | Description | Old Name | | ------------------- | --------------------------------- | -------------------------------------------------------------- | ---------------- | | set(onCancelClick:) | (Call, UIViewController?) -> Void | Override the action triggered upon pressing the cancel button. | setOnCancelClick | | set(onError:) | (CometChatException) -> Void | Triggered when an error occurs. | setOnError | ### Removed Properties | Name | Type | Description | | ----------------------- | -------------------- | --------------------------------------------------------- | | set(background:) | UIColor | Sets the background color. | | set(cornerRadius:) | CometChatCornerStyle | Sets the corner radius. | | set(borderWidth:) | CGFloat | Sets the border width. | | set(borderColor:) | UIColor | Sets the border color. | | set(titleColor:) | UIColor | Sets the title color. | | set(titleFont:) | UIFont | Sets the title font. | | set(subtitleColor:) | UIColor | Sets the subtitle color. | | set(subtitleFont:) | UIFont | Sets the subtitle font. | | set(outgoingCallStyle:) | OutgoingCallStyle | Sets the outgoing call style. | | set(avatarStyle:) | AvatarStyle | Sets the avatar style. | | set(buttonStyle:) | ButtonStyle | Sets the button style for outgoing call. | | disable(soundForCalls:) | Bool | Disables the default sound for calls. | | set(declineButtonIcon:) | UIImage | Sets the icon for the decline button (now part of style). | | set(user:) | User | Sets the User object for CometChatOutgoingCall. | ***