> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-angular-v5-docs-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Call Log Participants

> Call Log Participants — CometChat documentation.

## Overview

`CometChatCallLogParticipants` is a [Widget](/ui-kit/flutter/v4/components-overview#components) that shows a separate widget that displays comprehensive information about Call. This will enable users to easily access details such as the call participants, and call details for a more informed communication experience.

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/pnzgsGg7Vjogofic/images/89be1fe0-call_logs_participant_overview_cometchat_screens-13968b681081c9bfb8713edc3068b645.png?fit=max&auto=format&n=pnzgsGg7Vjogofic&q=85&s=fe518eb3294cb8cdd100080be1ec5995" alt="Image" width="4498" height="3121" data-path="images/89be1fe0-call_logs_participant_overview_cometchat_screens-13968b681081c9bfb8713edc3068b645.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/6IESCr-kzBV6qAKP/images/812be0e7-call_logs_participant_overview_cometchat_screens-23bf70d75778736b79c1ba8ba51d9fa4.png?fit=max&auto=format&n=6IESCr-kzBV6qAKP&q=85&s=ee83323df80aca388a265a66104259e0" alt="Image" width="4498" height="3121" data-path="images/812be0e7-call_logs_participant_overview_cometchat_screens-23bf70d75778736b79c1ba8ba51d9fa4.png" />
  </Tab>
</Tabs>

The `CometChatCallLogParticipants` widget is composed of the following BaseWidgets:

| Widgets                                           | Description                                                                                                                                                                             |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [CometChatListBase](/ui-kit/flutter/v4/list-base) | `CometChatListBase` is a container widget featuring a title, customizable background options, and a dedicated list widget for seamless integration within your application's interface. |
| [CometChatListItem](/ui-kit/flutter/v4/list-item) | This widget displays data retrieved from a CallLog object on a card, presenting a title and subtitle.                                                                                   |

***

## Usage

### Integration

`CometChatCallLogParticipants` is a widget that seamlessly integrates into your application. To present the participants of a call, you can instantiate the `CometChatCallLogParticipants` instance and provide the list of participants using its setter function. This allows for easy customization and efficient display of call participant details within your application's interface.

You can launch `CometChatCallLogParticipants` directly using `Navigator.push`, or you can define it as a widget within the `build` method of your `State` class.

##### 1. Using Navigator to Launch `CometChatCallLogParticipants`

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    Navigator.push(context, MaterialPageRoute(builder: (context) => CometChatCallLogParticipants(callLog: callLogObject))); // CallLog object is required to launch the CometChatCallLogParticipants widget.
    ```
  </Tab>
</Tabs>

##### 2. Embedding `CometChatCallLogParticipants` as a Widget in the build Method

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    import 'package:cometchat_calls_uikit/cometchat_calls_uikit.dart';
    import 'package:flutter/material.dart';

    class CallLogParticipantExample extends StatefulWidget {
      const CallLogParticipantExample({super.key});

      @override
      State<CallLogParticipantExample> createState() => _CallLogParticipantExampleState();
    }

    class _CallLogParticipantExampleState extends State<CallLogParticipantExample> {
      @override
      Widget build(BuildContext context) {
        return Scaffold(
          body: SafeArea(
            child: CometChatCallLogParticipants(
              callLog: callLogObject,
            ) // CallLog object is required to launch the CometChatCallLogDetails widget.
          ),
        );
      }
    }
    ```
  </Tab>
</Tabs>

***

### Actions

[Actions](/ui-kit/flutter/v4/components-overview#actions) dictate how a widget functions. They are divided into two types: Predefined and User-defined. You can override either type, allowing you to tailor the behavior of the widget to fit your specific needs.

##### 1. onBack

You can customize this behavior by using the provided code snippet to override the `onBack` and improve error handling.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      onBack: () {
        // TODO("Not yet implemented")
      },
    )
    ```
  </Tab>
</Tabs>

***

##### 2. onError

You can customize this behavior by using the provided code snippet to override the `onError` and improve error handling.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      onError: (e) {
        // TODO("Not yet implemented")
      },
    )
    ```
  </Tab>
</Tabs>

***

### Filters

**Filters** allow you to customize the data displayed in a list within a Widget. You can filter the list based on your specific criteria, allowing for a more customized. Filters can be applied using RequestBuilders of Chat SDK.

The `CometChatCallLogParticipants` widget does not have any exposed filters.

***

### Events

[Events](/ui-kit/flutter/v4/components-overview#events) are emitted by a `Widget`. By using event you can extend existing functionality. Being global events, they can be applied in Multiple Locations and are capable of being Added or Removed.

The `CometChatCallLogParticipants` widget does not have any exposed events.

***

## Customization

To fit your app's design requirements, you can customize the appearance of the conversation widget. We provide exposed methods that allow you to modify the experience and behavior according to your specific needs.

### Style

Using Style you can customize the look and feel of the widget in your app, These parameters typically control elements such as the color, size, shape, and fonts used within the widget.

##### 1. CallLogParticipants Style

You can customize the appearance of the `CallLogParticipantsStyle` Widget by applying the `CallLogParticipantsStyle` to it using the following code snippet.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      participantsStyle: CallLogParticipantsStyle(
        background: Color(0xFFE4EBF5),
        titleStyle: const TextStyle(color: Colors.red, fontFamily: "PlaywritePL"),
        borderRadius: 10,
        border: Border.all(color: Colors.red, width: 2),
      ),
    )
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/1qVYwIk_qVVitr23/images/f62b373e-call_logs_participant_style_cometchat_screens-aeb95600780c303b91a235fba36ac317.png?fit=max&auto=format&n=1qVYwIk_qVVitr23&q=85&s=ca464a1450403276096242e0486014be" alt="Image" width="4498" height="3121" data-path="images/f62b373e-call_logs_participant_style_cometchat_screens-aeb95600780c303b91a235fba36ac317.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/1qVYwIk_qVVitr23/images/f3c3b497-call_logs_participant_style_cometchat_screens-1a1d1b4af715755016cb8bdf60978e26.png?fit=max&auto=format&n=1qVYwIk_qVVitr23&q=85&s=6558cb670558c86207c58e9ad013fc1f" alt="Image" width="4498" height="3121" data-path="images/f3c3b497-call_logs_participant_style_cometchat_screens-1a1d1b4af715755016cb8bdf60978e26.png" />
  </Tab>
</Tabs>

List of properties exposed by `CallLogParticipantsStyle`

| **Property**       | **Description**                                          | **Code**                    |
| ------------------ | -------------------------------------------------------- | --------------------------- |
| **width**          | The width of the call log participants style.            | `double? width`             |
| **height**         | The height of the call log participants style.           | `double? height`            |
| **background**     | The background color of the call log participants style. | `Color? background`         |
| **border**         | The border of the call log participants style.           | `BoxBorder? border`         |
| **borderRadius**   | The border radius of the call log participants style.    | `double? borderRadius`      |
| **gradient**       | The gradient of the call log participants style.         | `Gradient? gradient`        |
| **titleStyle**     | The text style for the title.                            | `TextStyle? titleStyle`     |
| **subTitleStyle**  | The text style for the subtitle.                         | `TextStyle? subTitleStyle`  |
| **emptyTextStyle** | The text style for the empty state.                      | `TextStyle? emptyTextStyle` |
| **backIconTint**   | The tint color for the back icon.                        | `Color? backIconTint`       |
| **tailTitleStyle** | The text style for the tail title.                       | `TextStyle? tailTitleStyle` |
| **nameTextStyle**  | The text style for the name.                             | `TextStyle? nameTextStyle`  |

***

##### 2. Avatar Style

To apply customized styles to the `Avatar` widget in the `CometChatCallLogParticipants` Widget, you can use the following code snippet. For more information, visit [Avatar Styles](/ui-kit/flutter/v4/avatar).

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      avatarStyle: AvatarStyle(
        background: Color(0xFFE4EBF5),
        borderRadius: 10,
        border: Border.all(color: Colors.red, width: 2),
      ),
    )
    ```
  </Tab>
</Tabs>

***

##### 3. ListItem Style

To apply customized styles to the List Item widget in the `CometChatCallLogParticipants` widget, You can use the following code snippet. For further insights on List Item Styles [refer](/ui-kit/flutter/v4/list-item)

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      listItemStyle: ListItemStyle(
          background: Color(0xFFE4EBF5),
          borderRadius: 20,
          border: Border.all(width: 2),
          margin: const EdgeInsets.only(top: 10),
          padding: const EdgeInsets.only(left: 10)
      ),
    )
    ```
  </Tab>
