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
SBUGroupChannelListViewController
module. - In the channel as shown in the right image. This is the header component of the
SBUGroupChannelViewController
class.
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.