List channel participants
A participant list is a complete list of users that are participants of an open channel. The participant list is created through
Channel participant list screen
A channel participant list screen is composed of three components: header, participant list, and participant list status.
The header component shows the default title of the channel participant list screen as
Participants. It also has a button on the left corner of the header. When the left button is tapped, the
finish() method of the activity is called to exit the current screen. The view of the header is created and customized in the
HeaderComponent of the
The participant list component shows a list of profile images and names of the channel operators. The view of the participant list is created and customized in the
ParticipantListComponent of the
ParticipantListModule. You can also customize each item in the list view using
Participant list status
The participant list status component shows the result of the data request for a channel participant list. The
StatusComponent exists in the
ParticipantListModule and lets the user know if the list is loading or if the list could not be called.
UIKit for Android provides both activity and fragment to create a channel participant list screen. You can choose which one to build your app with and you may solely use activity instead of fragment if you wish to. You can build a channel participant list screen through
ParticipantListActivity, which uses
UIKitFragmentFactory to create views.
Start an activity
You can start an activity by using
intent to move from one activity to
ParticipantListActivity as shown below:
Create a fragment
ParticipantListActivity allows you to create a basic
UIKitFragmentFactory has a set of methods that build each fragment, whereas the builder class provides APIs to customize the UI of the data and event handlers used in
ParticipantListFragment. To see all APIs of
ParticipantListFragment.Builder, refer to the API reference page.
Note: To use UIKit's fragments as a nested fragment, refer to the Android Developer Documentation's Nested Fragments.
In the list channel participants key function, you can customize
ParticipantListFragment to change different parts of the screen. The
ParticipantListFragment.Builder class allows you to create and customize the basic
ParticipantListFragment that UIKit provides but you can only change its own APIs, such as setting a layout. If you wish to customize the fragment beyond using the APIs provided in the builder, you must inherit new customization methods.
The following table shows the main classes used in
ParticipantListFragment to display and customize the channel participant list screen.
Depending on the UI or the feature you wish to customize in the fragment, you can change the classes mentioned in the table. To learn how to customize the fragment, follow the links to Customization listed below:
- Customize the layout of the view
- Customize style of the view
- Bind event handlers to the view
- Add new APIs to the fragment
- Update or change an item in a list
Note: The links to the above customization pages provide an example of how to customize classes related to
ChannelFragment. In order to make changes to the participant list, you must use the correct classes.