</Tabs>

***

### Functionality

These are a set of small functional customizations that allow you to fine-tune the overall experience of the widget. With these, you can change text, set custom icons, and toggle the visibility of UI elements.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      title: "Your Title",
      backButton: Image.asset(
        "assets/img/back.png",
        width: 30,
        height: 30,
      ),
      hideSeparator: false
    )
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/h7P8UchGUEpy8xCu/images/a4281ef5-call_logs_participant_functionality_cometchat_screens-1abb6483f753b6516ffed2f5c7d16e88.png?fit=max&auto=format&n=h7P8UchGUEpy8xCu&q=85&s=af31743a64f28da7b97e4b9b3e69191a" alt="Image" width="4498" height="3121" data-path="images/a4281ef5-call_logs_participant_functionality_cometchat_screens-1abb6483f753b6516ffed2f5c7d16e88.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/1qVYwIk_qVVitr23/images/f1f3e19b-call_logs_participant_functionality_cometchat_screens-77be05a737c987980761df0f08852194.png?fit=max&auto=format&n=1qVYwIk_qVVitr23&q=85&s=78f74c7a8fa1aa40e9341a0c08b89bc6" alt="Image" width="4498" height="3121" data-path="images/f1f3e19b-call_logs_participant_functionality_cometchat_screens-77be05a737c987980761df0f08852194.png" />
  </Tab>
