Message List for PubNub Chat Components for React

Fetches historical messages using the scrolling pagination pattern and subscribes to the current channel to stay up to date with new messages.

It also displays data in an interactive list, including user names, avatars, the time when a message was sent, and attachments (links, images) and allows to react to messages with emojis and to show those reactions immediately.

Component

This section shows the preview of a sample Message List component and its source code.

Loading...

Try it out

Test the component as Sue Flores (default user).

  1. Go either to the Message Input or Typing Indicator component and type in a message in the input field.

  2. Upon sending, the message will appear at the bottom of the messsge list.

Parameters

You can configure the component using these parameters:

ParameterTypeDefault valueDescription
fetchMessages?number0Set this option to a non-zero value to enable fetching messages from the History API. This feature uses the infinite scrolling pattern and takes a maximum value of 25.
enableReactions?booleanfalseOption to enable rendering reactions that were added to messages. Make sure to also set up reactionsPicker when this option is enabled.
welcomeMessages?false | MessageEnvelope | MessageEnvelope[]n/aOption to provide custom welcome messages to replace the default ones. Set to "false" to disable it.
reactionsPicker?ReactElement<EmojiPickerElementProps>n/aOption to enable message reactions. Pass it in the emoji picker component. For more details, refer to the Emoji Pickers section in the docs.
extraActionsRenderer?(message: MessageEnvelope) => JSX.Elementn/aOption to provide an extra actions renderer to add custom action buttons to each message.
messageRenderer?(props: MessageRendererProps) => JSX.Elementn/aOption to provide a custom message item renderer if themes and CSS variables aren't enough.
bubbleRenderer?(props: MessageRendererProps) => JSX.Elementn/aOption to provide a custom message bubble renderer if themes and CSS variables aren't enough.
fileRenderer?(file: FileAttachment) => JSX.Elementn/aOption to provide a custom file renderer to change how images and other files are shown.
filter?(message: MessageEnvelope) => booleann/aThis option only works when you use either messageRenderer or bubbleRenderer. It allows you to apply one of the custom renderers only to the messages selected by the filter.
onScroll?(event: UIEvent<HTMLElement>) => unknownn/aCallback run on a list scroll.