Typing indicator
Typing indicator is a feature that allows users to know visually if another user in the channel is typing a message. The indicator remains visible until the user sends the message or deletes the text completely. It will also disappear when the user stops typing for more than 10 seconds.
Types
We support two types of typing indicators: Text and Bubble.
Text
The text typing indicator can be used in the following places.
- In the channel list as shown in the left image. This is the listComponent of the
SBUGroupChannelListViewControllermodule. - In the channel as shown in the right image. This is the header component of the
SBUGroupChannelViewControllerclass.
Note : In order to use the typing indicator feature, you must first create a channel and enable the chat service. To learn how to allow users to chat in a channel, refer to Chat in a group channel.
Bubble
The bubble typing indicator can be used in the following place.
Note that the bubble typing indicator is not supported in the SBUGroupChannelListViewController module.
How to use in channel
You can enable text and bubble typing indicators in your channel by following the code below. By default, the .text type of typing indicator is turned on. However, you can also enable the .bubble type here, or use both types at the same time.
How to use in channel list
You can enable the text typing indicator in the channel list by following the code below. You need to set the feature's setter method to true in the SBUGroupChannelListViewController module. The bubble typing indicator is not supported in this module.
Customize the text typing indicator UI
The UI for text typing indicator can be customized through SBUStringSet. The SBUStringSet is a set of strings used to compose the screen. You need to modify the stringSet values in advance if you want to make changes to the screen.
Text strings for typing status can vary depending on the number of members typing in a channel:
- If one member is typing: “Member is typing...”
- If two members are simultaneously typing: “Member A and Member B are typing...”
- If more than two members are simultaneously typing: “Several people are typing...”
SBUStringSet
The following table lists customizable properties of SBUStringSet that can be modified to customize text typing indicator.
| Property name | Description |
|---|---|
Channel_Typing (typingMembers) | A text for a member’s typing status. |
Customize the bubble typing indicator UI
The UI for bubble typing indicator can be customized by registering your custom SBUTypingIndicatorMessageCell to the listComponent of the SBUGroupChannelViewController.
You can also customize the bubble view by overriding typingBubbleView of SBUTypingIndicatorMessageCell with your custom UIView.