</Tabs>

Below is a list of customizations along with corresponding code snippets

| **Property**       | **Description**                                  | **Code**                 |
| ------------------ | ------------------------------------------------ | ------------------------ |
| **title**          | The title of the call log participants.          | `String? title`          |
| **backButton**     | The custom back button widget.                   | `Widget? backButton`     |
| **showBackButton** | Whether to show the back button.                 | `bool? showBackButton`   |
| **emptyStateText** | The text to show when there are no participants. | `String? emptyStateText` |
| **theme**          | The theme of the call log participants.          | `Theme? theme`           |
| **datePattern**    | The pattern for formatting the date.             | `String? datePattern`    |
| **hideSeparator**  | Whether to hide the separator.                   | `bool hideSeparator`     |

***

### Advanced

For advanced-level customization, you can set custom widgets to the widget. This lets you tailor each aspect of the widget to fit your exact needs and application aesthetics. You can create and define your widgets, layouts, and UI elements and then incorporate those into the widget.

#### ListItemView

With this function, you can assign a custom ListItem widget to the `CometChatCallLogParticipants` Widget.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      listItemView: (Participants participants, BuildContext context) {
        return Container(
          margin: const EdgeInsets.all(10),
          padding: const EdgeInsets.all(10),
          decoration: BoxDecoration(
            border: Border.all(color: Color(0xFF6851D6), width: 1), // Example border color
            borderRadius: BorderRadius.circular(8.0),
            color: Color(0xFFEEEEEE)
          ),
          child: Row(
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              Text(participants.name!),
              const Spacer(),
              ClipOval(
                child: Image.network(
                  participants.avatar!,
                  width: 40.0,
                  height: 40.0,
                  fit: BoxFit.cover,
                  errorBuilder: (context, error, stackTrace) {
                    return const Icon(
                      Icons.person,
                      size: 40.0,
                    );
                  },
                ),
              ),
              const SizedBox(width: 20),
            ],
          ),
        );
      },
    )
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/gV-Quvnw2qfqWme9/images/2df919af-call_logs_participant_list_item_view_cometchat_screens-e04eaf13d0162e14f453d8991c716858.png?fit=max&auto=format&n=gV-Quvnw2qfqWme9&q=85&s=686f860f60348f54477f5d66d408c1d2" alt="Image" width="4498" height="3121" data-path="images/2df919af-call_logs_participant_list_item_view_cometchat_screens-e04eaf13d0162e14f453d8991c716858.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/1AfY8AvJMqtx4lQu/images/233c3a0d-call_logs_participant_list_item_view_cometchat_screens-aaf47dbf32c9264e0573952c56d71b9c.png?fit=max&auto=format&n=1AfY8AvJMqtx4lQu&q=85&s=e77af5a61baf40cf63425428213b689c" alt="Image" width="4498" height="3121" data-path="images/233c3a0d-call_logs_participant_list_item_view_cometchat_screens-aaf47dbf32c9264e0573952c56d71b9c.png" />
  </Tab>
</Tabs>

***

#### SubtitleView

You can customize the subtitle widget for each conversation item to meet your requirements

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      subTitleView: (BuildContext context, Participants participants) {
        return Row(
          children: [
            InkWell(
                onTap: () {
                  // TODO("Not yet implemented")
                },
                child: const Icon(Icons.call, color: Color(0xFF6851D6), size: 25)
            ),
            const SizedBox(width: 10),
            InkWell(
                onTap: () {
                  // TODO("Not yet implemented")
                },
                child: const Icon(Icons.video_call, color: Color(0xFF6851D6), size: 25)
            ),
          ],
        );
      },
    )
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/L37wiDyfxR82vJto/images/414e4fb8-call_logs_participant_subtitle_view_cometchat_screens-3e0ad0cfcf28e91686c889f270de45b3.png?fit=max&auto=format&n=L37wiDyfxR82vJto&q=85&s=6fa3fb3b6ef153078b66ed3b323aca37" alt="Image" width="4498" height="3121" data-path="images/414e4fb8-call_logs_participant_subtitle_view_cometchat_screens-3e0ad0cfcf28e91686c889f270de45b3.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/h7P8UchGUEpy8xCu/images/a856d8bd-call_logs_participant_subtitle_view_cometchat_screens-bc9415b8e1adda5c9c8f95eae99edc02.png?fit=max&auto=format&n=h7P8UchGUEpy8xCu&q=85&s=bc58c082775cf77e709e36ff8faa3bea" alt="Image" width="4498" height="3121" data-path="images/a856d8bd-call_logs_participant_subtitle_view_cometchat_screens-bc9415b8e1adda5c9c8f95eae99edc02.png" />
  </Tab>
</Tabs>

***

#### TailView

Used to generate a custom trailing widget for the `CometChatCallLogParticipants` widget. You can add a Tail widget using the following method.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      tailView: (BuildContext context, Participants participants) {
        return SizedBox(
          width: 100,
          child: Row(
            children: [
              InkWell(
                  onTap: () {
                    // TODO("Not yet implemented")
                  },
                  child: const Icon(Icons.call, color: Color(0xFF6851D6), size: 25)
              ),
              const SizedBox(width: 10),
              InkWell(
                  onTap: () {
                    // TODO("Not yet implemented")
                  },
                  child: const Icon(Icons.video_call, color: Color(0xFF6851D6), size: 25)
              ),
            ],
          ),
        );
      },
    )
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/I2zU4ualMOEgPSMU/images/c95fa17b-call_logs_participant_tail_view_cometchat_screens-c3100d52acb8ba82497c2b51290727f6.png?fit=max&auto=format&n=I2zU4ualMOEgPSMU&q=85&s=0c9e0b3bcd728b6117b02adba1dd13a0" alt="Image" width="4498" height="3121" data-path="images/c95fa17b-call_logs_participant_tail_view_cometchat_screens-c3100d52acb8ba82497c2b51290727f6.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/xHWe3as1OGB4Vmrv/images/9396c2d7-call_logs_participant_tail_view_cometchat_screens-85129a9c291dae1f633ceb17b1726c7a.png?fit=max&auto=format&n=xHWe3as1OGB4Vmrv&q=85&s=05feb8f74cf9574ae1440321b7069d2e" alt="Image" width="4498" height="3121" data-path="images/9396c2d7-call_logs_participant_tail_view_cometchat_screens-85129a9c291dae1f633ceb17b1726c7a.png" />
  </Tab>
</Tabs>

***

#### EmptyStateView

You can set a custom `EmptyStateView` using `emptyStateView` to match the empty UI of your app.

<Tabs>
  <Tab title="Dart">
    ```dart theme={null}
    CometChatCallLogParticipants(
      callLog: callLogObject,
      emptyStateView: (context) {
        return SizedBox(
          width: MediaQuery.of(context).size.width,
          child: const Center(
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.center,
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  Spacer(),
                  Icon(Icons.sms_failed_outlined, color: Colors.red, size: 100,),
                  SizedBox(height: 20,),
                  Text("Your Custom Message"),
                  Spacer(),
                ],
              )
          ),
        );
      },
    )
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Android">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/xXJ8R25bxTI-kBC4/images/0818f93c-call_logs_participant_empty_state_view_cometchat_screens-38b00f8bb4da5101664acd3390281221.png?fit=max&auto=format&n=xXJ8R25bxTI-kBC4&q=85&s=e6704da5cb6588f690dbe226ad571f1f" alt="Image" width="4498" height="3121" data-path="images/0818f93c-call_logs_participant_empty_state_view_cometchat_screens-38b00f8bb4da5101664acd3390281221.png" />
  </Tab>

  <Tab title="iOS">
    <img src="https://mintcdn.com/cometchat-22654f5b-docs-angular-v5-docs-update/1AfY8AvJMqtx4lQu/images/22668d59-call_logs_participant_empty_state_view_cometchat_screens-5ecb807b856c50c13e196623051a3bf5.png?fit=max&auto=format&n=1AfY8AvJMqtx4lQu&q=85&s=058e1a1f1d1017afc4b259d3c3c187ec" alt="Image" width="4498" height="3121" data-path="images/22668d59-call_logs_participant_empty_state_view_cometchat_screens-5ecb807b856c50c13e196623051a3bf5.png" />
  </Tab>
</Tabs>

***
